カタログAgent Skills 形式のリファレンス

Claude のスキルの仕組みを、フィールド単位で

スキルとは、作業内容が説明文と合致したときにエージェントが読み込む手順書のフォルダーです。このサイトでは形式そのものを扱います。SKILL.md に何が書けるのか、実際の制約は何か、読み込みがどう段階化されているのか、そして複数のスキルを入れたときに何が起きるのか。

SKILL.md リファレンス
6フロントマターのフィールド
14衝突と組み合わせ
4配布元
30スキル
01スキルとはスキルとは、目の前の作業が説明文と合致したときにエージェントが読み込む、文章で書かれた手順のフォルダーです。プラグインでもモデルでも連携機能でもありません。このページでは構成要素と、スキルが役立つか無視されるかを決める要因を説明します。02SKILL.md リファレンススキルとは、直下に SKILL.md を持つディレクトリです。このページでは、そのファイルに書ける内容を、事例からの推測ではなく仕様書から引用して一覧にします。手元のスキルを 1 行ずつ突き合わせて確認できます。03最初のスキルを書くスキルとは、SKILL.md を含むフォルダーです。このガイドでは実際に使えるスキルを最初から最後まで 1 つ作り、判断を誤りやすい箇所ごとに立ち止まります。前提は、手作業で何度か済ませたことのある作業があることだけです。04スキル生成ツールそのスキルが何をするのか、いつ使うべきかを入力すると、仕様の規則を満たす SKILL.md を組み立てます。説明文は仕様が求める形で自動的に構成されます。「いつ」の部分が欠けていることが、完成したスキルが一度も読み込まれない最大の原因だからです。処理はすべてブラウザー内で行われます。05説明文チェッカースキルが読み込まれるかどうかを決めるのは説明文です。このチェッカーは、仕様書の厳密な制約を name と description に適用し、さらに、エージェントが一致させられる説明文と無視される説明文を分ける発動のヒューリスティックを加えます。処理はすべてブラウザー内で完結します。06トラブルシューティングスキルは静かに失敗します。エラーもログも出ず、エージェントはただスキルが存在しないかのように動きます。このページでは、実際に観測できる症状から出発して原因まで戻ります。

衝突と組み合わせ

このカタログで特によく勧められるスキルのうち 2 つは、互いに衝突します。どの組が衝突し、どの組が互いの穴を埋めるのかを地図にしました。

衝突と組み合わせを見る

配布元

出典

このページの制約はすべて、記載日に読んだ公開仕様に基づきます。本番で特定のフィールドに依存する前に、必ず出典を確認してください。

Agent Skills specification