Claude Code Media
無料で試す
10分3,992字中級

Claude Code Superpowers とは？エージェントに Skills で超能力を付与する実装ガイド

Claude Code Superpowers の仕組みを解説。エージェント（.claude/agents/）とスキル（.claude/skills/）を組み合わせて超能力エージェントを作る方法を SessionStart フック・実装パターン・3つのユースケース付きで紹介します。

By Claude Code Media 編集部Reviewed by Claude Code Media 編集部

Claude Code Superpowers は、エージェントにスキルファイルを組み合わせることで、特定領域で再現性の高い精度と速度を発揮させるアーキテクチャパターンです。単体のスキルや単体のエージェントだけでは実現しにくい「ドメイン特化型の自律エージェント」を設計する方法を、実装コードとともに解説します。

週1ニュースレター（無料）に登録すると、Superpowers パターンのテンプレートと最新事例が毎週木曜に届きます。

1. Claude Code Superpowers とは何か

Claude Code には大きく3つの拡張機構があります。

  • Skills（.claude/skills/<name>.md）: 自社固有のノウハウや手順を記憶させる
  • Agents（.claude/agents/<name>.md）: 特定ミッションに特化したサブエージェントを定義する
  • Hooks（.claude/settings.json の hooks セクション）: ツール呼び出し前後にシェルスクリプトを差し込む

"Superpowers" は、このうち Skills と Agents を組み合わせる設計パターンの名称です。エージェント定義ファイルの冒頭に Skills 呼び出し手順を書き込み、エージェントが起動した瞬間に必要なスキルを自動ロードする仕組みを指します。

Claude Code の公式ドキュメント（Anthropic: Claude Code overview）では、スキルとプロンプトキャッシュを組み合わせることでコストを抑えながら知識を再利用できると説明されています。Superpowers パターンはこの特性を最大化した使い方です（執筆時点の情報。最新仕様は公式で確認してください）。

Superpowers がなぜ重要か

スキルファイルを単体で使う場合、毎回「この知識を使って」と明示する必要があります。しかし Superpowers パターンでは、エージェント定義にスキルの呼び出し順序を内包させるため、指示側（人間や親エージェント）はエージェント名を呼ぶだけで済みます。

たとえば SEO 記事を書くエージェントに「ペルソナ定義スキル」「MDX フォーマットスキル」「E-E-A-T チェックスキル」の3つを組み合わせれば、指示は seo-writer として記事を書いて の一言で完結します。チーム内で同じエージェント定義を共有すれば、メンバー全員が同じ水準の成果物を出しやすくなります。

従来の Skills 単体との違い

