AI で稼ぐ方法を一緒に考えていくブログ。

自己紹介はこちら →

ツール紹介

agent-skills — AIコーディングの手順書セット

agent-skills は、AIコーディングエージェントに設計、実装、レビュー、検証の手順を守らせるためのスキル集だ。

agent-skills — AIコーディングの手順書セット
GitHub repo
addyosmani/agent-skills

これは何か

agent-skills は library (= そのままアプリとして使うというより、他のツールに組み込む部品集) 系のツールだ。中身は SKILL.md (= AIエージェントに作業手順を読ませるためのMarkdown形式の指示書) が24個入ったセットで、仕様を書いてから実装する、少しずつ変更する、コードレビューする、セキュリティを見る、性能を確認する、といった開発ワークフローを AI coding agents (= Claude Code や Cursor など、コード作業を手伝うAI) に強制させる。README の一言は「Production-grade engineering skills for AI coding agents.」で、かなり実務寄りの言い方。言語は Markdown、ライセンスは MIT (= 比較的ゆるく再利用しやすいライセンス)。stars (= GitHubで「いいね」相当の評価指標) の正確な数は今回確認できていないが、急成長中という扱いで見ておくのがよさそうだ。

想定用途

公式やメンテナ側が想定している使い方は、Claude Code (= Anthropic製のAIコーディング環境) の marketplace install、Cursor (= AI補助付きコードエディタ) の .cursor/rules、Codex、Gemini CLI (= Google系AIをターミナルから使うコマンド型ツール)、Antigravity CLI、Windsurf、OpenCode、GitHub Copilot への組み込みだ。対象は、AI coding agents を使って本番品質に近い成果物を出したい個人開発者やチーム。たとえば開発者が /spec を呼ぶと、エージェントがいきなりコードを書かず、PRD (= 何を作るかを整理した要件文書) を先に書く。/code-simplify を呼ぶと、Chesterton's Fence (= 既存の仕組みを消す前に理由を理解する考え方) や Rule of 500 (= 大きくなりすぎたコードを見直す目安) に沿って複雑さを減らす。

自分だったらどう使うか

自分はまだ agent-skills を手元の案件には入れていない。ただ、Claude Code や Cursor に雑に「この機能作って」と投げて、あとから差分を見て重すぎるなと思うことはある。個人でAI副業っぽい小さいWebツールを作る時、最初に速く形にするのは大事だけど、AIが勝手に抽象化を増やしたり、使っていない設定ファイルを足したりすると後でしんどい。自分なら /spec と /code-simplify、それから security hardening (= セキュリティ面の穴を減らす確認作業) だけ先に入れる。全部のスキルを常時オンにするより、LP生成、管理画面、課金まわりみたいに壊れると困る部分だけに絞って使うと思う。スキル自体にも prompt injection (= 外部文章でAIの指示が乗っ取られる問題) のリスクがあるので、知らないSKILL.mdを丸ごと信用するのはまだ怖い。

新規性と既存比較

似たものとしては wshobson/agents がある。これは multi-agent plugin marketplace (= いろいろな専門AIエージェントを選んで使う置き場) に近く、専門役割の数で押すタイプに見える。もう一つは Anthropic Agent Skills (= Claude系で使われるSKILL.md形式の作業定義) で、形式としてはかなり近い。なので agent-skills は、完全に新しい発明というより、既存の agent スキル文化をかなり実務寄りに寄せたパッケージだと見ている。差分があるとすれば、Addy Osmani という Google Chrome/Web Perf 系の実務家が、「less code」「push back on bad ideas」「quality gates」を前面に出している点。AIにもっと書かせる道具ではなく、書きすぎを止めて、検証を飛ばさせない道具という位置づけがはっきりしている。stars の正確な数は不明だが、X上で「repo of the day」「must-star」と言われ、Claude Code や Cursor ユーザーがすぐ入れている流れ自体は需要のサインだと思う。