Writing Skills Skill

Writing Skills は Superpowers のメタスキルです（スキルのソース）。新しいスキルを作るとき、既存のスキルを編集するとき、配布前にスキルが機能するか確かめるときに使い、中心となる考えは「スキルを書くことは、プロセス文書に適用したテスト駆動開発である」です。Superpowers の貢献ガイドは、スキルの変更すべてにこれを求めています。

鉄則は TDD と同じく「失敗するテストなしにスキルを書かない」で、編集にも適用されます。

主な機能

• TDD との対応：テストケースはサブエージェントで行う圧力シナリオ。レッドはスキルなしでエージェントがルールを破ること、グリーンはスキルありで従うこと、リファクタは抜け穴を塞ぐこと。
• 書くべきとき：自明でなく、プロジェクトをまたいで再利用でき、広く役立つ技法。一回限りの解決策、プロジェクト固有の慣習、正規表現で強制できるルールには書かない。
• スキルの種類：技法、パターン、リファレンスの三つで、それぞれテスト方法が異なる。
• 説明文はトリガー：description にはワークフローの要約ではなく、いつ使うか（「Use when...」）を書く。要約を書いたせいで、二回必要なレビューをエージェントが一回しか行わなかった例が示されています。
• 防弾化：抜け穴を一つずつ明示的に塞ぎ、実際のテストから言い訳の対応表を作り、危険信号の一覧を加える。
• トークン効率：スキルは簡潔にし、重いリファレンスや再利用ツールは別ファイルへ。
• 補足ファイル：Anthropic のスキルのベストプラクティス、説得の原則、graphviz の慣例、サブエージェントでスキルをテストするガイド。

使用シナリオ

• Claude Code、Codex、Gemini CLI 向けにチーム独自のスキルを書く。
• エージェントに無視されたり誤用されたりするスキルを直す。
• Superpowers 自体に貢献する。

料金

MIT ライセンスの無料オープンソースです。Superpowers を開発する Prime Radiant は企業向けに商用サポートを提供しています。実質的なコストはトークンで、プロセス系スキルは質問、レビュー、サブエージェントの実行を増やします。

はじめに

Superpowers は一つのプラグインとしてインストールされ、このスキルはライブラリ全体（v6.4.1 で 15 スキル）と一緒に入ります。Claude Code では /plugin install superpowers@claude-plugins-official。Cursor は /add-plugin superpowers、Gemini CLI は gemini extensions install https://github.com/obra/superpowers。Codex、GitHub Copilot CLI、OpenCode、Pi などのコマンドは README にあります。スキルは自動で起動し、名前を指定して呼び出すこともできます。 「X のスキルを書いて」と頼むと、下書きの前に基準となるシナリオを実行するはずです。

制約：サブエージェントによる圧力テストには相応の時間とトークンがかかり、結果はモデルによって変わります。markdown ファイルを書くだけより重い作業です。

よくある質問

個人用スキルはどこに置きますか？

ランタイムの skills ディレクトリです。Claude Code では ~/.claude/skills/。いくつかのランタイムは ~/.agents/skills/ も読み込みます。

Anthropic の Skill Creator と同じですか？

違います。Skill Creator はテンプレートが中心で、このスキルはエージェントが実際に従うかのテストが中心です。

代替案

• Skill Creator：Anthropic 公式のメタスキル。
• Claude Skills：Claude Code がスキルを読み込む仕組み。
• Skills Explorer：新しく書く前に既存のスキルを探す。

まとめ

掲載している中で最も厳密なエージェントスキルの書き方ガイドです。Superpowers を入れなくても読む価値があります。詳しくは skills カテゴリ へ。