再利用可能な手順カードを整理してClaudeに渡す様子のイラスト
約 3 分

Claude Skillsの作り方｜繰り返す仕事を再現可能な手順にする

Skillsを単なるプロンプト集にしないために、入力・判断・出力・例外を残す設計とチーム運用を解説します。

Claude Skills完全解説｜CLAUDE.mdとの違い・作り方・チームでの使いどころ

Claude Codeを使っていると、毎回同じチェックリストや作業手順を貼り付ける場面が出てきます。その繰り返しを、必要な時だけ呼び出せる形にするのがClaude Skillsです。

Skillsは「長い手順」、CLAUDE.mdは「毎回必要な短い前提」を置く場所です。 この分担を守るだけで、指示が膨らみすぎる問題をかなり防げます。

Claude Skillsとは

Skillsは、SKILL.md に手順や判断基準を書き、Claude Codeが関連する作業で読み込んだり、ユーザーが /スキル名 として呼び出したりできる仕組みです。Claude CodeではカスタムコマンドもSkillsに統合されています。

たとえば、リリース前チェック、PRレビュー、障害一次調査、記事作成、デザイン確認などに向いています。作業のたびに同じ品質基準を渡すより、手順を一か所でメンテナンスできます。

CLAUDE.mdとの違い

  • CLAUDE.md：プロジェクトの構造、必須コマンド、禁止事項など、毎回の作業に必要な事実
  • SKILL.md：特定の仕事でだけ必要な、複数ステップの手順・チェックリスト・参照資料

たとえば「依存関係の追加はpnpm」はCLAUDE.md向きです。一方「リリース候補を検証し、変更履歴を確認し、ロールバック手順を点検する」はSkill向きです。

詳しいCLAUDE.mdの設計はCLAUDE.md完全解説も参照してください。

保存場所と効く範囲

  • ~/.claude/skills/<名前>/SKILL.md：自分の全プロジェクトで使う
  • .claude/skills/<名前>/SKILL.md：そのリポジトリのチームで共有する
  • プラグイン内のskills/：プラグインを有効にした範囲で使う

プロジェクト固有の手順は、原則として.claude/skills/に置き、Gitでレビューできるようにします。個人の好みや私用サービスに依存するものはホームディレクトリ側に分けます。

最小のSKILL.md例

---
description: PRをレビューし、リスクと不足テストを指摘する。
---

# 手順
1. 変更差分と関連テストを読む。
2. 仕様変更・破壊的変更・秘密情報を確認する。
3. 指摘は「根拠・影響・改善案」で箇条書きにする。
4. 根拠がない推測は、確認事項として分ける。

ディレクトリ名がスキル名になります。descriptionは、Claudeが自動利用を判断する材料なので、「いつ使うか」を具体的に書きます。

良いSkillの作り方

  1. 繰り返しを見つける：同じ説明を2〜3回書いた仕事が候補です。
  2. 入力と出力を固定する：何を読ませ、何を返すのかを明確にします。
  3. 検証を入れる：テスト、チェックコマンド、レビュー観点を手順に含めます。
  4. 長い資料は分離する：必要なら同じフォルダに参照ファイルを置き、SKILL.mdは案内役にします。
  5. 実行結果で直す：失敗した時だけ、再発防止になる一文を足します。

ありがちな失敗

  • CLAUDE.mdの内容を丸ごと複製する
  • 曖昧な「いい感じにレビューする」だけで、判断基準がない
  • 手順が巨大化し、どの仕事にも使われる万能スキルにする
  • 秘密情報や固定トークンをSkillに書く

Skillは自動化の魔法ではなく、チームの作業手順をレビュー可能な形にする道具です。人が最終承認するポイントと、失敗時の停止条件も明記しましょう。

今日の一歩

直近で2回以上繰り返した作業を1つ選び、「入力」「手順」「出力」「確認」の4項目だけを書き出してください。それが最初のSkillの骨格になります。

参照した一次情報

この記事で追加した実務メモ

この記事は、SKILL.mdを作ることより、作った手順が他の人にも再現できるかを確かめる観点を加えて更新しました。

最初のSkillは、失敗したときに影響が小さい定型作業を選びます。実行後に直した箇所を追記すると、手順書が育ちます。

あわせて読みたい