Claude Codeの新機能「スキル(Agent Skills)」の入門記事です。毎回同じ指示を貼り付ける手間を、SKILL.mdという1ファイルにまとめることで解消できる仕組みを、公式ドキュメントと実機検証をもとに解説しています。
スキルは「SKILL.md」というMarkdownファイルを含むフォルダとして構成され、名前と説明(フロントマター)は常時読み込まれ、本文は使用時にのみ読み込まれます。記事では「release-notes」というスキルを例に、「.claude/skills/release-notes/」フォルダを作成し、フロントマターと本文を含むSKILL.mdを作成する手順を紹介。「claude plugin validate .claude/skills」というコマンドで構文検証もできます。
作成したスキルは「/release-notes」というコマンド、または自然言語での呼び出しで起動可能です。本文内で「!git log --oneline -20」のように記述すると、コマンド実行結果を動的に差し込めるほか、「allowed-tools」設定でツール使用を事前承認し確認プロンプトをスキップすることもできます。配置場所は個人用「~/.claude/skills/」とプロジェクト用「.claude/skills/」があり、個人用が優先されます。Anthropic、Vercel、Microsoft、Hugging Faceなどが公開スキル集を配布しており、プラグインまたはCLI経由で導入できます。
出典が伝えている要点
- スキルは「SKILL.md」という名前のMarkdownファイルを含むフォルダとして構成される
- スキルは名前と説明部分（フロントマター）が常時読み込まれ、本文は使用時にのみ読み込まれる仕組みになっている
- 記事ではrelease-notesという名前のスキルを作成する例を示している
- 手順の例として、まず「.claude/skills/release-notes/」というフォルダを作成する
- 次にフロントマターと本文を含むSKILL.mdファイルを作成する
- 「claude plugin validate .claude/skills」というコマンドで構文を検証できる
- 作成したスキルは「/release-notes」というコマンド、または自然言語での呼び出しで起動できる
- スキル本文内で「!
git log --oneline -20」のような記法を使うと、コマンド実行結果を本文に動的に差し込める - 「allowed-tools」という設定でツールの使用を事前承認し、確認プロンプトをスキップできる
- スキルの読み込みは「常時（フロントマター)」「起動時（本文）」「参照時（補助ファイル）」の3段階になっている
- スキルの配置場所には個人用「~/.claude/skills/」とプロジェクト用「.claude/skills/」があり、個人用の方が優先される
- Anthropic、Vercel、Microsoft、Hugging Faceなどが公開スキル集（公式リポジトリ）を公開しており、プラグインまたはCLI経由で導入できる