Skills（スキル）は、AI コーディングエージェントに「うちのやり方」を持たせる仕組みです。プロジェクト固有の流儀・繰り返し作業・社内ルールをファイルとして書いておくと、必要な場面でエージェントが自分でそれを読み込み、毎回説明しなくても同じ手順を再現します。本記事は Anthropic の Claude Skills を軸に、Cursor や GitHub Copilot など他ツールにも共通する考え方を、初学者向けに整理します。
What problem it solves
01「また同じ前置きを書いている」を消す
AI に作業を頼むたび、同じ注意書きを添えていないでしょうか。たとえば次のようなものです。
- 「コミットメッセージは英語で、Conventional Commits 形式（
feat:/fix:など）で」 - 「テストは Vitest で、
describe/itの階層で書いて」 - 「リファクタの前に、まず影響範囲を一覧化して」
こうした指示はチャットに毎回書いても、会話が終われば消えます。Skill としてファイルに残せば、エージェントは関連する作業のときに自動でその内容を参照します。同じことを教え直す手間が減り、人が変わっても・セッションが変わっても挙動が揃うのが利点です。
02Skill の正体は「フォルダ」
よくある誤解として「Skill ＝ Markdown ファイル 1 枚」と思われがちですが、Claude の Agent Skills では 1 つの Skill ＝ 1 つのフォルダです。フォルダの中心に SKILL.md を置き、必要なら補助ファイル（参照資料・スクリプト）を同梱します。
my-skill/
SKILL.md ← 本体（必須）
references/ ← 詳細な手順・仕様（任意）
forms.md
scripts/ ← 実行スクリプト（任意）
convert.py
SKILL.md の先頭には YAML フロントマターで name と description を必ず書きます。この 2 つはエージェントが起動時に読む「目次」にあたり、特に description が「いつこの Skill を使うか」を決める鍵になります（後述）。
--- name: e2e-test-writer description: Vitest + Playwright で E2E テストを書くときに使う。ファイル命名・describe 階層・データ後始末の規約を定義する。 --- # 命名 - 1 機能 1 ファイル / ファイル名: feature-name.e2e.ts # describe 階層 - 最上位: 機能名 / 第 2 階層: ユーザー操作シーケンス ...
03仕組みの肝：プログレッシブ・ディスクロージャ
「Skill をたくさん入れると、毎回全部読み込んでコンテキスト（AI が一度に扱える作業領域）を圧迫するのでは？」——ここを解決するのが 段階的開示（progressive disclosure）という設計です。Skill は 必要になった分だけ、3 段階で読み込まれます。
