AIエージェントとペアプロをするのが当たり前になってきた昨今、Claude Code や Codex といった強力なツールが登場しています。
これらのツールをより使いこなすために、「Skill（スキル）」や「Prompt」を自作して読み込ませている方も多いのではないでしょうか？
しかし、ツールごとにフォーマットが違ったり、強力すぎるがゆえに勝手にコミットされたりといったセキュリティ上の懸念があったりと、管理が意外と大変です。
そこで今回、著名な2つのリポジトリの「いいとこ取り」をして、最強のスキル集 「Super Skills」 を作ってみました。
元ネタ（インスピレーション）
Super Skillsは、以下の2つのプロジェクトから強い影響を受けています。
-
gstack:
- 「調査（Investigate）」→「戦略（Strategy）」→「実行（Execution）」といった、極めて自律性の高いワークフローが特徴。
-
everything-claude-code (ECC):
- 大量のスキルをモジュール化して管理・インストールできる仕組みと、豊富な知識パック（TDD, セキュリティなど）が特徴。
これらを合成し、「最強のワークフロー」を「どこでも使えるモジュール形式」で提供するのが Super Skills です。
Super Skills の 3 つの特徴
1. 「一箇所で書いて、どこでも使う」マルチホスト対応
skills/ ディレクトリにある Markdown 形式のソースファイルをマスターとし、ビルドスクリプトを実行することで、各ツール向けのフォーマットを自動生成します。
-
Claude Code 用:
.claude/skills/に展開 -
Codex 用:
.agents/skills/にメタデータ（openai.yaml）付きで展開
これにより、同じワークフロー論理を複数の AI ツールで共有できます。
2. 「勝手にやらない」セキュリティ第一の設計
既存のツールには、良かれと思って「自動コミット」や「テレメトリ送信」を行うものもありますが、Super Skills はあえてそれらをデフォルトで無効にしています。
-
勝手にコミットしない:
ship-releaseスキルでも、PRの準備まではしますが、勝手にgit pushはしません。 - 勝手に実行しない: ブラウザ操作や外部ツール（MCP）の利用は、すべて明示的なオプトイン制です。
3. 高密度な「コア・ワークフロー」
単なるプロンプト集ではなく、エンジニアの思考プロセスを強化するための「型」が定義されています。
-
investigate: いきなりコードを直さず、まず証拠を集めて仮説を立てる「原因究明第一」のデバッグ -
plan-product/plan-architecture: 実装前に「なぜ作るのか」「どう設計するのか」を徹底的に詰めさせる -
review/security-review: 指摘事項（Findings）を優先的に出させる、本質的なコードレビュー -
qa-browser: ブラウザを自動操作して、リグレッションが発生していないかレポートさせる
リポジトリの構成
/
├── skills/ # 【マスター】人間が書くスキルのソース
├── .claude/skills/ # 【生成物】Claude Code用
├── .agents/skills/ # 【生成物】Gemini CLI (Codex)用
├── mcp/ # MCP（Model Context Protocol）のカタログ
├── manifests/ # インストール設定（profileなど）
└── scripts/ # ビルド・インストール用スクリプト
使い方
使い方は非常にシンプルです。
1. スキルのビルド
skills/ 以下のソースから各ツール向けの成果物を生成します。
node scripts/build-skills.js # Codex用
node scripts/build-claude-skills.js # Claude用
2. ターゲット環境へのインストール
自分の開発プロジェクトに、必要なスキルセットをインストールします。
# 「core」プロファイル（基本のワークフロー）をClaude Code向けにインストール
node scripts/install-apply.mjs --profile core --target claude --target-root /path/to/your/project
これだけで、.claude.json や .agents/ ディレクトリが必要な分だけセットアップされます。
まとめ：AIエージェントに「自律性」と「規律」を
Super Skills を使うことで、AI エージェントは単なる「コードを生成する機械」から、「エンジニアリングのベストプラクティスを遵守する頼もしいパートナー」へと進化します。
特に investigate や plan-* 系スキルの、「書く前に考えさせる」 プロセスは、大規模なリポジトリで作業する際に非常に強力です。
「Claude Code をもっとプロフェッショナルに使いたい！」という方は、ぜひ自分なりの Super Skills を構築してみてはいかがでしょうか。