比較項目Skills 単体Superpowers（Agent + Skills）
スキル呼び出し毎回明示が必要エージェント起動で自動ロード
複数スキルの組み合わせ手動で都度指定エージェント内に定義済み
再利用性スキルレベルエージェント全体として再利用
チーム展開スキルファイルの個別共有が必要agents/*.md を共有するだけ

スキルの基礎概念については、Claude Code Skills 完全ガイド：自社固有の知識を再利用可能にするで詳しく解説しています。

2. Superpowers アーキテクチャの設計原則

2-1. セッション開始時の Skills 自動ロード

Superpowers の核心は SessionStart フックとの組み合わせです。.claude/settings.json に以下を設定すると、セッション開始時に skills/INDEX.md（全スキル一覧）が自動的にコンテキストに読み込まれます。

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "cat .claude/skills/INDEX.md"
          }
        ]
      }
    ]
  }
}

この設定により、エージェントは起動直後から「どんなスキルが使えるか」を知った状態になります。あとはエージェント定義のシステムプロンプト内で「Skill ツールを使って XXX スキルを読み込め」と書くだけで、ドメイン知識が自動注入されます。

2-2. エージェント定義ファイルの構造

Superpowers パターンのエージェント定義ファイルは、標準的なエージェント定義に「スキルロード手順」を追加した構造になります。

---
name: seo-article-writer
description: SEO記事を自律的に生成するライターエージェント
model: claude-sonnet-4-5
---

## ミッション
高品質なSEO記事を、ペルソナ・MDX・E-E-A-Tの基準を全て満たす形で生成する。

## セッション開始時の必須手順（Superpowers ロード）
1. `persona-claude-code-media` スキルを Skill ツールで読み込む
2. `mdx-frontmatter-spec` スキルを Skill ツールで読み込む
3. `e-e-a-t-checklist` スキルを Skill ツールで読み込む

上記3スキルをロードした後に、記事生成を開始すること。

## 入力
- target_kw: 対象キーワード
- pillar_context: 親ピラー記事のMDX

## 出力
- apps/{site}/content/{category}/{slug}.mdx

エージェント定義の先頭でスキルを明示することで、どの知識を持って動くかが人間にも読めるドキュメントとして残ります。これが Superpowers パターンの設計上の強みの1つです。

2-3. スキルの粒度設計

Superpowers パターンで失敗しやすいのは、スキルの粒度が大きすぎるケースです。1スキルは 1つの明確な役割に絞ることで、組み合わせの自由度が高まります。

NG パターンOK パターン
all-writing-rules.md（全ルールを1ファイルに詰め込む）persona.md ＋ mdx-format.md ＋ eeat.md
company-knowledge.md（会社情報を全部まとめる）product-specs.md ＋ brand-voice.md ＋ faq.md

スキル・Subagents・Hooks の使い分け全体像については、Claude Code Skills × Subagents × Hooks 使い分け完全マップを参照してください。

3. Superpowers エージェントの実装パターン

実務でよく使われる3つのパターンを紹介します。

3-1. コンテンツライターエージェント（3スキル構成）

SEO メディア運営で需要が高いパターンです。「ペルソナ理解」「フォーマット準拠」「品質チェック」の3スキルをロードして記事生成を行います。

---
name: content-writer
description: SEOコンテンツを生成するライターエージェント
model: claude-sonnet-4-5
---

## Superpowers（セッション開始時に必ずロード）
- Skill: persona           # 読者ペルソナ定義
- Skill: mdx-frontmatter   # MDX frontmatter スキーマ
- Skill: e-e-a-t-checklist # 信頼性チェックリスト

## ワークフロー
1. ペルソナスキルで読者像を確認する
2. 競合記事を3本分析して差別化軸を特定する
3. H2/H3構成を作成する（H2 × 3以上、H3 × 5以上）
4. 本文1,500字以上で執筆する
5. E-E-A-Tチェックリストで品質を検証する
6. MDXフォーマットで出力する

このパターンでは、ライターエージェントを呼び出す側は「target_kw と pillar_context を渡す」だけで、ペルソナ確認・競合分析・品質検証まで自動実行されます。

3-2. コードレビューエージェント（4スキル構成）

開発チームの品質管理に使うパターンです。言語別のコーディング規約・セキュリティ・テスト・パフォーマンスの4スキルを組み合わせます。

---
name: code-reviewer
description: TypeScript/Python コードを包括的にレビューするエージェント
model: claude-sonnet-4-5
---

## Superpowers（セッション開始時に必ずロード）
- Skill: typescript-patterns  # TypeScript コーディング規約
- Skill: security-checklist   # OWASP Top 10 チェック
- Skill: testing-standards    # テストカバレッジ基準
- Skill: performance-patterns # N+1 クエリ・計算量チェック

## スキル優先順位（競合時は上位が優先）
1. security-checklist（セキュリティ / 絶対優先）
2. typescript-patterns（コーディング規約）
3. testing-standards（テスト）
4. performance-patterns（パフォーマンス）

## レビュー出力フォーマット
重要度: CRITICAL / HIGH / MEDIUM / LOW
指摘: <問題の説明>
修正案: <改善後のコード>

スキル間で指示が矛盾する場合のために、優先順位を明示しておくことがポイントです。

3-3. 自己改善型エージェント（Skills × Hooks 連動）

最も発展的なパターンで、実行後に Hooks を介してスキルを自動更新し、エージェント自体が成長します。

#!/bin/bash
# PostToolUse Hook: エージェント実行後にスキルを自動更新
# .claude/hooks/update-skills.sh

RESULT="$1"
SKILL_FILE=".claude/skills/lessons-learned.md"

if echo "$RESULT" | grep -q "ERROR"; then
  # エラーパターンを lessons-learned スキルに追記
  TIMESTAMP=$(date '+%Y-%m-%d %H:%M')
  echo "- ${TIMESTAMP}: ${RESULT}" >> "$SKILL_FILE"
fi

このパターンでは、エラーが発生するたびに lessons-learned.md スキルが自動更新されます。次回実行時、エージェントはそのスキルを読み込んで同じミスを回避できます。

Hooks の詳細実装については、Claude Code Hooks 完全ガイドでライフサイクルイベント別に解説しています。

4. Superpowers 導入時の注意点

4-1. コンテキスト消費量の管理

スキルは読み込むほどコンテキストを消費します。Claude Sonnet の場合、セッションのコンテキスト上限に近づくと自動コンパクションが起動し、スキルの内容が圧縮される可能性があります。

推奨するスキルのロード順序:

  1. 必須スキル（毎回使う）: セッション開始直後にロードしてキャッシュに乗せる
  2. 条件付きスキル（タスク依存）: 処理内容が判明した後でロードする
  3. 補助スキル（参照のみ）: INDEX.md でメタ情報のみ保持し、本文は必要な時だけ読む

スキルファイルは 1 ファイル 2,000 トークン以内を目安に設計すると、複数スキルを組み合わせてもコンテキストが圧迫されにくくなります。

4-2. スキル間の矛盾を避ける設計

複数スキルを組み合わせると、スキル間でルールが矛盾するケースが出てきます。

典型的な矛盾の例:

  • coding-style.md: 「関数は50行以下に保つ」
  • legacy-system.md: 「既存の大規模関数はそのまま維持する」

このような矛盾を防ぐため、エージェント定義に スキルの優先順位を明示します。前述のコードレビューエージェントの例が参考になります。

4-3. Superpowers をチームで共有する方法

Superpowers パターンの利点の1つはチーム展開の容易さです。.claude/ ディレクトリを Git 管理することで、チーム全員が同じ能力を持つエージェントを使えます。

.claude/
├── agents/
│   ├── code-reviewer.md      # Superpowers 定義済みエージェント
│   ├── content-writer.md
│   └── security-auditor.md
├── skills/
│   ├── INDEX.md              # スキル一覧（SessionStart でロード）
│   ├── typescript-patterns.md
│   ├── persona.md
│   └── security-checklist.md
└── settings.json             # SessionStart フック設定

Git にコミットして main へ push すれば、新メンバーは git clone するだけで即戦力のエージェント環境が整います。ドキュメントのメンテナンスコストも下がり、「なぜそのスキルが必要か」をエージェント定義に書いておくことで引き継ぎも容易になります。

まとめ：Superpowers パターンで何が変わるか

Claude Code の Superpowers パターンを導入すると、エージェントは起動した瞬間から専門家として動き始めるようになります。

変化の要点:

  • 指示の簡素化: 複雑な前提条件を毎回伝える必要がなくなる
  • 品質の安定化: スキルに基準を書くことで毎回同じ水準を保ちやすくなる
  • チーム展開のスピード: エージェント定義を共有するだけで全員が同じ能力を持てる
  • 自己改善の自動化: Hooks と組み合わせると実行経験から学習するエージェントになる

Claude Code 全体の使い方については、Claude Code 完全ガイド で料金・インストール・MCP・Hooks まで体系的に解説しています。Superpowers パターンは「Claude Code を使い始めた段階」から「本格的な自律運用」へステップアップするための設計思想です。まず1つのエージェントに2〜3のスキルを組み合わせるところから始めてみてください。

関連記事

この記事の著者

claude-code-media 編集部／ Claude Code 専門編集チーム

Claude Code の非エンジニア向け業務効率化メディア『claude-code-lab.jp』を運営。フリーランス・中小企業・個人開発者向けに、実装テンプレ・業務自動化テクニック・Vibe Coding 入門を配信。

Claude Code 完全ガイドVibe CodingAI 業務効率化非エンジニア向け AI 教育MCP（Model Context Protocol）
運営: 株式会社AIKNOW著者プロフィールを見る →無料ニュースレターを購読 →
ByClaude Code Media 編集部

AI支援で執筆 — 本記事は Claude Code エージェントによる執筆支援を受け、編集部が事実確認・編集を行っています。 数値・引用元は記事更新日時点で確認済みですが、最新情報は各公式サイトでご確認ください。