手順ではなく、
仕事に名前を。
AIコーディングエージェントのための、再利用できるスキルです。エージェントが毎回手順を組み立て直す代わりに呼び出す、名前のついた手順なので、4つ目のステップが抜け落ちることはもうありません。
スキルなし
イベントを見つけ、サーバーを起動し、ペイロードをWebhookに送信しました。
Webhookに拒否されました。署名の検証に失敗しています。5ステップ中3
スキルあり
スキル:replay-stripe-webhook
- IDでイベントを取得
- ローカルの署名シークレットを読み込み
- Webhookを有効にしてサーバーを起動
- 新しい冪等キーで再送
- ハンドラーのログを確認
ハンドラーが200を返しました。5ステップ中5
同じ手順を、毎週。
- 1週目あなたからClaude Codeへ
「バージョンを上げて、両方のブランドをビルドして、アップロードしてから、タグを付けて。」
- 2週目あなたからCodexへ
「まずバージョンを上げる。それから両方のブランド。片方だけじゃなく。」
- 3週目あなたからClaude Codeへ
「アップロードの前にタグを付けたね。また。」
- 4週目あなたから、どのエージェントにも
::release-mobile
説明は3回スキルは1つそれ以来、抜けたステップは0
目安は複雑さではありません。同じ説明を繰り返しているかどうかです。3ステップを超えるもの、または順番が決まっているものはスキルにしましょう。それより小さければ、メモリで十分です。
決め手はdescription。
---name: replay-stripe-webhookdescription: 本番の決済イベントをローカルサーバーに対して再送する。---# Stripe Webhookを再送する1. IDでイベントを取得する2. ローカルの署名シークレットを読み込む3. 新しい冪等キーで再送する
- 「Stripeのヘルパー」stripe-helpers見送り
- 「本番の決済イベントをローカルサーバーに対して再送する」replay-stripe-webhook呼び出し
エージェントが一度も呼び出さないスキルは、たいていdescriptionに問題があります。テーマではなく、呼び出すきっかけを書きましょう。そうしないと、エージェント自身の計画が優先されます。
よくある質問
AIエージェントのスキルとは何ですか?
AIコーディングエージェントが手順を組み立て直す代わりに呼び出せる、名前つきの再利用できる手順です。StripeのWebhookをローカルで再送する、シードのフィクスチャを再生成する、リリース前のチェックリストを実行する、といったものです。本文は小さなMarkdownファイルで、そのフロントマターがスキルの名前と用途を示します。
メモリではなくスキルにすべきなのは、どんなときですか?
一連の流れで、順序が重要なときです。3ステップを超えるとき、またはどこかに「この順番で行う」という要件があるときは、スキルを使います。1、2行で済むものや、エージェントが実行せずに知っていればよい事実は、メモリです。
書いたスキルをエージェントが使ってくれないのはなぜですか?
いちばん多いのは、説明文にスキルの用途が書かれていないケースです。スキルは説明文で選ばれるため、あいまいな説明文はエージェント自身のデフォルトの計画に負けてしまいます。話題ではなく、きっかけを書いてください。ほかによくある原因は、スコープがその仕事が行われるパスに一致しないことと、手順の途中にまだ本当の判断が残っていることです。解説記事:Claude Codeのスキルが発動しない理由。
スキルはチームで共有できますか?
はい。それこそが、スキルをプロンプトの外に保存する意味です。スキルはワークスペース単位で、結合によってノードに紐づくため、1つのスキルが多くのパスで再利用され、チームメイト全員のエージェントがそれを呼び出せます。組織のメンバーシップとワークスペースへのアクセスは、サーバー側で強制されます。ロールと権限をご覧ください。
ほかの人が公開したスキルを使えますか?
はい。スキルは外部のGitHubのURLをソースとして指定でき、Pathruleが本文を取得してキャッシュします。キャッシュされたコピーは最後に提供したスナップショットで、上流の変更は次の更新時にワークスペースに取り込まれます。信頼できるエコシステムが公開しているスキルに使ってください。
スキルとPathruleのパターンの違いは何ですか?
スキルは1つの手順です。パターンは、1つのトピックのためのメモリ、ルール、スキルの小さなバンドルで、各要素はあらかじめ所属するパスにスコープされています。実際の規約が1つのファイルで済むことは、まずないからです。解説記事:Pathruleのパターンとは何か、そしてなぜスキルではないのか。
スキルがあれば、プロンプトは要らなくなりますか?
いいえ。スキルは、プロンプトから繰り返しを取り除くものです。同じ手順を説明し直している自分に気づいたら、スキルを書く価値があります。そうすればプロンプトでは仕事の名前を挙げるだけで済み、伝えるたびに手順がぶれることもなくなります。