ruby-skills Ruby向け

コードをパッケージするように、
Rubyの専門知識を
パッケージする。

RubyGemsはソフトウェアをパッケージ化します。Ruby Skillsは、チームの頭の中にあるエンジニアリング知識をパッケージ化します — バージョン管理され、インストール可能で、プロジェクトとコーディングエージェント間で共有できます。

gem install ruby-skills

近日公開 — GitHubで開発をフォロー

対象

Rubyエコシステムの
あらゆる層のための知識。

gemのメンテナンス、エンジニアリングチームのリード、オープンソースへの貢献 — Ruby Skillsは、知っていることを共有する手段です。

Gem作者

gemにはすでにコードが入っています。次は、ユーザーが従うべきパターン、規約、ベストプラクティスを同梱しましょう。スキルはgemと一緒にインストールされ、別途セットアップは不要です。

# ユーザーは自動でこれを受け取ります: skill "example/job-queues" # gem経由
エンジニアリングチーム

チームのRuby規約、アーキテクチャ上の判断、コード標準をプライベートスキルとしてエンコード。すべてのエンジニアとコーディングエージェントが、バージョン管理されロックされた同じプレイブックに従います。

# プライベートスキルの例: skill "example/team-conventions"
オープンソースコミュニティ

大切にしているRubyのパターン — 関数型、並行処理、パフォーマンス、テスト — のスキルを書く。公開レジストリに公開し、コミュニティが時間をかけて改善できるように。

# 公開スキルの例: skill "example/fp-patterns"
スキルの書き方 近日公開

スキルはMarkdown。
正しくパッケージする。

スキルは、パターン、規約、ヒューリスティックを記述したMarkdownファイルのディレクトリと、skill.toml マニフェストです。一度書いて、バージョン管理し、公開します。

  1. 1
    書く 規約をMarkdownで
  2. 2
    定義 メタデータを skill.toml に
  3. 3
    公開 公開またはプライベートレジストリへ
  4. 4
    他の人がインストール して専門知識の上に構築
name        = "example/job-queues"
version     = "0.1.0"
description = "ジョブキュー規約の例"
license     = "MIT"
authors     = ["@example"]

[dependencies]
ruby    = ">= 3.1"
## べき等性

すべてのジョブはべき等でなければならない。
ジョブランナーは失敗時にリトライします。

## キュー命名

重要な処理にデフォルトキューを
使わないこと。名前付きキューを定義:
  critical, default, low.

## リトライ上限

すべてのジョブクラスに
明示的なリトライ上限を。デフォルトの25は
本番では高すぎます。
核となる考え方

同じ発想を、
ひとつ上の層へ。

RubyGems
ソフトウェアをパッケージ化
Ruby Skills
エンジニアリング知識をパッケージ化
バージョン管理 Semver、lockfile、マシン間で再現可能
組み合わせ可能 gem、チーム、コミュニティのスキルを組み合わせる
公開可能 公開レジストリにプッシュするか、非公開のままにする
エージェント非依存 Claude、Codex、Cursor などに対応
Gem同梱可能 スキルは任意のRubyGemと一緒に配布できます
コミュニティ主導 検証済みパブリッシャーによるオープンなエコシステム

Rubyエコシステムは
共有知識の上に成り立つ。

その知識をインストール可能にしましょう。早期アクセスに参加して、Ruby Skillsの進化を形作ってください。