🧭 スター80.4千のAgent Skills、24個で『シニアエンジニアの仕事』をSDLC全工程に配る

AIエージェントのスキルは、増やすほど選べなくなる。前にBM25でスキルをルーティングするツールを取り上げたのも、この問題だった。今度は逆方向から来た。「スキルの数」ではなく「スキルの中身」を問い直すリポジトリだ。GoogleでChrome/Web Platformに関わってきたAddy Osmaniが公開したagent-skills。

24個で「シニアエンジニアの一連の判断」を配る

スター80.4千、フォーク8.7千(7月26日時点)。GitHub Trendingでスコアが伸びていたので、READMEを読みに行った。

このリポジトリの発想はシンプルだ。ソフトウェア開発のライフサイクルを、要件定義のDefine、計画のPlan、実装のBuild、検証のVerify、レビューのReview、そしてShipという6フェーズに分け、それぞれに対応するスキルを配置している。合計24個。

たとえばBuildフェーズだけで7個ある。test-driven-development(Red-Green-Refactor)、incremental-implementation(フィーチャーフラグ付きの薄い垂直スライス)、doubt-driven-development(重要な意思決定への敵対的レビュー)なんかが並んでいる。名前を見ただけで「あ、これ普段自分が頭の中でやってる判断を明文化しているな」と思った。

エビデンス要求という仕組み

面白いと思ったのが、各スキルに検証ゲートが埋め込まれている点だ。「seemsright(たぶん大丈夫)」を明示的に拒否する設計になっている、とREADMEに書いてあった。

つまり「テストが通ったので完了です」ではなく、「このテストが何を検証していて、なぜそれで十分と言えるか」まで求められる。AIエージェントに実装させると、この手の「自己申告のクオリティチェック」が一番怪しくなりがちだから、ここを構造化しているのは理にかなっている。

導入はnpx skills add addyosmani/agent-skillsのワンコマンドで済む。Claude Code向けにはマーケットプレイス経由の/plugin marketplace addもあるし、Cursorなら.cursor/skills/に配置するだけ。CodexやCopilot、Windsurf、Gemini CLIなど、対応エージェントは70以上と幅広い。

日本語での紹介はもう出ている

Qiitaで検索すると、すでに「AIコーディングをシニアエンジニアに変える」というタイトルでこのリポジトリを紹介した記事が出ていた。実務適用の観点でまとめられていて、内容としては悪くない。

ただ、24個という数をどう運用するか、既存のスキルとどう衝突するかまで踏み込んだものは見当たらなかった。入れる話はあっても、増えすぎたあとの話がない。

24個、全部読むのか問題

気になるのは、24個を一度に入れたときに何が起きるかだ。スキルは多いほど賢くなる類のものではなく、選択のコストを上げる。ルーティングの仕組みを持たないまま数だけ増やせば、エージェントは毎回全部を眺めることになる。

現実的なのは、足りないところだけ借りる使い方だろう。doubt-driven-developmentのような、自分のワークフローに明確に欠けている一枚を選んで混ぜる。全部乗せは、たぶん違う。

あなたのところでは、スキルの選び方をどう決めているだろうか。