Claude Code テンプレート：Skills、Agents、Hooks など

Claude Code テンプレートとは？

Claude Code テンプレートは、プロジェクト内やローカル環境全体での Claude Code の挙動をカスタマイズするための再利用可能な設定ファイルです。 

重要なのは、テンプレートがファイルベースである点です。一般的な設定 GUI からインストールして画面で設定するのではありません。Claude Code は特定のファイルやフォルダを検出し、関連メタデータをコンテキストに読み込み、その情報をもとに挙動を決定します。

実際には、プロジェクト単位の .claude/ のようなフォルダに保存された Markdown、JSON、またはシェル系のファイルであることが多く、共有のためにプラグイン風ディレクトリにパッケージ化されることもあります。

一般的なプロジェクトレベルの構成例は次のようになります。

my-app/
├── CLAUDE.md
├── .mcp.json
└── .claude/
    ├── skills/
    │   └── database-migration/
    │       └── SKILL.md
    ├── agents/
    │   └── security-auditor.md
    ├── commands/
    │   └── summarize-pr.md
    └── settings.json

Claude Code テンプレートと CLAUDE.md の違い

CLAUDE.md は依然として重要ですが、役割が異なります。CLAUDE.md はプロジェクトのブリーフだと考えてください。プロジェクトの内容、重要なコマンド、適用するコーディング規約、Claude が覚えておくべきアーキテクチャの慣習などです。 

詳しい解説は、CLAUDE.md 作成ガイドをご覧ください。

テンプレートはよりモジュール式です。

• Skill は移行作業のワークフローを記述できます。 
• Agent はセキュリティレビューのペルソナを分離できます。 
• Hook はファイル編集後に実行できます。 
• MCP 設定は Claude を GitHub、SQLite、その他の外部システムに接続できます。

これは、より広い Claude Code のワークフローデザインともつながります。強力なテンプレートは、計画、テスト、コンテキスト引き継ぎに関する良い習慣と組み合わせると最も効果を発揮します。 

こうした実践は、ベストプラクティスガイドでさらに詳しく解説しています。

カスタムコマンドは skills システムでも扱われますが、従来の .claude/commands/ 形式も引き続き機能します。推奨される新しい形式は .claude/skills/<name>/SKILL.md で、スラッシュコマンドでの呼び出しと、Claude による自動呼び出しの両方をサポートします。

利用できる Claude Code テンプレートの種類は？

Claude Code のテンプレートエコシステムは、一般に6つのカテゴリ（skills、agents、commands、hooks、MCP 連携、plugins）に整理されています。 

最初の5つは Claude の挙動を直接変えます。Plugins は少し性質が異なり、skills、agents、hooks、commands、MCP サーバー、その他のコンポーネントを再利用可能なパッケージとして束ねる配布形式です。

以下で各カテゴリを見ていきます。

1. Skills

Skills は、繰り返し実行する複数ステップのタスク向けの指示バンドルです。通常は、YAML フロントマターと Markdown 本文を含む SKILL.md を格納したフォルダです。 

フロントマターは skill の機能と挙動を記述し、本文は Claude に従うべき手順を伝えます。詳しくは Claude Skills ガイドをご覧ください。

Claude は skill の説明を使って、その skill が関連する場面かどうかを判断します。デフォルトでは、ユーザーと Claude の両方が skill を呼び出せます。/skill-name と入力するか、現在のタスクが説明に合致する場合は Claude が自動でロードします。デプロイなど、手動で制御したいワークフローでは自動呼び出しを無効にすることもできます。

ファイルの短い例：.claude/skills/database-migration/SKILL.md

---
name: database-migration
description: Use when creating, reviewing, or modifying database migrations. Ensures migrations are reversible, tested, and checked before and after execution.
allowed-tools:
  - Read
  - Write
  - Bash
---

# Database Migration Skill

When working on a database migration:

1. Inspect the existing schema and migration history before writing changes.
2. Confirm whether the migration is additive, destructive, or data-transforming.
3. Create a reversible migration whenever the framework supports rollback.
4. Run the project’s migration check command before applying the migration.
5. Run tests that cover the affected models, queries, or API endpoints.
6. After writing the migration, summarize:
   - schema changes
   - rollback behavior
   - affected tables
   - test commands run

このように、指示が手順化されている点が有用です。単に「移行では注意すること」と言うだけでなく、再現可能なチェックリストを与えます。 

Skill は、API エンドポイントの生成、変更履歴の作成、テストのスキャフォールディング、リリースノートの作成、プルリクエストのレビュー、移行チェックの実行など、Claude に2回以上貼り付けるような内容に最適です。

開発者がどのような作業を再利用可能な AI ワークフローにしているかの広い例は、Agent Skills のリストをご覧ください。

2. Agents

Agents、より厳密には Claude Code のカスタム subagent は、独自の Markdown 定義、YAML フロントマター、ツール制限、モデル選択、システムプロンプトを持つ特化型の AI アシスタントです。 

