using-superpowers

using-superpowers skill の概要

using-superpowers skill が実際にすること

using-superpowers skill は、obra/superpowers リポジトリにあるセッション開始時向けの制御用 skill です。主な役割は、特定のドメイン作業を直接こなすことではありません。返答する前、さらには確認質問をする前に、エージェントが関連する skill を必ず確認するよう促すことです。実運用では、「ベースモデルのままその場で答える」状態を、「まず適切な skill を探し、それから進める」流れに切り替えるための skill と考えると分かりやすいです。

using-superpowers に向いているケース

この skill は、Claude Code、Gemini CLI、そのほか skill 有効化に対応した環境で、skill ファーストの運用をしたいユーザーに特に向いています。複数の skill を入れていて、発見漏れを減らしたい、指示の振り分けを安定させたい、専門的なワークフローをエージェントが忘れにくくしたい、という場合にとくに有効です。

実際に解決したい仕事

using-superpowers の本質的な用途は、ガバナンスと一貫性の確保です。少しでも適合の可能性があるなら、skill の探索を必須として扱わせたいときに効きます。もし悩みが「使える skill があるのに、アシスタントが無視して自己流で進めてしまう」ことなら、using-superpowers はそこを正面から改善します。

なぜ users が導入するのか

多くの users が using-superpowers を導入前に気にするのは、主に次の3点です。

1. skill の見落としは減るか
2. 自分の repo 内の指示と衝突しないか
3. 今のツール環境で動くか

この3点に対して、using-superpowers はかなり明快です。ユーザー指示が最優先であることをはっきり示しており、Claude 系ツール、Codex 系ツール、Gemini CLI それぞれに向けたプラットフォーム対応の参照情報も含まれています。

汎用プロンプトとの主な違い

using-superpowers は、よくある「必要に応じてツールを使ってください」という曖昧なプロンプトとは違い、ルールが明示的で厳格です。「少しでも skill が当てはまる可能性があるなら、必ず呼び出す」という強い規則が定義されています。さらに、指示の優先順位や環境ごとの有効化手順まで書かれているため、単なる注意書きではなく、運用ルールとして機能します。

最初に知っておきたい制約

using-superpowers が価値を持つのは、前提として使っている環境が skills、またはそれに相当する有効化メカニズムをサポートしている場合だけです。また、この skill には subagent 向けの停止条件も含まれているため、対象はあくまでメインのセッションであり、委譲されたすべてのタスクではありません。skill を使う前提のワークフローでなければ、得られるのは機能というよりポリシーです。

using-superpowers skill の使い方

using-superpowers の導入コンテキスト

このリポジトリ抜粋では、skill 内にインストール用コマンドは公開されていません。そのため、obra/superpowers リポジトリに対する自分の skill manager、またはプラットフォーム固有の skill セットアップ手順を使い、skills/using-superpowers にある using-superpowers skill を選んで導入してください。

もし利用中のツールが repo ベースのインストール構文に対応しているなら、外部サイトの例をそのまま使う前に、必ず自分の環境の公式ドキュメントで正確なコマンドを確認してください。重要なのは、skill のパスが https://github.com/obra/superpowers 内の using-superpowers であることです。

ワークフローのどこで using-superpowers を使うべきか

using-superpowers は、会話やセッションの冒頭で使うのが基本です。すでに深く進行している作業の途中から差し込むものではありません。目的は、エージェントがツールを選んだり、質問したり、作業計画を立てたりする前に、挙動を先に整えることにあります。

考え方としては次の順番です。

• まず using-superpowers を有効化する
• 次にやりたい作業を伝える
• その後、エージェントに適切なより具体的な skill を見つけて呼び出させる

実際の using-superpowers の呼び出し方

リポジトリには、想定される有効化方法が明確に書かれています。

• Claude Code では Skill ツールを使う
• Gemini CLI では activate_skill を使う
• Codex 系の環境では、skill の指示に沿ってネイティブに扱い、同梱の参照マッピングで相当機能を確認する

プラットフォームが skill の有効化をサポートしている場合、skill ファイルをただのテキストとして読むだけで済ませないでください。この skill 自体が、正しい skill 機構を通じて呼び出すよう明示しています。

using-superpowers に必要な入力

