結論
スキルとは、テキストとして保存された手続き的な知識です。いつ読み込まれるかを決める説明文と、特定の仕事の進め方を伝える本体から成ります。依頼が説明文と合致すると本体がエージェントの文脈に入り、進め方が変わります。合致しなければ何も起きません。本体より説明文が重要なのはそのためです。
スキル、MCP サーバー、連携機能の違い
スキルは手順を与えます。MCP サーバーは能力、つまり自社データベースや内部 API のように、そのままでは届かないシステムへのアクセスを与えます。連携機能は 2 つの製品をつなぎます。自分たちのやり方を知っていてほしいならスキル、新しいことをできるようにしたいならサーバーです。
発動しないスキルが生まれる理由
最も多い失敗は、作者の語彙で書かれた説明文です。「資料制作フロー」と説明されているスキルに対して、人が「プレゼン」と頼めば読み込まれません。説明文は、依頼する人が実際に使う言い方で、しかも自分が最初に思いつかなかった言い回しまで含めて書く必要があります。
スキルに入れるもの、入れないもの
手順、規約、制約、自社固有の事情を書き込みます。モデルがすでに知っている一般知識は入れないでください。文脈を奪うだけの水増しになります。良いスキルはたいてい、書き出し形式の実際の上限のように、誰かが何度も調べ直している地味な制約を捕まえたものです。
何本から多すぎるのか
説明文が重なり始めた時点で、スキルは予測できなくなります。どれが該当するかをエージェントが推測せざるを得なくなるからです。対処は追加ではなく削除と統合です。常に正しく発動する少数のほうが、予測できない大きなライブラリに勝ちます。
誰も触れないセキュリティの話
スキルの導入とは、自分の環境でコマンドを実行できるエージェントに、文章の指示を渡すことです。ディレクトリへの掲載は審査ではありません。導入するものは中身を読み、見知らぬ作者のスキルは見知らぬ作者のスクリプトと同じ扱いにしてください。