Claude Codeを使い始めてしばらく経つと、「毎回同じプロンプトを打ち込んでいる」「CLAUDE.mdがどんどん肥大化してきた」「チームで指示の質にばらつきがある」といった悩みが出てきませんか?
そんな課題を解決するのが、Claude Codeのskills機能です。この記事では、すぐに使えるskillsのアイデアを20個まとめました。「こういう使い方があったのか!」と感じてもらえるものを厳選しているので、ぜひ手元に置いておいてください。
結論:skillsを育てるほど、Claude Codeは賢くなる
「skillsって何となく知っているけど、どう活用すればいいかわからない」と悩んでいませんか?
結論から言うと、skillsはClaude Codeに"再利用可能な専門知識"を渡す仕組みです。一度SKILL.mdを書いておけば、Claudeが文脈を判断して自動で使ってくれます。/skill-nameで直接呼び出すこともできるため、チームの作業品質を均一に保ちながら、定型タスクの自動化も実現できます。
| 機能 | 特徴 | 使い分け |
|---|---|---|
| CLAUDE.md | プロジェクト全体のコンテキスト・方針 | 常時参照される背景情報 |
| skills(SKILL.md) | 手順・チェックリスト・ワークフロー | 必要なときだけ読み込まれる |
| カスタムコマンド | 単発の定型指示(現在skillsに統合) | /commandで呼び出す |
✅ skillsの本体は使われるときにだけ読み込まれるため、CLAUDE.mdを肥大化させずに済みます。これが個人的にいちばん気に入っているポイントです。
skillsの基本構造をおさらい
skillsは.claude/skills/スキル名/SKILL.mdという形でプロジェクトに配置します。サポートファイル(テンプレート、出力例、スクリプトなど)も一緒に置けるのが特徴で、より精度の高い動作が期待できます。
.claude/
skills/
code-review/
SKILL.md ← メインの指示(必須)
checklist.md ← 参照用チェックリスト(任意)
example.md ← 出力例(任意)
❌ CLAUDE.mdに手順をどんどん書き足していく
✅ 手順系はskillsに切り出して、CLAUDE.mdはコンテキストに専念させる
エンジニアなら読むべき本を30冊以上紹介しています。
正直、私の仕事のやり方をガラッと変えた神本やSQLのチューニングに悩んだ時にめちゃくちゃ役に立ったもあります👇
→記事を読む
skillsアイデア大全20選
カテゴリ別に整理しました。自分のプロジェクトに合いそうなものから試してみてください。
🔍 コードレビュー系
| # | スキル名 | 概要 | 呼び出し例 |
|---|---|---|---|
| 1 | code-review |
レビュー観点(可読性・セキュリティ・パフォーマンス)を統一 | /code-review |
| 2 | security-check |
OWASP観点でセキュリティリスクを洗い出す | /security-check |
| 3 | perf-review |
N+1問題・不要なループ・DBクエリ効率を指摘 | /perf-review |
| 4 | naming-review |
命名規則(camelCase/snake_case等)の統一チェック | /naming-review |
私はコードレビューskillに「チーム独自のコーディング規約」と「よくある指摘パターン」を組み込むと、レビューの質がぐっと上がると感じています。
🧪 テスト系
| # | スキル名 | 概要 | 呼び出し例 |
|---|---|---|---|
| 5 | test-gen |
関数・クラスに対してユニットテストを自動生成 | /test-gen |
| 6 | e2e-scenario |
ユーザーストーリーからE2Eテストシナリオを作成 | /e2e-scenario |
| 7 | edge-case-finder |
境界値・異常系・例外パターンを列挙 | /edge-case-finder |
✅ テスト系skillsは出力例(expected output)をサポートファイルに入れておくと、生成されるテストの形式がブレにくくなります。
📝 ドキュメント系
| # | スキル名 | 概要 | 呼び出し例 |
|---|---|---|---|
| 8 | doc-gen |
JSDoc / TSDoc / docstringを自動生成 | /doc-gen |
| 9 | readme-update |
変更内容に合わせてREADMEを更新 | /readme-update |
| 10 | changelog-writer |
コミット履歴からCHANGELOGを自動作成 | /changelog-writer |
| 11 | api-doc |
エンドポイントからOpenAPI仕様書のドラフトを生成 | /api-doc |
❌ ドキュメントを後回しにして結局書かない
◎ skillsで"書く手間"を限りなくゼロに近づける
🔧 リファクタリング系
| # | スキル名 | 概要 | 呼び出し例 |
|---|---|---|---|
| 12 | refactor |
重複排除・関数分割・責務整理を提案 | /refactor |
| 13 | type-strengthen |
TypeScript型の強化(any排除・型ガード追加) | /type-strengthen |
| 14 | sql-optimize |
スロークエリの改善提案・インデックス設計レビュー | /sql-optimize |
🚀 デプロイ・運用系
| # | スキル名 | 概要 | 呼び出し例 |
|---|---|---|---|
| 15 | deploy-checklist |
本番デプロイ前の確認項目をチェックリスト形式で提示 | /deploy-checklist |
| 16 | rollback-guide |
障害発生時のロールバック手順を生成 | /rollback-guide |
| 17 | env-check |
環境変数の設定漏れ・本番/開発の差分を検出 | /env-check |
✅ deploy-checklistはチームの過去の障害事例をベースに項目をカスタマイズするのがポイントです。「なんとなく網羅的なチェックリスト」より、自チームの経験が詰まったもののほうが圧倒的に価値があります。
💬 コミュニケーション・管理系
| # | スキル名 | 概要 | 呼び出し例 |
|---|---|---|---|
| 18 | commit-msg |
変更内容から規約に沿ったコミットメッセージを生成 | /commit-msg |
| 19 | pr-description |
PRテンプレートに沿った説明文を自動作成 | /pr-description |
| 20 | task-breakdown |
大きなタスクをサブタスクに分解してIssue化 | /task-breakdown |
skillsを"育てる"ための3つのコツ
ここからは、実際に運用していて感じたコツを共有します。
コツ① アウトプット例を一緒に置く
SKILL.mdだけでなく、example_output.mdのような期待する出力例をサポートファイルとして同梱すると、Claudeの出力精度が上がります。「こういう形式で出してほしい」という意図がより正確に伝わる感覚があります。
コツ② 最初は小さく作る
いきなり完璧なskillを作ろうとしないことが大切だと思います。まずは3〜5行のシンプルなSKILL.mdを作って動作確認し、使いながら少しずつ育てていく方が長続きします。
| フェーズ | やること |
|---|---|
| v1 | 基本的な手順を箇条書きで書く |
| v2 | よくある失敗パターンを追加 |
| v3 | 出力例・チェックリストを追加 |
コツ③ チームで共有してGit管理する
skillsはプロジェクトの.claude/skills/に置くだけでGitに乗ります。チームメンバーが全員同じskillsを使えるようになるので、レビューの観点や作業品質が自然と統一されていきます。
◎ skillsはチームの"暗黙知"を形式知に変えるツールでもある、と個人的には考えています。
まとめ
- skillsは「必要なときだけ読み込まれる」再利用可能なワークフロー
- CLAUDE.mdの肥大化を防ぎつつ、高品質な出力を維持できる
- まずは自分がよく繰り返している作業を1つskill化してみるのがおすすめ
20個のアイデアの中から、「これは今すぐ使えそう」と思ったものを1つでも試してもらえたら嬉しいです。
エンジニアなら読むべき本を30冊以上紹介しています。
正直、私の仕事のやり方をガラッと変えた神本やSQLのチューニングに悩んだ時にめちゃくちゃ役に立ったもあります👇
→記事を読む