結論
Superpowers(スーパーパワーズ)は、Claude Code などのコーディングエージェントに「設計を聞いてから計画を書き、テストを先に書いて実装し、確かめてから完了と言う」進め方を覚えさせる、15個のスキルをまとめたプラグインです。Claude Code では /plugin install superpowers@claude-plugins-official で入ります。
この記事でわかること
- 15個のスキルの名前・働き・行数(v7.0.2 を取得して Python で数えた表)
- 公式マーケットプレイスと作者のマーケットプレイスの違いと、入れ方・更新・削除
- 自動で動く仕組み(SessionStart フック)と、入れる前に読むファイル
Superpowers は、作者 Jesse Vincent さんが GitHub(obra/superpowers)で公開しているプラグインです。入れると、「何か作りたい」と頼んだときにエージェントがすぐコードを書き始めず、まず目的を聞き返すようになります。下の図は、README に書かれた基本の流れです。
flowchart TD
A[作りたいと頼む] --> B[brainstorming<br>目的と設計を聞く]
B --> C[using-git-worktrees<br>作業場所を分ける]
C --> D[writing-plans<br>計画を書く]
D --> E[実装<br>TDD で1つずつ]
E --> F[requesting-code-review<br>レビュー]
F --> G[finishing-a-development-branch<br>マージかPRを選ぶ]
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| Superpowers とは | 開発の進め方を教える15個のスキルと、起動時に読み込ませるフックをまとめたプラグイン | Superpowersとは |
| Superpowers の入れ方(Claude Code) | 公式マーケットプレイスから /plugin install。作者のマーケットプレイスからも入る |
Superpowersの入れ方 |
| Superpowers の使い方 | ふだんどおり頼むだけ。スキルは説明文に合う場面で自動で呼ばれる | 基本の流れ |
| スキルはいくつあるか | v7.0.2 で15個。SKILL.md の合計は3,358行 | 中身を数えた結果 |
| /brainstorm が動かない | 以前のコマンドは v5.1.0 で削除。スキル名で呼ぶ | 版の変化 |
| 料金 | MIT ライセンスで公開。使ったぶんは Claude Code の利用量に数えられる | 使う前に読むところ |
| 止めたい・消したい | /plugin の Installed タブか claude plugin disable・uninstall |
確かめ方・更新・削除 |
| 入れる前に読むもの | hooks/hooks.json と、実行されるスクリプト・各 SKILL.md | 使う前に読むところ |
確認環境:Ubuntu 24.04.5 LTS の上で、git 2.43.0 を使って作者の公式リポジトリ(github.com/obra/superpowers)を取得し、タグ v7.0.2(コミット 22f0b46、2026年11月3日)の中身を Python 3.13.18 の自作スクリプトで集計しました(スキルの数・名前・description・行数・ファイル数、RELEASE-NOTES.md の版と日付)。Anthropic の公式マーケットプレイスの一覧(anthropics/claude-plugins-official の marketplace.json、2026年11月13日のコミット)と作者のマーケットプレイス(obra/superpowers-marketplace)も取得して、登録内容を読みました。このマシンでは Claude Code を起動しておらず、AI のモデルも呼んでいません。プラグインのインストール・/plugin の画面・スキルが自動で呼ばれる様子は、Claude Code の公式ドキュメント(code.claude.com の Plugins・Install and manage plugins・Skills・Plugin security and trust)と README の記載で書いています。SessionStart フックのスクリプトの実行は、この環境の権限で拒否されたため動かしていません。スクリプトを読み、同じ組み立てを自作の Python で再現して長さを数えました(確認日 2026年11月16日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Superpowersとは|Claude Codeのスキル集の入れ方・使い方と中身」
Superpowersとは(Claude Codeのスキル集)
この節では、Superpowers が何で、入れると何が変わるのかが分かります。
README は、Superpowers を「組み合わせられるスキルの集まりと、エージェントにそれを使わせるための最初の指示の上に作った、ソフトウェア開発の方法論」と説明しています。中身は Markdown で書かれた手順書(SKILL.md)が中心で、プログラムの本体のようなものではありません。エージェントが読む「仕事の進め方の決まり」をまとめたもの、と考えると近いです。
README の「How it works」に書かれた動きは次のとおりです。
1すぐに書き始めない
何かを作ろうとしていると分かると、コードを書く前に、本当にやりたいことを聞き返す。
2読める長さで設計を見せる
会話から引き出した仕様を、読んで飲み込める長さに区切って見せ、承認をもらう。
3計画どおりに進める
承認された設計から実装の計画を作り、「go」と言われたらサブエージェントに1つずつ任せてレビューしながら進める。
README は、これらが「自動で呼ばれるので、特別なことをしなくてよい」と書いています。考え方として挙がっているのは、テスト駆動開発(テストを先に書く)、思いつきより手順、複雑さを減らすこと、主張より証拠(完了と言う前に確かめる)の4つです。
「Superpowers」という名前のほかの意味
英語の superpowers は、ふだんは「超能力」や「超大国」を指します。Claude Code の話で「Superpowers」と言うときは、このプラグインの名前です。
Claude Code 以外でも使える
README の「Installation」には、Claude Code のほかに Antigravity、Codex(アプリと CLI)、Cursor、Devin CLI、Factory Droid、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Qwen Code、Hermes Agent、Muse の入れ方が並んでいます(2026年11月16日時点)。リポジトリの直下にも .claude-plugin・.codex-plugin・.cursor-plugin などの設定フォルダーがあり、同じスキルを各ツールに配る作りです。この記事では Claude Code での使い方を扱います。
Superpowersの中身:15個のスキルを実際に数えた結果
この節では、リポジトリを取得して、スキルがいくつあり、どれくらいの長さなのかを数えた結果が分かります。
まずリポジトリを取得し、版を確かめました。
$ git clone --depth 50 https://github.com/obra/superpowers.git
$ cd superpowers
$ git describe --tags
v7.0.2
$ git log -1 --format='%h %ad %s' --date=short
22f0b46 2026-11-03 Release v7.0.2: brainstorming tuning, harness bootstrap fixes, SDD helper fixes (#2657)
$ ls skills
brainstorming test-driven-development
diagnosing-superpowers using-git-worktrees
dispatching-parallel-agents using-superpowers
executing-plans verification-before-completion
finishing-a-development-branch writing-plans
receiving-code-review writing-skills
requesting-code-review
subagent-driven-development
systematic-debugging
次に、skills/ の下の各フォルダーにある SKILL.md を読み、先頭の frontmatter(--- で囲んだ設定の部分)と行数を数える Python を書きました。
import sys, re, pathlib
root = pathlib.Path(sys.argv[1]) # 取得したリポジトリのフォルダー
rows = []
for d in sorted((root / 'skills').iterdir()):
f = d / 'SKILL.md'
if not f.is_file():
continue
t = f.read_text(encoding='utf-8')
fm = re.match(r'^---\n(.*?)\n---\n', t, re.S).group(1)
keys = re.findall(r'^([A-Za-z_-]+):', fm, re.M)
desc = re.search(r'^description:\s*(.*)$', fm, re.M).group(1).strip('"')
files = [p for p in d.rglob('*') if p.is_file()]
rows.append((d.name, len(t.splitlines()), len(t.encode()), len(files), keys, desc))
print('skills', len(rows))
for name, lines, size, nfiles, keys, desc in rows:
print(f'{name:31s} lines={lines:4d} bytes={size:6d} files={nfiles:2d} keys={",".join(keys)} desclen={len(desc)}')
print('total lines', sum(r[1] for r in rows), 'total bytes', sum(r[2] for r in rows))
実行した結果です。
skills 15
brainstorming lines= 316 bytes= 15190 files= 8 keys=name,description desclen=213
diagnosing-superpowers lines= 120 bytes= 6941 files=20 keys=name,description desclen=375
dispatching-parallel-agents lines= 167 bytes= 6078 files= 1 keys=name,description desclen=106
executing-plans lines= 323 bytes= 18364 files= 3 keys=name,description desclen=170
finishing-a-development-branch lines= 225 bytes= 7781 files= 1 keys=name,description desclen=101
receiving-code-review lines= 205 bytes= 6203 files= 1 keys=name,description desclen=234
requesting-code-review lines= 95 bytes= 2974 files= 2 keys=name,description desclen=107
subagent-driven-development lines= 339 bytes= 19740 files=15 keys=name,description desclen=85
systematic-debugging lines= 283 bytes= 9530 files= 6 keys=name,description desclen=91
test-driven-development lines= 330 bytes= 9578 files= 2 keys=name,description desclen=79
using-git-worktrees lines= 167 bytes= 6813 files= 1 keys=name,description desclen=196
using-superpowers lines= 65 bytes= 3192 files= 8 keys=name,description desclen=154
verification-before-completion lines= 120 bytes= 3646 files= 1 keys=name,description desclen=225
writing-plans lines= 204 bytes= 10335 files= 1 keys=name,description desclen=84
writing-skills lines= 399 bytes= 16738 files=10 keys=name,description desclen=97
total lines 3358 total bytes 143103
数えて分かったことは次の4つです。
- frontmatter は15個とも
nameとdescriptionの2項目だけです。Claude Code の公式ドキュメントにあるdisable-model-invocationやallowed-toolsは使っていないので、どのスキルも「Claude が自分の判断で読み込める」設定のままです。 - description の15個中14個が「Use when」で始まります。残りの1つ(brainstorming)は「You MUST use this before any creative work」で始まります。いつ使うかを先頭に書く形にそろえてあります。
- SKILL.md はすべて公式ドキュメントの目安(500行未満)に収まっています。長い資料は、同じフォルダーの別ファイルに分けてあります(diagnosing-superpowers は20ファイル、subagent-driven-development は15ファイル)。
- 15個の名前と description を合わせると2,630文字(英語)でした。公式ドキュメントによると、自分で呼ばれうるスキルの名前と description は毎回の会話の文脈に入るので、この文字数がいつも乗るぶんの目安になります(トークン数は測っていません)。
Superpowersのスキル一覧と働き
この節では、15個のスキルがそれぞれ何をするのかが、README の分類のとおりに分かります。
README の「Skills Library」は、スキルをテスト・デバッグ・共同作業・メタの4つに分けています。働きの欄は README と各 SKILL.md の記載を日本語にしたものです。
| 分類 | スキル | 働き | 呼ばれる場面(description) |
|---|---|---|---|
| テスト | test-driven-development | RED→GREEN→REFACTOR。失敗するテストを先に書く | 機能やバグ修正の実装の前 |
| デバッグ | systematic-debugging | 原因を突き止める4つの段階。直す前に原因を調べる | バグ・テスト失敗・想定外の動き |
| デバッグ | verification-before-completion | 完了と言う前に確かめるコマンドを実行し、出力を読む | 完了・修正・成功と言う直前 |
| デバッグ | diagnosing-superpowers | 会話の記録を読み、うまくいかなかった理由を証拠つきで報告する | Superpowers の動きがおかしいとき |
| 共同作業 | brainstorming | 作る前に、何をなぜ作りたいかを質問で引き出す | 新しいものを作る・動きを変える前 |
| 共同作業 | writing-plans | 実装の計画を、ファイルと確かめ方つきの小さな作業に分ける | 仕様があり、手順の多い作業の前 |
| 共同作業 | executing-plans | 計画を今の会話の中で実行し、最後に1回レビュー | 自分で計画を実行するとき |
| 共同作業 | subagent-driven-development | 作業ごとに新しいサブエージェントを出し、仕様と品質の2段階でレビュー | 独立した作業が並ぶ計画の実行 |
| 共同作業 | dispatching-parallel-agents | 依存のない作業をサブエージェントに並行で任せる | 独立した作業が2つ以上 |
| 共同作業 | requesting-code-review | 計画と照らしてレビューし、問題を重さで分けて報告 | 作業の区切り・マージの前 |
| 共同作業 | receiving-code-review | レビューの指摘を、うのみにせず技術的に確かめてから直す | レビューの指摘を受けたとき |
| 共同作業 | using-git-worktrees | 新しいブランチの作業場所を分け、テストが通る状態から始める | 機能の作業を始めるとき |
| 共同作業 | finishing-a-development-branch | テストを確かめ、マージ・PR・残す・捨てるを選ぶ | 実装が終わり、テストが通ったあと |
| メタ | writing-skills | 新しいスキルの作り方と試し方 | スキルを作る・直すとき |
| メタ | using-superpowers | スキルの探し方と使い方の入口。起動時に読み込まれる | 会話の始まり |
3つのスキルにある「鉄の決まり」
SKILL.md を読むと、3つのスキルが「The Iron Law」という見出しで、守る決まりを1行で書いています。
| スキル | 原文 | 意味 |
|---|---|---|
| test-driven-development | NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST | 失敗するテストを先に書かずに本番のコードを書かない |
| systematic-debugging | NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST | 原因を調べる前に直さない |
| verification-before-completion | NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE | 新しく確かめた証拠なしに完了と言わない |
systematic-debugging には「3回以上直して失敗したら、設計そのものを疑う」という手順もあります。これらは Markdown の指示としてモデルに渡されるもので、ツールが動作を物理的に止める仕組みではありません。
Superpowersの使い方:基本の流れ(brainstorming→計画→実装→レビュー)
この節では、入れたあと、ふだんの作業がどんな順番で進むのかが分かります。
使い方は、ふだんどおり Claude Code に頼むだけです。README の「The Basic Workflow」には、次の7つが順に動くと書かれています。
- 1brainstorming作る前に、何をなぜ作りたいかを質問で引き出し、理解したことを言い直して確かめる。小さな変更は会話で合意、規模の大きいものは設計書を書く
- 2using-git-worktrees設計の承認後、新しいブランチの作業場所を作り、準備をしてテストが通ることを確かめる
- 3writing-plans承認された設計を小さな作業に分ける。各作業にファイルのパスと確かめる手順が付く
- 4subagent-driven-development か executing-plans作業ごとに新しいサブエージェントを出して毎回レビューするか(いちばん丁寧)、今の会話で全部実装して最後に1回レビューするか(いちばん安い)
- 5test-driven-development実装中。失敗するテストを書き、失敗を見て、最小のコードで通し、コミットする
- 6requesting-code-review作業の合間に計画と照らしてレビューし、重い問題があれば先へ進まない
- 7finishing-a-development-branchテストを確かめ、マージ・PR・残す・捨てるの選択肢を出し、作業場所を片付ける
どこに何が残るか
SKILL.md を読むと、作られる文書の置き場所が決まっています。brainstorming の設計書はソフトウェアのリポジトリなら docs/superpowers/specs/ の下に日付とテーマの名前で作ってコミットし、writing-plans の計画は docs/superpowers/plans/ の下に置く、と書かれています。どちらも、利用者の希望があればそちらを優先する、とあります。
スキルを名前で呼ぶとき
自動で呼ばれるのを待たずに使いたいときは、スキルを名前で呼べます。Claude Code の公式ドキュメントによると、プラグインのスキルは /プラグイン名:スキル名 の形になるので、たとえば次のように打ちます。
/superpowers:brainstorming
/superpowers:systematic-debugging
公式ドキュメントによると、名前で呼ばなくても、頼んだ内容が description に合えば Claude が自動で読み込みます。どちらの呼ばれ方でも、使われるのは同じ SKILL.md です。
最初の5分でやること
- 試すリポジトリを1つ決める(業務のものではなく、消してもよい練習用が確実です)。
- 次の節の手順で、ユーザースコープかローカルスコープに入れる。
- 新しい会話で「小さな TODO リストのアプリを作りたい」のように頼む。README(Muse の節)は、正しく入っていればコードを書く前に brainstorming が動く、という確かめ方を書いています。
- 聞き返された質問に答え、出てきた設計と計画を読んでから「go」と言う。
Superpowersの入れ方(Claude Code)
この節では、Claude Code に Superpowers を入れる手順が、README と公式ドキュメントのコマンドのとおりに分かります。
README の「Claude Code」の節には、入れ方が2つ書かれています。1つは Anthropic の公式マーケットプレイスから入れる方法です。
/plugin install superpowers@claude-plugins-official
もう1つは、作者のマーケットプレイスを登録してから入れる方法です。
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
公式ドキュメント「Install and manage plugins」によると、セッションの中で /plugin install を打っても、すぐには入りません。次の流れになります。
Claude Code を起動してコマンドを打つ
プロジェクトのフォルダーで claude を起動し、上の /plugin install を打つ。/plugin の画面が、プラグインの詳細を開いた状態で出る。
詳細を読む
Will install の欄に、入るコマンド・エージェント・スキル・フック・MCP サーバーが並ぶ。公式マーケットプレイスのプラグインでは、Context cost(毎回乗るぶんと、呼ばれたときに乗るぶんのトークンの見積もり)も出る。
スコープを選ぶ
自分の全プロジェクト(user scope)、このリポジトリの全員(project scope)、このリポジトリの自分だけ(local scope)から選ぶ。
最後の1文を読む
「Plugin is now active.」ならそのまま使える。「Run /reload-plugins to apply.」なら再読み込みが要る。読み込みに失敗したら Errors タブで理由を見る。
入ったことを確かめる
/ を打って /superpowers: で始まる名前が出るかを見る。シェルで claude plugin list を実行すると、Version・Scope・Status が出る。
シェルから入れる(セッションを開かずに)
公式ドキュメントによると、Claude Code を起動しないで、ふつうのターミナルのコマンドとしても入れられます。既定は user scope で、--scope project か --scope local で変えられます。
claude plugin install superpowers@claude-plugins-official
claude plugin install superpowers@claude-plugins-official --scope local
公式マーケットプレイスは、対話のセッションを初めて起動したときに Claude Code が自動で登録します。一度も対話のセッションを開いていない新しいマシンで、スクリプトから入れるときは、先に claude plugin marketplace add anthropics/claude-plugins-official を実行する、と公式ドキュメントにあります。
デスクトップアプリと VS Code
公式ドキュメントでは、デスクトップアプリの Code タブでは入力欄の横の + から Add plugins(表示が Plugins なら Browse plugins)、VS Code の Claude Code のパネルでは /plugins で Manage plugins を開いて探す手順です。ターミナル・デスクトップアプリのローカルのセッション・VS Code は同じ設定ファイルを読むので、どれかで user scope に入れれば、ほかの2つでも使えます。claude.ai/code などのクラウドのセッションは、手元のマシンで入れたプラグインを読み込みません。
チームで使うとき
project scope で入れると、コミットする .claude/settings.json の enabledPlugins に記録されます。ただし公式ドキュメントによると、これはメンバーのマシンに自動で入れるものではなく、各自が一度 claude plugin install superpowers@claude-plugins-official --scope project を実行します。
公式マーケットプレイスと作者のマーケットプレイスの違い
この節では、2つの入れ方で何が違うのかを、それぞれの一覧ファイルを実際に読んで確かめた結果で分かります。
2つのマーケットプレイスの一覧(marketplace.json)を取得し、Superpowers の行を Python で取り出しました。
$ python3 -c "...claude-plugins-official の .claude-plugin/marketplace.json を読む..."
claude-plugins-official 317
{
"name": "superpowers",
"description": "Superpowers teaches Claude brainstorming, subagent driven development with built in code review, systematic debugging, and red/green TDD. Additionally, it teaches Claude how to author and test new skills.",
"category": "development",
"source": {
"source": "url",
"url": "https://github.com/obra/superpowers.git",
"sha": "22f0b463e7a5e579904dd6211a520321035526f7"
},
"homepage": "https://github.com/obra/superpowers.git"
}
$ python3 -c "...superpowers-marketplace の .claude-plugin/marketplace.json を読む..."
superpowers-marketplace 10
superpowers 7.0.2 {"source": "url", "url": "https://github.com/obra/superpowers.git"}
公式マーケットプレイスの Superpowers は、コミット 22f0b46 に固定されていました。これは手元で取得した v7.0.2 のコミットと同じです(2026年11月16日時点)。作者のマーケットプレイスの行にはコミットの固定がなく、版の欄が 7.0.2 でした。作者のマーケットプレイスには、Superpowers のほかに作者の別のプラグインが9つ並んでいます。
公式(claude-plugins-official)
Anthropic の公式の名前のマーケットプレイス。対話のセッションを初めて開くと自動で登録
取得元のコミットが一覧で固定されている
自動更新は既定でオン
詳細の画面に Context cost の見積もりが出る
作者(superpowers-marketplace)
公式ドキュメントの区分では第三者のマーケットプレイス。自分で登録する
一覧にコミットの固定がない
自動更新は既定でオフ
作者の関連プラグインも同じ一覧から入れられる
自動更新の既定は、公式ドキュメント「Keep plugins updated」の記載です。どちらから入れても、入るスキルの中身は同じリポジトリのものです。公式ドキュメントは、マーケットプレイスの名前は「誰が一覧を出しているか」を表すもので、各プラグインが何をするかを表すものではない、とも書いています。
Superpowersの確かめ方・更新・無効化・削除
この節では、入れたあとに状態を確かめる方法と、更新・一時停止・削除のコマンドが分かります。
公式ドキュメントに出ているコマンドをまとめます。claude plugin で始まるものはシェルで、/ で始まるものは Claude Code のセッションの中で打ちます。
| したいこと | シェル | セッションの中 |
|---|---|---|
| 入っているか・版を見る | claude plugin list |
/plugin の Installed タブ |
| 中身と毎回乗るトークンを見る | claude plugin details superpowers |
Installed タブで詳細を開く |
| 一時的に止める | claude plugin disable(名前@マーケットプレイス) |
Installed タブで Space |
| また使う | claude plugin enable(同上) |
Installed タブで Space |
| 今すぐ更新する | claude plugin update(同上) |
詳細の Update now |
| 削除する | claude plugin uninstall(同上) |
詳細の Uninstall か /plugin uninstall |
| 変更を今の会話に反映 | (次の起動で反映) | /reload-plugins |
公式ドキュメントによると、claude plugin details の Always-on の行は、そのプラグインが有効なセッションに毎回足されるトークン数です。入れたあとに重さが気になったら、ここで確かめます。削除したあとも、取得したファイルは ~/.claude/plugins/cache/ の下に14日残り、そのあと自動で片付けられる、と書かれています。
更新の追い方
公式マーケットプレイスから入れた場合は自動更新が既定でオンなので、一覧のコミットが新しくなると手元も更新されます。公式ドキュメントによると、動いているセッションは読み込んだ版のまま使い続け、「Plugin updated: <name> · Run /reload-plugins to apply」と表示され、次のセッションから新しい版になります。作者のマーケットプレイスは既定でオフなので、/plugin の Marketplaces タブで自動更新をオンにするか、自分で claude plugin update を実行します。
何が変わったかは、リポジトリの RELEASE-NOTES.md に版ごとに書かれています。書かれている版と日付を Python で数えた結果です。
releases 47 from 2025-10-12 to 2026-11-03
releases in last 12 months (since 2025-11-16): 34
major 2 2 2025-10-12 2025-10-12
major 3 14 2025-10-16 2025-12-03
major 4 9 2025-12-17 2026-02-21
major 5 9 2026-03-09 2026-04-30
major 6 10 2026-06-16 2026-09-25
major 7 3 2026-10-09 2026-11-03
median gap days 4 max gap 47
1年余りで47の版があり、版と版の間は中央値で4日でした。更新が速いので、解説記事(この記事を含む)と手元の版が違うことがよくあります。手元の版は claude plugin list で確かめ、その版の RELEASE-NOTES.md を読むのが確実です。
Superpowersが自動で動く仕組み:SessionStartフック
この節では、コマンドを打たなくてもスキルが使われる理由が、フックの設定ファイルと読み込まれる文章の長さで分かります。
リポジトリの hooks/hooks.json には、フックが1つだけ書かれています。
{
"hooks": {
"SessionStart": [
{
"matcher": "startup|clear|compact",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
"powershell": "& \"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
"shell": "bash",
"async": false
}
]
}
]
}
}
セッションの開始(startup)、/clear のあと(clear)、会話の圧縮のあと(compact)に、hooks/session-start というシェルスクリプトが動きます。スクリプトを読むと、やっていることは次の3つです。
skills/using-superpowers/SKILL.mdを読む。- その全文を「You have superpowers.」で始まる文章で包み、JSON の文字列にする。
- Claude Code のときは
hookSpecificOutput.additionalContextという形で出力し、会話の文脈に足させる(Cursor・Copilot CLI など別のツールでは出力の形を変える)。
スクリプトのコメントには、外部のコマンドや子プロセスを起動しない作りにしてあると書かれていて、ネットワークに接続する処理はありませんでした。このスクリプトを手元で実行することは権限で拒否されたため、同じ組み立てを自作の Python で再現して長さを数えました。
import pathlib
root = pathlib.Path('superpowers')
sk = (root / 'skills/using-superpowers/SKILL.md').read_text(encoding='utf-8').rstrip('\n')
wrap = ("<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your "
"'superpowers:using-superpowers' skill - your introduction to using skills. "
"For all other skills, use the 'Skill' tool:**\n\n" + sk + "\n</EXTREMELY_IMPORTANT>")
print('bootstrap chars', len(wrap), 'skill chars', len(sk), 'lines', len(wrap.splitlines()))
bootstrap chars 3405 skill chars 3179 lines 71
起動のたびに、英語で約3,400文字(71行)の指示が会話に足される計算です。この指示(using-superpowers)は「少しでも当てはまる可能性があるスキルは必ず呼ぶ」「質問を返す前にもスキルを確かめる」と書いています。Superpowers がふだんの頼み方のままで働くのは、この指示が毎回最初に入るからです。
一方で、同じ指示の中には「CLAUDE.md・AGENTS.md などの利用者の指示や直接の依頼は、スキルより優先する」とも書かれています。チームの決まりを CLAUDE.md に書いておけば、そちらが先に効く作りです。フックそのものの仕組みは、関連記事「Claude Code Hooksの使い方|全33イベント表と設定例・止め方」で扱っています。
スキルの仕組み:SKILL.mdとfrontmatter
この節では、Superpowers の中身である「スキル」が Claude Code の中でどう読み込まれるのかが、公式ドキュメントの記載で分かります。
Claude Code の公式ドキュメント「Skills」によると、スキルは SKILL.md というファイルに書いた指示で、Claude は関係があるときに使い、利用者は /スキル名 で直接呼べます。置き場所は3つあります。
| 置き場所 | パス | 使える範囲 |
|---|---|---|
| 個人 | ~/.claude/skills/(スキル名)/SKILL.md |
このマシンの全プロジェクト |
| プロジェクト | .claude/skills/(スキル名)/SKILL.md |
このリポジトリ。コミットすればチームでも |
| プラグイン | (プラグイン)/skills/(スキル名)/SKILL.md |
プラグインが有効なところ。/プラグイン名:スキル名 |
Superpowers は3つ目の「プラグイン」の形です。公式ドキュメントによると、ふだんの会話では各スキルの description だけが文脈に入り、本文はそのスキルが呼ばれたときに初めて読み込まれます。description と when_to_use を合わせた文字は、一覧では1,536文字で切られます。Superpowers の description は最長でも375文字(diagnosing-superpowers)で、この上限の中に収まっていました。
Superpowers の SKILL.md の先頭は、たとえば次のようになっています(using-superpowers)。
---
name: using-superpowers
description: Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions
---
自分でスキルを書くときの項目の一覧と雛形は、関連記事「Claude Code Skillsの作り方|SKILL.md雛形と項目一覧」で、用途別の書き方の例は関連記事「Claude CodeのSkillsの書き方|テンプレ7選」で扱っています。Superpowers の writing-skills は、スキルを作る前に「スキルがないとエージェントがどう失敗するか」を試してから書く、という手順を勧めています。
プラグインとスキル単体の違い
公式ドキュメント「Plugins」によると、スキル・サブエージェント・フック・MCP サーバーはプラグインにしなくても使えます。プラグインは、それらを1つにまとめて配り、マーケットプレイスから更新を受け取るための形です。Superpowers が「スキル集」でありながらプラグインとして配られているのは、15個のスキルに加えて SessionStart フックも一緒に入れる必要があるからです。
Superpowersの版の変化と、以前の解説との違い
この節では、以前の解説記事のとおりに打っても動かないコマンドがある理由と、主な変更点が分かります。
RELEASE-NOTES.md から、使い方に関わる変更を拾いました。
| 版(日付) | 変わったこと | 以前の解説との違い |
|---|---|---|
| v5.0.0(2026-03-09) | /brainstorm・/write-plan・/execute-plan を非推奨にし、スキルを案内する表示に | コマンドは表示だけになった |
| v5.1.0(2026-04-30) | 上の3つのコマンドを削除。code-reviewer という名前のエージェントも削除 | スキル名で呼ぶ。レビューは requesting-code-review の中のひな形に |
| v6.4.1(2026-09-18) | diagnosing-superpowers が加わり15個に。executing-plans を安く済む実行の形に作り直し | 「14個」と書いた記事は以前の版 |
| v7.0.0(2026-10-09) | brainstorming の作り直し | 質問の仕方が変わった |
| v7.0.2(2026-11-03) | brainstorming の質問を減らし、理由を先に聞く。フックが子プロセスを起動しない作りに | この記事で数えた版 |
v5.1.0 の記載には「Invoke superpowers:brainstorming, superpowers:executing-plans, and superpowers:writing-plans directly instead.」とあり、コマンドの代わりにスキルを直接呼ぶよう案内しています。Cursor 向けの設定からも、agents と commands の項目が「those directories no longer exist」として外されました。v7.0.2 のリポジトリには commands/ と agents/ のフォルダーがありません。
もう1つ、README と SKILL.md で書き方が少し違うところがありました。README は writing-plans を「2〜5分ずつの小さな作業に分ける」と書いていますが、v7.0.2 の SKILL.md は作業を「自分のテストの1周を持ち、新しいレビュー担当が通すか止めるかを判断できる最小の単位」と定義していて、分数の目安は書いていません。動きの細かいところは、README より SKILL.md の本文を読むのが確実です。
Superpowersを使う前に読むところ
この節では、第三者のプラグインである Superpowers を入れる前に、どのファイルを読めばよいかが分かります。
Superpowers は Anthropic ではなく、作者 Jesse Vincent さんと Prime Radiant の人たちが作っているプラグインです(README の「Community」)。公式マーケットプレイスに載っていても、作っているのは第三者です。Claude Code の公式ドキュメント「Plugin security and trust」は、入れる前の画面に、どのマーケットプレイスのプラグインでも同じ次の注意が出ると書いています。
Make sure you trust a plugin before installing, updating, or using it. Anthropic does not control what MCP servers, files, or other software are included in plugins and cannot verify that they will work as intended or that they won't change. See each plugin's homepage for more information.
同じページは、プラグインのフックは利用者の権限のまま、サンドボックスの外で動くこと、スキルは Claude への指示として文脈に入ること、自動更新がオンなら読んだファイルが手元で入れ替わることを挙げています。この記事も、Superpowers の安全性や動きを保証するものではありません。リポジトリを取得して、次の順で読むのが確実です。
- 1hooks/hooks.json何がいつ動くか。v7.0.2 は SessionStart の1つだけで、hooks/session-start を動かす
- 2実行されるスクリプトhooks の下の2つと、skills の下で実行の許可が付いた10ファイル(brainstorming・executing-plans・subagent-driven-development の補助スクリプトなど)
- 3各 SKILL.mdClaude にどんな指示が入るか。合計3,358行。少なくとも using-superpowers(65行)は毎回入る
- 4外への接続skills と hooks の中に出てくる接続先。brainstorming の画面の機能と diagnosing-superpowers の報告づくりを読む
- 5規約と所属先の決まり業務のコードや機密情報・個人情報を扱うリポジトリで使うなら、Anthropic と作者の最新の説明と、所属先の決まりを事前に確かめる
4つ目について、skills と hooks のファイルに出てくるホスト名を Python で抜き出すと、github.com・api.github.com・code.claude.com・platform.claude.com・primeradiant.com・localhost などでした。README の「Visual companion telemetry」によると、brainstorming の画面の機能(任意で使うもの)は作者のサイトからロゴを読み込み、そのとき Superpowers の版が伝わります。README は、プロジェクトの中身やプロンプトは含まれないと説明し、環境変数 SUPERPOWERS_DISABLE_TELEMETRY に真の値を入れると止まり、Claude Code の DISABLE_TELEMETRY と CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC にも従う、と書いています。
公式ドキュメントは、取得したリポジトリに対して claude --plugin-dir(プラグインのフォルダー) plugin details superpowers を実行すると、セッションを始めずに中身の一覧(Component inventory)を出せる、とも書いています。
ライセンスと料金
リポジトリの LICENSE は MIT License で、「Copyright (c) 2025 Jesse Vincent」と書かれています。プラグインそのものに料金はかかりませんが、スキルの文章やサブエージェントの実行は Claude Code の利用量に数えられます。README は、subagent-driven-development を「いちばん丁寧」、executing-plans を「いちばん安い」と書き分けています。料金の仕組みは Claude のプランごとに違うので、Anthropic の最新の説明で確かめます。README には、企業向けの有償の支援の窓口があることも書かれています。
サブエージェントの使い方とコンテキストの節約は、関連記事「Claude Codeサブエージェントの使い方|実測で見る委任とコンテキスト節約」で、using-git-worktrees が使う git worktree の並列作業は、関連記事「Claude Code×git worktree並列開発|設定例と衝突対策表」で扱っています。
Superpowersのよくあるつまずき
この節では、入れたのに動かない・思った動きにならないときの原因と直し方が分かります。
| 症状 | 原因 | 直し方 |
|---|---|---|
/brainstorm が見つからない |
v5.1.0 でコマンドが削除された | /superpowers:brainstorming か、頼み方の中でスキル名を出す |
入れたのに /superpowers: が出ない |
再読み込みが済んでいない | /reload-plugins。直らなければ /plugin の Errors タブ |
superpowers@superpowers-marketplace で入らない |
作者のマーケットプレイスを登録していない | 先に /plugin marketplace add obra/superpowers-marketplace |
| claude.ai/code で使えない | クラウドのセッションは手元のプラグインを読まない | 手元のターミナル・デスクトップアプリ・VS Code で使う |
claude -p で /plugin が使えない |
対話でない実行では /plugin は動かない |
シェルの claude plugin install で入れる(入れたものは読み込まれる) |
| 長い会話の途中からスキルが呼ばれない | 動きのずれ。版によって直し方が違う | 「what went wrong with superpowers」と頼み、diagnosing-superpowers に調べさせる |
| 解説記事と画面が違う | 版の更新が速い(中央値4日おき) | claude plugin list で版を見て、その版の RELEASE-NOTES.md を読む |
表示の原文が公式ドキュメントに載っているものは次のとおりです(このマシンでは Claude Code を動かしていないので、出力を手元で再現したものではありません)。
/plugin isn't available in this environment.
Plugin is now active.
Run /reload-plugins to apply.
The plugin couldn't be loaded
業務のリポジトリでいきなり試す
理由:有効なプラグインは、使っていないセッションでも文脈とフックに関わる(公式ドキュメント)
小さな修正でも全部の手順を求める
理由:brainstorming の SKILL.md は、作業の大きさで設計書の重さを変えると書いている
判断表:Superpowersを入れるか・どの入れ方にするか
この節では、自分の状況で入れるかどうか、どのマーケットプレイスとスコープを選ぶかが分かります。
| 状況 | おすすめ | 理由 |
|---|---|---|
| まず試したい | 公式マーケットプレイスから local scope | 練習用のリポジトリだけで動き、Context cost も見られる |
| 全プロジェクトで使いたい | 公式マーケットプレイスから user scope | コミットが固定され、自動更新が既定でオン |
| 作者の関連プラグインも使う | 作者のマーケットプレイス | 同じ一覧から入る。自動更新は自分でオンにする |
| チームの進め方をそろえたい | project scope と CLAUDE.md | 各自が1回入れる。チームの決まりは CLAUDE.md が先に効く |
| 設計から実装まで数時間任せる | subagent-driven-development | 作業ごとにレビューが入る。そのぶん利用量は多い |
| 利用量を抑えたい | executing-plans か一時的に disable | レビューは最後の1回。README の「いちばん安い」 |
| 使い捨てのスクリプトや1行の修正 | 入れない・止める | 手順の重さが作業に見合いにくい |
| 自分のスキルを作りたい | writing-skills を読む | 入れなくてもリポジトリで読める |
Claude Code そのものの導入と基本のコマンドは、関連記事「Claude Code 使い方|最初の30分と113コマンド【2026年11月】」で扱っています。
Superpowersについてよくある質問
Q. Superpowersとは何ですか? A. Claude Code などのコーディングエージェントに、設計の聞き取り・計画・テスト駆動開発・原因を調べるデバッグ・完了前の確認・レビューといった開発の進め方を覚えさせる、15個のスキルとフックをまとめたプラグインです。
Q. Anthropic が作ったものですか? A. いいえ。作者は Jesse Vincent さん(Prime Radiant)で、GitHub の obra/superpowers で公開されています。Anthropic の公式マーケットプレイスにも載っていますが、作っているのは第三者です。
Q. 無料で使えますか? A. MIT ライセンスで公開されていて、プラグインに料金はかかりません。ただし、スキルの文章やサブエージェントの実行は Claude Code の利用量に数えられます。
Q. 入れたあと、何かコマンドを打つ必要がありますか?
A. ありません。起動時のフックが using-superpowers の指示を会話に入れ、頼み方に合うスキルが自動で呼ばれます。名前で呼びたいときは /superpowers:brainstorming のように打ちます。
Q. スキルはいくつありますか? A. v7.0.2 で15個です。リポジトリを取得して数えると、SKILL.md の合計は3,358行でした。版によって数が変わるので、手元の版の skills フォルダーで確かめるのが確実です。
Q. /brainstorm や /write-plan が動きません。 A. v5.1.0(2026年4月30日)で削除されました。スキル名で呼ぶか、頼み方の中で brainstorming や writing-plans を使うよう伝えます。
Q. 公式マーケットプレイスと作者のマーケットプレイスは、どちらから入れればよいですか? A. 入るスキルは同じリポジトリのものです。公式はコミットが固定され自動更新が既定でオン、作者の方は固定がなく自動更新が既定でオフです。作者の関連プラグインも使うなら作者の方、それ以外は公式から入れるのが手間がかかりません。
Q. Claude Code 以外でも使えますか? A. README には Claude Code を含めて、Codex・Cursor・Gemini CLI・GitHub Copilot CLI・OpenCode など16のツールの入れ方が書かれています(2026年11月16日時点)。入れ方はツールごとに違い、複数のツールで使うならそれぞれに入れます。
Q. 一時的に止めるには?
A. /plugin の Installed タブで Space を押すか、シェルで claude plugin disable superpowers@claude-plugins-official を実行します。消さずに止められます。
Q. 入れる前に何を読めばよいですか?
A. hooks/hooks.json(何がいつ動くか)、hooks/session-start(起動時に何を入れるか)、各 SKILL.md(どんな指示が入るか)です。claude --plugin-dir と plugin details で中身の一覧も出せます。
まとめ
- Superpowers は、開発の進め方を教える15個のスキルと SessionStart フックをまとめたプラグインで、作者は Jesse Vincent さん。MIT ライセンスで公開されています。
- Claude Code では
/plugin install superpowers@claude-plugins-officialで入ります。公式マーケットプレイスの登録は v7.0.2 のコミットに固定されていました(2026年11月16日時点)。 - 使い方はふだんどおり頼むだけ。brainstorming → worktree → 計画 → 実装(TDD)→ レビュー → 仕上げ、の順に自動で進みます。
- 自動で動くのは、起動・
/clear・圧縮のたびに約3,400文字の using-superpowers が会話に入るからです。チームの決まりは CLAUDE.md が優先されます。 - 版の更新が速い(47版、中央値4日おき)ので、
claude plugin listで版を見て RELEASE-NOTES.md を読み、入れる前には hooks と SKILL.md を読んで確かめるのが確実です。
参考・出典
いずれも2026年11月16日に確認しました。
- obra/superpowers(README.md・RELEASE-NOTES.md・LICENSE・hooks/hooks.json・hooks/session-start・skills/*/SKILL.md。v7.0.2、コミット 22f0b46) https://github.com/obra/superpowers
- obra/superpowers-marketplace(.claude-plugin/marketplace.json) https://github.com/obra/superpowers-marketplace
- anthropics/claude-plugins-official(.claude-plugin/marketplace.json) https://github.com/anthropics/claude-plugins-official
- Claude 公式のプラグインの紹介ページ「Superpowers」 https://claude.com/plugins/superpowers
- Claude Code 公式ドキュメント「Plugins overview」 https://code.claude.com/docs/en/plugins
- Claude Code 公式ドキュメント「Install and manage plugins」 https://code.claude.com/docs/en/plugins/install
- Claude Code 公式ドキュメント「Skills」 https://code.claude.com/docs/en/skills
- Claude Code 公式ドキュメント「Plugin security and trust」 https://code.claude.com/docs/en/plugins/security
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Superpowersとは|Claude Codeのスキル集の入れ方・使い方と中身」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。