77
103

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Codeのskillsアイデア大全20選

77
Posted at

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のチューニングに悩んだ時にめちゃくちゃ役に立ったもあります👇
→記事を読む

77
103
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
77
103

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?