agent-skillsでClaude Codeにシニアエンジニアの作法を仕込む｜Addy Osmaniが公開した20のプロダクション品質スキル集
AIエージェントが「暴走」する問題、あなたにも心当たりはありませんか？
Claude CodeやCursorを使っていると、こんな経験はないでしょうか。
- 仕様をちゃんと確認せずにコードを書き始める
- テストを書かずにいきなり実装を進める
- レビューを省いたまま「完成」と宣言する
- セッションをまたぐたびに品質がバラバラになる
AIエージェントは優秀です。でも「一貫した作法で動くか」というと、指示の仕方次第で出力がまったく変わります。シニアエンジニアが10年かけて染み込ませたワークフロー——スペックを先に書く、小さくコミットする、本番前にチェックリストを回す——こういった暗黙知を、AIは持っていません。
そこに登場したのが、Google Chrome DevRelのAddy Osmaniが公開した agent-skills です。35,000スター超えの注目リポジトリで、AIエージェントに「シニアエンジニアの作法」を丸ごと仕込める20のスキル集です。
agent-skillsとは？シニアエンジニアの知見をAIに教え込むOSS
agent-skills（GitHub: addyosmani/agent-skills）は、AIコーディングエージェントのためのプロダクション品質スキル集です。
コンセプトはシンプルで強力です。「シニアエンジニアが実際に使うワークフロー・品質ゲート・ベストプラクティスを、AIエージェントが一貫して実行できる形にパッケージ化する」というもの。
ただのプロンプト集ではありません。開発ライフサイクル全体をカバーする構造化されたスキルで、Claude Code・Cursor・Gemini CLI・Windsurf・GitHub Copilot・Kiro・Codexなど主要エージェントに対応しています。
個人開発や副業プロジェクトで「エージェントに任せたら思ったより品質が低かった」という経験がある方には、まさに刺さるツールです。
開発ライフサイクルをカバーする7つのスラッシュコマンド
agent-skillsの目玉は、開発の各フェーズに対応した7つのスラッシュコマンドです。
| コマンド | フェーズ | 何をするか |
|---|---|---|
/spec |
DEFINE | コードより先に仕様を定義する |
/plan |
PLAN | 仕様を小さなアトミックタスクに分解する |
/build |
BUILD | インクリメンタルに実装を進める |
/test |
VERIFY | テストで動作を証明する |
/review |
REVIEW | マージ前のコードレビューを実行する |
/code-simplify |
REVIEW | コードをシンプルに整理する |
/ship |
SHIP | プロダクションへのデプロイを行う |
この流れ、見覚えありますよね。「仕様→計画→実装→テスト→レビュー→デプロイ」というのは、チームで開発するときの当たり前のプロセスです。でも個人開発やAIエージェントに任せると、このプロセスが飛ばされがちです。
agent-skillsはこのプロセスをスラッシュコマンドとして呼び出せるようにすることで、AIエージェントが勝手にフェーズをスキップするのを防ぎます。
全20スキルの中身——何がAIに教え込まれるのか
スラッシュコマンドの裏側には、20のスキルが定義されています。主要なものを紹介します。
仕様・設計フェーズ
– idea-refine: 曖昧なアイデアを具体的な提案に落とし込む
– spec-driven-development: PRD（製品要件定義書）を先に書いてからコードを書く
– api-and-interface-design: APIとインターフェースを設計する
実装フェーズ
– planning-and-task-breakdown: スペックを実装可能なタスクに分解する
– incremental-implementation: 薄い垂直スライスで実装・テスト・コミットを繰り返す
品質・レビューフェーズ
– test-driven-debugging: テストを使ったデバッグ手法
– code-review: コードレビュープロセスの実行
– production-readiness: 本番環境対応チェックリスト
フロントエンド・その他
– frontend-ui-engineering: フロントエンドUI開発のベストプラクティス
特に注目したいのが spec-driven-development と incremental-implementation です。「仕様を先に書く」「薄いスライスで進める」は、ベテランエンジニアほど重視するアプローチですが、AIに明示的に指示しないと実行されません。agent-skillsはこれをデフォルトの振る舞いにしてくれます。
コードベースの把握という観点では、graphifyでナレッジグラフ化と組み合わせると、仕様定義前にAIがコードの全体構造を把握した状態でスペックを書けるようになります。
Claude Codeへのインストール方法——1コマンドで完了
Claude Codeへのインストールは、マーケットプレイス経由で2コマンドで完了します。
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
インストール後は、Claude Codeのセッション内で /spec、/plan、/build などのコマンドが使えるようになります。
Cursorの場合は、リポジトリの SKILL.md ファイルを .cursor/rules/ ディレクトリにコピーするだけです。
Gemini CLIの場合は以下のコマンドを使います。
skills install agent-skills
Claude Codeを使い込むほど、セッション間でエージェントの挙動が変わることが気になってきます。claude-memでセッション記憶を永続化と組み合わせると、agent-skillsが定義したワークフローをセッションをまたいで一貫して適用できるようになります。
また、トークン消費が増えることが気になる場合は、cavemanでトークンを75%削減する手法と組み合わせるのが現実的です。スキル定義のプロンプトは比較的長くなりがちなので、トークン最適化との組み合わせは実用上かなり重要です。
副業・個人開発での活用シナリオ
agent-skillsが特に力を発揮するのは、一人で複数の役割を担う副業・個人開発のシーンです。
シナリオ1：スペック駆動開発でアイデアを形にする
副業で受託案件を受けるとき、クライアントの要望は大抵ふわっとしています。/spec コマンドを使うと、エージェントが「コードを書く前に仕様を固める」フローを強制します。曖昧なまま実装を始めて手戻りが発生するリスクを大幅に下げられます。
idea-refine スキルも便利で、「なんとなくこういうものを作りたい」という状態から、具体的なPRDに落とし込むサポートをしてくれます。
シナリオ2：コードレビュー自動化でソロ開発の盲点を補う
一人で開発していると、自分のコードを客観的にレビューするのが難しいです。/review コマンドは、マージ前にシニアエンジニア視点でコードをチェックするプロセスを実行します。セキュリティ・パフォーマンス・保守性の観点から指摘が入るので、レビュアーがいないソロ開発の弱点を補えます。
シナリオ3：本番リリース前のチェックリストを自動化
個人開発でよくあるのが、「動いたからリリースしよう」で細かいチェックを省いてしまうケースです。/ship コマンドと production-readiness スキルを使うと、エラーハンドリング・ログ設定・環境変数の確認・デプロイ手順のチェックをエージェントが自動的に行います。
複数のエージェントを組み合わせた高度なワークフローを構築したい場合は、agency-agentsとClaude Codeの連携も参考になります。
開発環境をサーバーで本格構築するなら
AIエージェントをフルに活用した開発環境をクラウド上に構築したい場合、VPSは有力な選択肢です。ConoHa VPS（月額最安クラスのVPS）は、Claude CodeをサーバーサイドでフルにCLI実行する環境としても適しています。Dockerで開発環境を固めて、agent-skillsをインストールしたClaude Codeエージェントを常駐させる構成も現実的です。
まとめ
agent-skillsは「AIエージェントに何を指示するか」ではなく「AIエージェントがデフォルトでどう動くか」を変えるツールです。
Addy Osmaniがシニアエンジニアの知見として蒸留した20のスキルは、個人開発・副業・チーム開発を問わず、AIエージェントの出力品質を底上げします。特に以下の3点は即効性があります。
/spec→/plan→/buildの順に進めることで、仕様なきコーディングを防ぐ/reviewで一人開発のコードレビュー不足を補う/shipで本番リリース前のチェック漏れをなくす
Claude Codeはプラグインマーケットプレイスから2コマンドでインストールでき、導入コストはほぼゼロです。すでにClaude CodeやCursorを使っているなら、今日試す価値があります。
Cursorを使っている方は、CopilotとCursorの比較も読んでおくと、どのエージェントでagent-skillsを使うかの判断基準が明確になります。
よくある質問（FAQ）
Q. agent-skillsは無料で使えますか？
A. はい、MITライセンスのオープンソースで完全無料です。GitHubからクローンするか、Claude Codeのマーケットプレイス経由でインストールできます。
Q. Claude Code以外のエージェントでも使えますか？
A. 使えます。Cursor・Gemini CLI・Windsurf・GitHub Copilot・Kiro・Codexに対応しています。各エージェントに応じたインストール方法がリポジトリのREADMEに記載されています。
Q. スキルをカスタマイズできますか？
A. できます。各スキルはMarkdownファイルで定義されているため、自分のチームやプロジェクトに合わせて編集可能です。特定のコーディング規約やチェックリストを追加するのも容易です。
Q. トークン消費量は増えますか？
A. スキル定義のプロンプトが追加されるため、若干増加します。cavemanでトークンを75%削減などのトークン最適化手法と組み合わせて使うのが現実的です。
Q. /spec や /plan はどのタイミングで使うのが効果的ですか？
A. 新しい機能や新規プロジェクトの開始時に /spec → /plan の順で使うのが最も効果的です。すでに実装が進んでいる既存プロジェクトには、/review や /code-simplify から入るのがおすすめです。
コメント