addyosmani/agent-skills — AIエージェントに開発規範を組み込むスキル集

AI/MLAI AgentClaude CodeCursorLLMDeveloper Tools

addyosmani/agent-skills

★ 115,178 ・ JavaScript ・ MIT

GitHub →

概要

addyosmani/agent-skills は、AIコーディングエージェントに対してシニアエンジニアの開発ワークフローや品質ゲート、ベストプラクティスを遵守させるために設計されたスキルパッケージです。AIを活用したコーディングでは、エージェントが仕様の確認を怠ったまま実装を開始したり、テストを行わずにコードを出力したりするケースが課題になりがちです。本リポジトリは、開発の各フェーズにおいてエージェントが一貫した規範に従って動作するように、パッケージ化された指示やワークフローを提供します。

Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLIなど、70以上のエージェント環境に対応しており、AI主導で開発を進める個人開発者や、チーム開発にAIアシスタントを組み込みたいエンジニアに適しています。

主な特徴

  • ライフサイクルを網羅する9つのスラッシュコマンド 要件定義（/spec）、計画（/plan）、段階的実装（/build）、テスト検証（/test）、制約管理（/constraints）、コードレビュー（/review）、Webパフォーマンス診断（/webperf）、コードの簡素化（/code-simplify）、リリース（/ship）という、開発工程に沿ったコマンドが用意されています。

  • 全25種類のエンジニアリングスキルを収録 ライフサイクルに応じた24種類のスキルと、スキル全体を統括するメタスキル using-agent-skills の合計25スキルが含まれています。各スキルには段階的な手順、検証用チェック、アンチパターンの回避指針が含まれています。

  • 承認型自律実装モード「/build auto」 仕様（spec）が作成された後、/build auto を実行すると、AIが計画の生成から全タスクの実装までを自動で進めます。人間によるタスク間の手動介入を減らしつつも、各タスクはテスト駆動（TDD）で個別にコミットされ、失敗やリスクが高いステップが発生した際には一時停止して確認を求めます。

  • 作業内容に応じたスキルの自動発火 明示的なスラッシュコマンドの呼び出しだけでなく、エージェントの作業コンテキストに応じて必要なスキルが自動的に適用されます。たとえばAPI設計時には api-and-interface-design、UI作成時には frontend-ui-engineering が発火します。

  • 幅広いエージェントと導入エコシステムへの対応 オープンソースの skills CLI を利用することで、単一のコマンドで多数のエージェントに一括導入できます。また、主要な各ツール向けにネイティブプラグイン形式やローカル設定ファイル形式の手順も整備されています。

使い方

READMEには、共通CLIツールを使う方法と、各エージェントのネイティブ機能を使う方法が記載されています。

1. skills CLI を使ったインストール

Vercel Labsが公開している skills CLI を経由することで、Claude Code、Cursor、Codex、GitHub Copilot、Clineなど、対応するエージェント環境へ一括導入できます。

# 全25スキルを一括インストール
npx skills add addyosmani/agent-skills

# インストール前にスキル一覧を確認
npx skills add addyosmani/agent-skills --list

# 個別のスキルのみを指定してインストールする場合の例
npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill interview-me
npx skills add addyosmani/agent-skills --skill test-driven-development

2. Claude Code での利用（推奨環境）

Claude Codeではプラグインとして導入できます。マーケットプレイス経由でインストールする場合は以下を実行します。

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

ローカルにリポジトリをクローンして利用することも可能です。

git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills

3. Cursor での利用

