★29万のスキル集「superpowers」を入れたら、最初の仕事で言うことを聞かなかった話

Claude Codeのスキルで一番有名なものを1つ挙げろと言われたら、たぶんこれです。Jesse Vincentさんが作った「superpowers」。2026年9月26日に測ったら、GitHubの★は291,797でした。

実はこのMacにも入っています。バージョンは6.4.2。なので今回は、読んだだけの紹介ではなく、入れている環境で中身を開きながら書きます。

ひとことで言うと、AIに「いきなりコードを書かせない」ための手順書の束です。中に入っているスキルは15個。READMEには、提案ではなく必須の手順だ、とまで書いてあります。

流れはこうなっています。

ほかに、原因を調べ切るまで直させない systematic-debugging、証拠なしに「できました」と言わせない verification-before-completion、スキル作りそのものをテストから始める writing-skills などがあります。

読んでいて面白いのは、ルールが全部大文字で書いてあるところ。TDDのスキルには「失敗するテストより先に本番のコードを書くな」とあって、先に書いてしまったら消してやり直せ、と続きます。デバッグのスキルは「原因を調べる前に直すな」。直そうとして3回失敗したら、それは設計の問題だ、とも書いてある。

レビューを受ける側のスキルには、言ってはいけない言葉として「おっしゃる通りです!」が挙がっていました。口先だけで同意するな、ということですね。AIに何度もこれを言われて、直っていなかった経験がある人は多いんじゃないでしょうか。

この一文があるのは、AIが「今回は小さい変更なので」と理屈をつけて手順を飛ばすのを先回りして塞ぐためだと思います。

15個全部を毎回読ませていたら、それだけで会話の容量が埋まってしまいます。そこでどうしているのか、入っているファイルを見てみました。

仕掛けはフックでした。Claude Codeを起動したとき、/clear したとき、会話を圧縮したときの3回、入口のスキル using-superpowers だけを会話に差し込みます。サイズは3,192バイト。15個のSKILL.mdを全部足すと170,125バイトあるので、毎回入るのは2%に満たない量です。

残りは、必要になったときに呼ばれます。一番大きい brainstorming は1つで17,548バイトありました。

ここからは自分の話です。

この連載の入口になる/skillsのページを作ったとき、superpowersは「何か作るなら、まず brainstorming を使え」と差し込んできました。可能性が1%でもあるならスキルを使え、という書き方です。

でも、うちのClaude Codeには先に書いてある決まりがあります。既にあるサイトの小さな追加なら、いちいち相談せずに最後までやる。富村はそのほうが楽なので。

結局、ブレストは飛ばしました。superpowers自身にも「ユーザーの指示はスキルより優先」と書いてあるので、ルール違反ではないはずです。ただ、入れるだけで全部の仕事が相談から始まるわけではない、というのは覚えておいたほうがいいと思います。自分の決まりとぶつかったときにどちらが勝つかは、書いてある場所と書き方で決まる。

GitHubのIssueを見ると、一番多い不満はトークンでした。Codexで比較的単純な計画をサブエージェントで回したら、5時間ぶんの利用枠を1回で使い切った、という報告があります（#1152）。レビュー役の報告が長すぎるという声も。

サブエージェント方式は、タスクごとに新しいAIを立ててレビューまでさせるので、当然そうなります。作者もREADMEで、思ったよりトークンを使う場合がある、と認めていて、原因を調べる diagnosing-superpowers というスキルを足していました。

それぞれの役に「こなせる中で一番弱いモデルを使え」と書いてあるのも、この対策なんでしょう。

superpowersが合わなかった人、もう少し軽いものが欲しい人向けに、同じ系統のものも並べておきます。★は全部9月26日の数字です。

superpowersを入れたのは、この記事を書いた日の朝です。まだサブエージェント方式で大きな機能を1本作りきってはいません。トークンがどれくらい増えるのかは、自分の環境の数字が取れたら書きます。

もう1つ、「必須の手順」を強くしすぎると、1行直すだけの仕事まで重くなる気がしています。superpowersは依頼を大きさで3つに分けて、小さいものは短い設計で済ませるようにしているんですが、それがどこまで効くのかはまだ分かりません。

次は、2位の mattpocock/skills から、一番入れられている grill-me を取り上げます。superpowersの brainstorming と何が違うのかも比べます。紹介したスキル集は記事の下にまとめました。ほかの記事はAIに入れる便利なSkillsとブログにあります。

試してほしいスキルがあれば、お問い合わせから教えてください。