この skill 自体に必要な入力は多くありません。重要なのは、有効化した直後に与えるタスク内容です。弱い入力は、広すぎて輪郭がありません。

• “Help with my codebase”

より強い入力は、skill 発見に必要な形が揃っています。

• “I need to review a Python PR for correctness, find risky changes, and suggest follow-up tests.”
• “I want to implement a feature in this repo using the project’s conventions and existing agent workflow.”
• “Help me decide which superpowers skill applies to debugging a flaky CLI integration test.”

目的、対象物、実行環境が具体的であるほど、その後の skill 選択の精度は上がります。

粗い目標を、よりよい using-superpowers prompt に変える

実用的な using-superpowers usage の型は次のとおりです。

1. タスクを述べる
2. 関係する repo やファイルを挙げる
3. 制約を書く
4. 先に適合する skill を見つけて使うようエージェントに求める

例:

Activate using-superpowers. I need to refactor src/auth/session.ts, preserve public behavior, avoid new dependencies, and follow this repo’s conventions. Check for any applicable skills before proposing changes.

この形が効く理由は、skill 発見の段階で、ただの一般的なコーディング応答ではなく、もっと適切で具体的な skill を選べるだけの文脈が入るからです。

先に読むべき repository files

using-superpowers for Skill Discovery を見極めたいなら、まず次のファイルから読むのがおすすめです。

1. skills/using-superpowers/SKILL.md
2. skills/using-superpowers/references/codex-tools.md
3. skills/using-superpowers/references/gemini-tools.md

この順番で読むと、導入判断に必要な要点を短時間で押さえられます。最初に中核ルール、次に指示の優先順位、最後にプラットフォーム互換性を確認できます。

SKILL.md で特に見るべきポイント

SKILL.md では、次の4点に注目してください。

• セッション開始時に使うという要件
• 「1% でも skill が当てはまりそうなら適用する」というルール
• 指示の優先順位
• プラットフォーム別のアクセス案内

これらは、エージェントの挙動に実質的な影響を与える部分です。using-superpowers が自分の運用にとって有用か、強すぎるか、あるいは環境に適合するかを判断する材料になります。

プラットフォーム適応のガイダンス

references フォルダは見た目以上に重要です。Claude Code 前提のツール名を、ほかの環境でどう読み替えるかが整理されています。

• references/codex-tools.md では、Task を spawn_agent、TodoWrite を update_plan に対応づけることや、名前付き agent registry がない点などを説明しています
• references/gemini-tools.md では、Skill を activate_skill に対応づけ、Gemini CLI には subagent サポートがないことも明記しています

Claude Code 以外で使う場合、これらのファイルがあるかどうかで、「面白い repo」で終わるか、「実際に使える workflow」になるかが変わります。

有効化後におすすめの進め方

実用的な using-superpowers guide は、次の流れです。

1. using-superpowers を有効化する
2. ファイル、制約、完了条件を含む具体的なタスクを渡す
3. エージェントに適用可能な専門 skill を特定させる
4. 実行フェーズでは、その専門 skill に従って進める
5. 競合しそうな点があれば、AGENTS.md、CLAUDE.md、GEMINI.md といったユーザー側の高優先度指示を再確認する

この流れなら、using-superpowers を本来の役割、つまり最終実行役ではなくルーティングの入口として使えます。

導入前に把握したいトレードオフと制約

最大のトレードオフは厳格さです。using-superpowers は一貫性を高めますが、使う skill が1〜2個しかない場合や、もっと緩い会話型の探索を好む場合には、ワークフローがやや重く感じられることがあります。また、この skill には明確な思想があり、確認質問より前に skill 呼び出しを優先させるため、人によっては硬すぎると感じるかもしれません。

最大の制約は、エコシステム側の成熟度です。利用環境の skill サポートがまだ弱い場合、ポリシーの明快さに対して、実行経路が追いつかないことがあります。

using-superpowers skill の FAQ

skills を少ししか使わない場合でも using-superpowers を入れる価値はある？

たいていはあります。数が少なくても、その few skills が重要で、確実に使わせたいなら導入価値は高いです。逆に、もともと手動での呼び忘れがほとんどないなら、恩恵はやや小さめです。特に効果が大きいのは、skill の発見漏れが出力品質の低下やワークフローのばらつきにつながっているケースです。