プロジェクト範囲なら .claude/agents/、個人範囲なら ~/.claude/agents/ に配置できます。Agents は Claude に作成させるか、.claude/agents/ フォルダ内の markdown ファイルを直接編集して作成します。

Skills と Agents の違いもあります。Skill はタスクの進め方を定義します。Agent は作業中の Claude の「人物像」—役割、焦点、権限、境界—を定義します。

Agent の例を見てみましょう。

---
name: security-auditor
description: Reviews code for security vulnerabilities and produces a findings report without modifying files.
tools: Read, Glob, Grep, Bash
model: sonnet
---

You are a security auditor.

Your task is to inspect the codebase for vulnerabilities, risky patterns, and missing safeguards.

Rules:
- Do not edit files.
- Do not suggest broad rewrites unless directly tied to a security issue.
- Focus on authentication, authorization, input validation, secrets, dependency risk, and unsafe shell or SQL usage.
- Produce a findings report with severity, affected files, evidence, and recommended next steps.

この agent は、Claude に明確な境界を与える点で有用です。一般的なセッションでは、問題を見つけるとすぐ修正に流れてしまうかもしれません。セキュリティ監査の agent は、調査と報告のみに専念し、変更を避けるよう指示されています。 

Agents は、セキュリティ監査、ドキュメントレビュー、アーキテクチャレビュー、データエンジニアリング、コード品質チェックなど、コンテキストの分離と権限境界が重要な専門領域に最適です。

また、特化した skills と組み合わせても有効です。たとえばセキュリティ監査の agent は調査結果レポートの skill を呼び出し、フロントエンドレビューの agent はコンポーネントテストの skill を使う、といった形です。

3. Commands

Commands は /generate-tests、/check-deps、/summarize-pr のようにスラッシュで呼び出すショートカットです。歴史的には、.claude/commands/ 配下の Markdown ファイルとして保存され、ファイル名がコマンド名になっていました。 

Claude Code はこのレガシー形式を今もサポートしていますが、新しいコマンド風ワークフローには skills の利用を推奨します。skills は同じ /name 呼び出しと、適切な場面での自動呼び出しをサポートするためです。

Commands は、トリガーを明示したいときに最適です。Skill はタスク一致で自動発火することがありますが、Command は選んだときだけ実行されるべきです。つまり「今テストを生成」「今この PR を要約」「今依存関係をチェック」「今コミットメッセージを用意」といったチェックポイントに有用です。

4. Hooks

Hooks は、Claude Code のライフサイクルイベントに応じて実行される自動化ルールです。ユーザー定義のシェルコマンドを、Claude Code の特定のタイミングで動かすことで、挙動を決定論的に制御できます。 

これまでのテンプレートとの違いは、Hooks が「何を尋ねるか」ではなく「Claude が何をするか」によってトリガーされる点です。

平たく言えば、編集後にファイルを整形することを Claude に毎回思い出させる必要はありません。Hook が自動で実行します。

現在のフックイベント名には、PreToolUse、PostToolUse、Notification、Stop などがあります。 

例：Claude がファイルを編集または書き込みした後にフォーマッタを実行する

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Example: block risky shell commands before Claude runs them:
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/block-dangerous-bash.py"
          }
        ]
      }
    ]
  }
}

Hooks は、Claude にスキップさせるべきでないルールに最適です。リント実行、編集ファイルの整形、保護対象ファイルのブロック、生成コードのチェック、Claude が入力待ちの際の通知送信など。 

詳しいチュートリアルは、Claude Code Hooks ガイドをご覧ください。

5. MCP 連携

MCP 連携は、Model Context Protocol を通じて、Claude Code を外部ツール、データソース、API に接続します。MCP は、AI システムと外部ツールの間のコネクタ層として機能します。Claude Code では、ローカルファイルやシェルコマンドの先へと機能を拡張できることを意味します。 

設定した MCP サーバーに応じて、GitHub、データベース、ドキュメントシステム、クラウド基盤、社内 API など外部サービスとやり取りできます。完全な解説とデモプロジェクトは、Model Context Protocol チュートリアルをご覧ください。

MCP サーバーは概ね3種類の機能を公開できます。

• Tools：GitHub の issue 作成やデータベースクエリの実行など、Claude が呼び出せる実行関数。
• Resources：ファイル、DB の行、ドキュメントなどの読み取り専用コンテキストソース。
• Prompts：サーバーが提供する再利用可能なタスクテンプレート。

プロジェクトレベルの .mcp.json では、複数サーバーを横並びに設定できます。

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sqlite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "./data/app.db"
      ]
    }
  }
}

これは重要です。Claude はアクセス可能なコンテキストとツールからしか推論できないためです。MCP がなければ、ローカルファイルは見られても、課題トラッカー、データベース、クラウド環境、社内 API までは把握できません。 

MCP は、静的なコードスナップショットではなく実際のスタックで作業させたい場合や、外部データへのアクセスが必要な場合に最適です。

6. Plugins

Plugins はパッケージ化されたバンドルです。1つのインストール可能な構造の中に、skills、agents、hooks、MCP 設定、commands、その他のコンポーネントを含められます。 

