「Claude Codeは使っているけど、Skillsはよくわからないから全部CLAUDE.mdに書いてしまっている」――そんなエンジニアは意外と多いのではないだろうか。Qiitaユーザーのmiruky氏が公開した記事では、公式ドキュメントを徹底調査した上でClaude Code Skillsの実践テクニック10選がまとめられており、初心者から中級者まで使える知見が詰まっている。本記事ではその内容を深掘りしながら、Skillsを使いこなすための具体的な方法を解説する。
Skillsとは何か――CLAUDE.mdとの決定的な違い
CLAUDE.mdが「毎セッション自動で読み込まれるルールブック」だとすれば、Skillsは「必要なときだけ呼び出せる専門マニュアル」だ。この違いは非常に重要で、コンテキストウィンドウの節約にも直結する。大量のルールをCLAUDE.mdに詰め込むと、毎回全部読み込まれてしまい非効率になるが、Skillsなら必要なタスクのときだけ自動またはコマンドで呼び出せる。
Skillsの最小構成は以下のとおりシンプルだ。.claude/skills/ ディレクトリ以下に SKILL.md を置くだけでよい。
your-project/
└── .claude/
└── skills/
└── api-conventions/
└── SKILL.mdSKILL.md の中身は YAMLフロントマター + Markdownの本文 のみ。
---
name: api-conventions
description: REST API設計のコーディング規約
---
# API規約
- URLパスはkebab-case
- JSONプロパティはcamelCase
- リストAPIには必ずページネーション
- URLパスにバージョンを含める（/v1/, /v2/）これだけで、Claudeはタスクの文脈に合わせてこのSkillを自動的に読み込む。明示的に呼び出したい場合は /api-conventions と入力するだけだ。
Skillsの配置場所――スコープで使い分ける
Skillsの配置場所によって「誰が使えるか」が変わる。優先度は下記の通りだ。
| 優先度 | パス | 用途 |
|---|---|---|
| 高 | Enterprise（組織管理） | 全社ルール |
| 中 | ~/.claude/skills/ | 個人の汎用Skill |
| 低 | .claude/skills/（プロジェクト内） | プロジェクト固有 |
プロジェクト内のSkillsはgitにコミットできるので、チーム全体で共有するのに最適だ。また、同名のSkillが複数の階層に存在する場合は上位の階層が優先される。なお、SkillsはAgent Skillsというオープンスタンダード（agentskills.io準拠）に基づいており、Claude Code固有の仕組みではなく複数のAIツール間で互換性を持つ点も覚えておきたい。
ビルトインSkills 5選――今すぐ使える強力コマンド
Claude Codeには最初から5つのSkillsが内蔵されている。/help に出てくるビルトインコマンド（/compact など）とは異なり、これらはプロンプトベースで動作し、ClaudeがツールをフルActivateしながら柔軟に作業を進める。
/batch― コードベースを調査して5〜30の独立タスクに分解し、git worktreeで並列実行。PR作成まで自動化できる/claude-api― Claude APIのリファレンスを読み込み、APIコードの作成・デバッグを支援。コード内にanthropicをimportすると自動発動/debug― Claude Code自体のデバッグログを読んでトラブルシュート。期待通りに動かないときに有効/loop― プロンプトを一定間隔で繰り返し実行。デプロイ監視・PRステータスのポーリングに最適/simplify― 最近変更したファイルに対し、コード再利用・品質・効率の3観点で並列レビューし、問題を発見・修正まで実行
特に /batch と /loop は強力だ。例えば src/ 以下のすべてのReactコンポーネントに displayName を追加する作業なら、/batch src/ のすべてのReactコンポーネントにdisplayNameを追加して と指示するだけで、コードベース調査→タスク分解→独立したgit worktreeでの並列実行まで自動で行われる。/loop 5m デプロイが完了したか確認して のように使えば、5分ごとにセッションを開いたまま定期監視もできる。
まとめ――Skillsで「再現可能なワークフロー」を作る
Skillsの本質は、ドメイン知識と再現可能なワークフローをClaude Codeに持たせる仕組みだ。CLAUDE.mdに何でも書いてしまうのではなく、「APIコーディング規約」「テスト手順」「デプロイフロー」などをそれぞれ独立したSkillとして管理することで、コンテキストを節約しつつ必要なときだけ精度の高い支援を受けられる。プロジェクトにコミットすればチーム共有も可能で、個人の ~/.claude/skills/ には自分の汎用テクニックをストックしておける。元記事では10のテクニックがより詳細に解説されているので、ぜひ一読してSkillsの全貌を把握してほしい。