プロジェクト内の .cursor/skills/ ディレクトリに、リポジトリの skills/ 配下を同期して配置します。短いポリシーについては .cursor/rules/*.mdc に記載し、スキル全体のテキストを直接ルールファイルへ貼り付けない運用が推奨されています。

4. Codex CLI での利用

Codex CLI（v0.122以上）では、ネイティブプラグインとして導入できます。

codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

導入後はチャット内で @spec-driven-development のように @ 記法を用いてスキルを呼び出します。

5. Gemini CLI / Antigravity CLI

各ツールのCLIコマンド経由でリモートリポジトリまたはローカルクローンから直接インストールできます。

# Gemini CLI の場合
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

# Antigravity CLI の場合
agy plugin install https://github.com/addyosmani/agent-skills.git

技術的なポイント

  • プレーンMarkdownによるスキル定義 リポジトリの言語属性は JavaScript となっていますが、スキルの本体はプレーンな Markdown 形式で構成されています。エージェントが解釈可能なプロンプト指示ファイルとして記述されているため、システムプロンプトや外部指示ファイルを受け付けるあらゆる LLM・AI エージェントで利用できる可搬性を持っています。

  • エージェントごとのインターフェース差異の吸収 各ツールによってプラグイン機構、スラッシュコマンド、ルールファイル、指示ファイルの扱いが異なります。本リポジトリでは Claude Code 向けのプラグイン構成（.codex-plugin/plugin.json や各種設定）や、Cursor 向けのディレクトリ構成（.cursor/skills/）、OpenCode・Kiro 向けの AGENTS.md 構成など、各ツールの仕様に合わせた導入設計がなされています。

  • 自律性と安全性のバランス設計 /build auto に見られるように、計画策定後の実装フェーズを自律化しつつも、タスクを小さく分割し（Small, atomic tasks）、テストを必須とし（Test-driven development）、個別にコミットを行うアーキテクチャが採用されています。失敗時や高リスクな操作時には停止するガードレールが組み込まれています。

注意点

  • 単一スキルインストール時の共有参照ファイル欠落（Issue #361） npx skills add --skill <名前> を使用して特定のスキルのみを個別にインストールした場合、該当の skills// のみがコピーされ、リポジトリルートにある references/ ディレクトリ（共有チェックリスト等）は取得されません。スキル自体は動作しますが、補足チェックリストへのパスが無効になるため、リポジトリ全体をクローンするか、必要な参照ファイルを手動で配置する運用が案内されています。

  • コマンド名の衝突と名前空間の利用 Claude Codeにおいて、ビルトインコマンドに同名のものが存在する場合（例: /review）、名前空間を付与した形式（例: /agent-skills:review）を使用する必要があります。

  • GitHub SSH接続に関するトラブル Claude Codeのプラグインマーケットプレイスは内部でSSH経由のgit cloneを実行します。GitHubにSSH鍵を登録していない環境では、HTTPS URLを明示的に指定するか、Gitのグローバル設定でSSHからHTTPSへの書き換え（insteadOf）を設定する回避策が示されています。

  • ホストごとのコマンド制限 GitHub Copilotなど一部の環境では、Claude Code向けのスラッシュコマンド（/spec、/build など）が直接認識されません。その場合は /spec-driven-development のようにスキル名を直接指定して呼び出す必要があります。

  • ライセンス 本プロジェクトは MIT ライセンスで提供されています。

まとめ

addyosmani/agent-skills は、AIコーディングエージェントにシニアエンジニアの開発規律を注入するための包括的なスキルフレームワークです。要件定義からレビュー、リリースに至る各工程を構造化されたワークフローで制御し、テスト駆動や品質チェックを自然に実行させることができます。Claude CodeやCursorをはじめとする多様な開発環境で、AIによる出力コードの品質を担保したいエンジニアにとって実用的な選択肢となります。

関連記事

AI/ML

agent-rules：エージェント活用を最適化するためのルール集

「agent-rules」は、Claude CodeやCursorなどのAIエージェントとより効果的に連携するためのルールや知識をまとめたリポジトリです。Shellスクリプトを中心に構成されており、エージェントの挙動を制御・最適化するためのベストプラクティスを提供。AIエージェントの利用が増える中、開発者やユーザーが実践的に活用するためのガイドラインとして役立ちます。

AIエージェントClaude CodeCursor