Claude Code では、プラグインは通常 .claude-plugin/plugin.json マニフェストと、skills/、agents/、hooks/、プラグインルートの .mcp.json といったコンポーネントフォルダを含みます。

プラグイン構成の例：

frontend-workflow-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── component-test/
│       └── SKILL.md
├── agents/
│   └── frontend-reviewer.md
├── hooks/
│   └── hooks.json
└── .mcp.json

plugin.json の例：

{
  "name": "frontend-workflow",
  "displayName": "Frontend Workflow",
  "version": "1.0.0",
  "description": "Frontend development workflow with review agents, test skills, and formatting hooks",
  "author": {
    "name": "Your Team"
  }
}

Plugins は新しい挙動タイプを追加するわけではありません。ほかのタイプを持ち運び可能にします。チームで完全なセットアップを共有したいとき、複数プロジェクトで同じワークフローを再利用したいとき、あるいは手作業で各ファイルを作る代わりにコミュニティ製のバンドルを導入したいときに使ってください。

ゼロからの作成は、DataCamp の Claude Code プラグイン作成ステップ・バイ・ステップガイドを参照してください。

どのテンプレートタイプを選ぶべき？

種類が多くて混乱するのも無理はありません。いずれも Claude の挙動を変えます。違いは主に、どうトリガーされるか、どのような制御を提供するかです。

分かりやすくするため、以下に比較を示します。

簡単な判断基準：

• Claude がコードに触れるたびにルールを自動適用したいなら、hook。
• 特定タスクで Claude に深いドメイン専門性を持たせたいなら、agent。
• Claude に一貫して繰り返させたいワークフローを符号化したいなら、skill。
• 適切なタイミングで自分でアクションを呼び出したいなら、command またはコマンド風の skill。
• Claude に外部サービスやライブデータが必要なら、MCP。
• 完全なワークフローセットアップをインストール／共有したいなら、plugin。

実プロジェクトでは、これらは組み合わせて使われます。たとえばセキュリティ用プラグインは、security-auditor agent、audit-findings skill、dependency チェックの command、pre-commit hook を束ねるかもしれません。agent は役割を定義し、skill はレポート構成を定義し、command は明示的なチェックポイントを提供し、hook はガードレールを強制します。

Claude に実装前に正式な計画に従わせたいワークフローでは、仕様駆動開発の方が即興のプロンプトより適していることがよくあります。

Claude Code テンプレートはどこで見つかる？

実用的な入手先は3つあります。Anthropic、コミュニティコレクション、そして自作です。

まずは Anthropic 公式リソースとドキュメントから始めましょう。Anthropic の Claude Code ドキュメントは skills、subagents、hooks、MCP、plugins を網羅しており、本番適用前に最新のファイル形式と挙動を確認する最適な場所です。

次に、コミュニティコレクションを活用しましょう。最も目立つコミュニティハブは aitmpl.comで、Claude Code プロジェクト向けのすぐに使える設定のカタログをうたっています。現在のナビゲーションには Skills、Agents、Commands、Settings、Hooks、MCPs、Plugins が含まれます。 

現在の対話的インストールコマンドは次のとおりです。

npx claude-code-templates@latest

プロジェクトのドキュメントでは、短いエイリアスも示されています。

npx cct@latest

特定コンポーネント向けには、GitHub の README に次のようなインストールコマンドが掲載されています。

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

複数のフラグを1コマンドにまとめて、フルスタックを一括インストールする方法も示されています。

コミュニティ製テンプレートを評価する際は、次の品質指標を確認してください。

• description は、Claude が skill や agent を正しくトリガーできるだけの具体性があるか。

• allowed-tools の範囲は適切に絞られているか。不要に広範な Write や Bash 権限を要求していないか。

• リポジトリが最近もメンテナンスされているか。

• テンプレートが何を変更するのか説明しているか。

• レビューしていないコードを実行する hook や MCP サーバーを含んでいないか。

最後に、自作する方法です。自社スタックに強く結びつくワークフローでは、これが最適解であることが多いです。コミュニティ製テンプレートは有益な土台になり得ますが、社内の移行ポリシー、命名規則、データモデル、デプロイのリスク許容度までは把握できません。

まとめ

Claude Code テンプレートは、Claude Code をセッションごとのアシスタントから、持続的な開発環境へと進化させる手段です。 

ここで紹介した6つのカテゴリは、実はレイヤー構造です。skills はワークフローを符号化し、agents は役割を定義し、commands は明示アクションを作り、hooks はガードレールを強制し、MCP は外部システムに接続し、plugins はすべてを再利用可能にパッケージ化します。

出発点として最適なのは巨大なプラグインスタックではありません。まずは最も繰り返すワークフロー向けに1つ skill を作ることをお勧めします。そのうえで、Claude のデフォルト挙動にまだ摩擦がある箇所が見えたら、専門レビュー用の agent、強制用の hook、ライブシステムアクセス用の MCP サーバーを追加しましょう。

Claude Code をさらに学ぶには、Claude Code 101 と Claude Code in Action の各コースをご覧ください。