Skills とは
Skills は AI コーディングエージェントの「やり方」を自分専用に拡張する仕組み。プロジェクト固有の流儀・繰り返しタスク・社内ルールを Skill として登録すれば、AI が常にそれを守ってくれます。Claude Code、Codex、Cursor などで類似機能が提供されています（本記事では Claude Skills を中心に、共通の考え方を整理）。
Skill が解決する問題
AI に毎回同じ前置きを書いていませんか？
- 「コミットメッセージは英語で、Conventional Commits 形式で」
- 「テストは Vitest で、describe/it の階層で」
- 「リファクタの時は、まず影響範囲を一覧化して」
これらは Skill として永続化すれば、AI が次回以降は自動で守る。「教え直し疲れ」が消えます。
Skill の構造
Skill は基本的に Markdown ファイル 1 つで定義できます：
--- name: e2e-test-writer description: | Vitest + Playwright で E2E テストを書く時のスタイルガイド。 ファイル命名、describe 階層、データクリーンアップ。 --- # 命名 - 1 機能 1 ファイル - ファイル名: feature-name.e2e.ts # describe 階層 - 最上位: 機能名 - 第 2 階層: ユーザー操作シーケンス ...
