本文へスキップ
Pathrule

スキル

手順ではなく、
仕事に名前を。

AIコーディングエージェントのための、再利用できるスキルです。エージェントが毎回手順を組み立て直す代わりに呼び出す、名前のついた手順なので、4つ目のステップが抜け落ちることはもうありません。

Claude Code例
昨日失敗した決済をローカルで再現して。

スキルなし

イベントを見つけ、サーバーを起動し、ペイロードをWebhookに送信しました。

Webhookに拒否されました。署名の検証に失敗しています。5ステップ中3

スキルあり

スキル:replay-stripe-webhook

  • IDでイベントを取得
  • ローカルの署名シークレットを読み込み
  • Webhookを有効にしてサーバーを起動
  • 新しい冪等キーで再送
  • ハンドラーのログを確認

ハンドラーが200を返しました。5ステップ中5

同じ手順を、毎週。

  1. 1週目あなたからClaude Codeへ

    「バージョンを上げて、両方のブランドをビルドして、アップロードしてから、タグを付けて。」

  2. 2週目あなたからCodexへ

    「まずバージョンを上げる。それから両方のブランド。片方だけじゃなく。」

  3. 3週目あなたからClaude Codeへ

    「アップロードの前にタグを付けたね。また。」

  4. 4週目あなたから、どのエージェントにも

    ::release-mobile

説明は3回スキルは1つそれ以来、抜けたステップは0

目安は複雑さではありません。同じ説明を繰り返しているかどうかです。3ステップを超えるもの、または順番が決まっているものはスキルにしましょう。それより小さければ、メモリで十分です。

決め手はdescription。

SKILL.md
---name: replay-stripe-webhookdescription: 本番の決済イベントをローカルサーバーに対して再送する。---# Stripe Webhookを再送する1. IDでイベントを取得する2. ローカルの署名シークレットを読み込む3. 新しい冪等キーで再送する
プロンプト「昨日失敗した決済を再現して」
  • 「Stripeのヘルパー」stripe-helpers見送り
  • 「本番の決済イベントをローカルサーバーに対して再送する」replay-stripe-webhook呼び出し

エージェントが一度も呼び出さないスキルは、たいていdescriptionに問題があります。テーマではなく、呼び出すきっかけを書きましょう。そうしないと、エージェント自身の計画が優先されます。

スキルはひとつ。必要なすべてのパスへ。

replay-stripe-webhook

ワークスペース単位で一度だけ書き、作業が行われる場所ごとに紐づけます。コピーはしません。

  • /services/billing紐づけ済み
  • /services/webhooks紐づけ済み
  • /apps/admin/payments紐づけ済み
  • /apps/mobileここにはなし
届く先
  • Claude Code.claude/skills
  • Codex.agents/skills
  • Cursor、Copilot、Windsurfover MCP
manual
Pathruleで書いたもの
template
コピーして使うスターター
github_ref
取得して、キャッシュしたもの

来月加わるチームメイトも、存在を知らされないままスキルを使えます。古くなったスキルや矛盾するスキルは提案として表に出て、修正は人が承認します。

よくある質問

AIエージェントのスキルとは何ですか?

AIコーディングエージェントが手順を組み立て直す代わりに呼び出せる、名前つきの再利用できる手順です。StripeのWebhookをローカルで再送する、シードのフィクスチャを再生成する、リリース前のチェックリストを実行する、といったものです。本文は小さなMarkdownファイルで、そのフロントマターがスキルの名前と用途を示します。

メモリではなくスキルにすべきなのは、どんなときですか?

一連の流れで、順序が重要なときです。3ステップを超えるとき、またはどこかに「この順番で行う」という要件があるときは、スキルを使います。1、2行で済むものや、エージェントが実行せずに知っていればよい事実は、メモリです。

書いたスキルをエージェントが使ってくれないのはなぜですか?

いちばん多いのは、説明文にスキルの用途が書かれていないケースです。スキルは説明文で選ばれるため、あいまいな説明文はエージェント自身のデフォルトの計画に負けてしまいます。話題ではなく、きっかけを書いてください。ほかによくある原因は、スコープがその仕事が行われるパスに一致しないことと、手順の途中にまだ本当の判断が残っていることです。解説記事:Claude Codeのスキルが発動しない理由。

スキルはチームで共有できますか?

はい。それこそが、スキルをプロンプトの外に保存する意味です。スキルはワークスペース単位で、結合によってノードに紐づくため、1つのスキルが多くのパスで再利用され、チームメイト全員のエージェントがそれを呼び出せます。組織のメンバーシップとワークスペースへのアクセスは、サーバー側で強制されます。ロールと権限をご覧ください。

ほかの人が公開したスキルを使えますか?

はい。スキルは外部のGitHubのURLをソースとして指定でき、Pathruleが本文を取得してキャッシュします。キャッシュされたコピーは最後に提供したスナップショットで、上流の変更は次の更新時にワークスペースに取り込まれます。信頼できるエコシステムが公開しているスキルに使ってください。

スキルとPathruleのパターンの違いは何ですか?

スキルは1つの手順です。パターンは、1つのトピックのためのメモリ、ルール、スキルの小さなバンドルで、各要素はあらかじめ所属するパスにスコープされています。実際の規約が1つのファイルで済むことは、まずないからです。解説記事:Pathruleのパターンとは何か、そしてなぜスキルではないのか。

スキルがあれば、プロンプトは要らなくなりますか?

いいえ。スキルは、プロンプトから繰り返しを取り除くものです。同じ手順を説明し直している自分に気づいたら、スキルを書く価値があります。そうすればプロンプトでは仕事の名前を挙げるだけで済み、伝えるたびに手順がぶれることもなくなります。

手順は一度だけ書く。
あとは仕事の名前で呼ぶ。