using-superpowers は初心者向け？

はい。注意点が1つだけあります。初心者にとって「まず skill を確認する」という強いデフォルトは助けになりますが、同時に、自分のプラットフォームで skill をどう有効化するかは理解しておく必要があります。その点では、特に Gemini CLI や Codex 系環境向けの reference files が役立ちます。

using-superpowers は project instructions を上書きする？

いいえ。skill には、ユーザー指示が superpowers skills より優先されると明記されています。superpowers skills が上書きするのは、あくまでデフォルトのシステム挙動だけです。repo レベルの指示で特定の workflow を使わないよう定められているなら、そちらの高優先度指示が優先されます。

どんなときは using-superpowers を使わないほうがいい？

次のような場合は見送って構いません。

• 利用環境で skills のサポートが弱い
• skill エコシステムを使わない単発の素早いやり取りをしたい
• 狭い委譲タスクを担当する subagent として動いている。using-superpowers には subagent 停止指示が含まれているためです

model に「skills を使って」と言うだけの場合と using-superpowers はどう違う？

違いは、強制力と明確さです。普通のプロンプトは提案にとどまりますが、using-superpowers は優先順位の扱いとプラットフォーム注意点まで含んだ、構造化された運用ルールです。そのため、繰り返し使ったときの安定性が高くなります。

using-superpowers は Skill Discovery 用として本当に機能する？

はい。むしろそこが中核的な価値です。using-superpowers for Skill Discovery が特に効くのは、skills のライブラリが増えていて、発見を「やってもよい」ではなく「必ずやる」扱いにしたい場面です。

using-superpowers skill を改善するには

using-superpowers を有効化した直後のタスクの切り出し方を改善する

品質を最も左右するのは、有効化そのものではなく、その直後に送る最初のタスクメッセージです。次の要素を入れてください。

• 正確な目的
• 関係するファイルやディレクトリ
• 制約条件
• 希望する進め方
• 完了の定義

こうした情報があると、曖昧な依頼よりも skill のマッチング精度が大きく上がります。

よくある失敗: 目標が曖昧だと skill 選択も弱くなる

“help me with this repo” のように言うと、skill 自体は見つかるかもしれませんが、どれを選ぶのが最適か判断材料が足りません。曖昧な依頼ではなく、タスクの形になった依頼へ置き換えてください。たとえば次のような形です。

• “Find the right skill for reviewing a risky migration diff”
• “Use any relevant superpowers skill before proposing a plan to debug CI failures”
• “Determine whether this task fits a planning, implementation, or review skill”

よくある失敗: プラットフォームの読み違い

導入時によくあるつまずきは、Claude 系のツール名を別環境で文字どおりに解釈してしまうことです。skill の良し悪しを判断する前に、まず自分の環境に対応する reference file を確認してください。Codex なら references/codex-tools.md、Gemini CLI なら references/gemini-tools.md から読むのが適切です。

repo レベルの instructions と組み合わせて using-superpowers を改善する

using-superpowers は、repo 側に AGENTS.md、CLAUDE.md、GEMINI.md などの明確で優先度の高い指示があると、よりうまく機能します。この skill はそれらのファイルを尊重するため、ローカルの指針が整理されているほど衝突が減り、発見された skill の適用精度も上がります。

using-superpowers は最終手段ではなくルーティング層として使う

ありがちな誤解は、using-superpowers skill の中に実行の詳細まで全部入っていると期待することです。実際には、これは superpowers エコシステム全体へ振り分けるためのルーターとして見るのが適切です。より良い結果を求めるなら、有効化しただけで止まらず、その先の具体的な downstream skill と組み合わせて使ってください。

最初の応答後に改善をかける

最初の返答で、関連 skill の特定や呼び出しが明確でない場合でも、すぐにワークフローを捨てないでください。まずはプロンプトを締め直します。追加すると効果が出やすいのは次の情報です。

• 具体的に操作したい artifact
• 必要な作業の種類
• 重要な制約
• 進める前に適用可能な skills を確認するよう明示する指示

これだけでも、skill discovery と実行品質の両方が改善することがよくあります。