プロジェクト概要

Agent Skills は、20個の再利用可能なMarkdownベースのワークフロー指示からなる本番グレードのライブラリであり、シニアエンジニアのベストプラクティスをAIコーディングエージェントにエンコードし、ソフトウェア開発ライフサイクル全体にわたる手抜きを防ぎます。

プロジェクトの背景とポジショニング

なぜ存在するのか

AIコーディングエージェントは有能ですが、規律がありません。制約なしに放置されると、仕様をスキップし、テストを省略し、セキュリティレビューを無視し、もっともらしい言い訳でショートカットを正当化します。Agent Skillsは、Googleのエンジニアリング文化に深く根ざしたデベロッパーアドボケイトであるAddy Osmaniによって作成されました。これは、意見の強い検証可能なワークフローをエージェントの指示レイヤーに直接埋め込むことで、この問題を解決します。このプロジェクトは、コードを資産ではなく負債とみなし、「これで良いだろう」は測定可能な証拠の代わりには決してならないと主張します。

同様のプロジェクトとの違い

ほとんどのプロンプトライブラリは、場当たり的なヒントのコレクションです。Agent Skillsは3つの点で異なります。

ライフサイクルカバレッジ — スキルは、単一のステージを対象とするのではなく、定義 → 計画 → ビルド → 検証 → レビュー → 出荷のすべてのフェーズに対応します。
合理化防止ガードレール — 各スキルは、エージェントが取る一般的なショートカットを明示的に名前を付け、文書化された反論を提供するため、コンプライアンスよりも拒否が困難になります。
ツールに依存しないポータビリティ — すべてのスキルはプレーンなMarkdownであるため、Claude Code、Cursor、Windsurf、Gemini CLI、GitHub Copilot、Kiro IDE、またはシステムプロンプトを受け入れる任意のAIエージェントで、変更なしに実行できます。

機能カテゴリ

📋 定義 — 仕様スキル · 3スキル
代表例: システム要件、APIコントラクト、データモデル設計。
目的: コードを一行も書く前に、エージェントに要件を確定させる。

🗺 計画 — アーキテクチャと分解スキル · 4スキル
代表例: タスク分解、アーキテクチャ計画、依存関係マッピング、タイムライン見積もり。
目的: エージェントが実装に直接飛び込むのではなく、監査可能な計画を生成することを保証する。

🔨 ビルド — 実装スキル · 4スキル
代表例: インクリメンタルデリバリー、モジュール性強制、コード編成、トランクベースブランチング。
目的: エージェントが常にマージ可能な、小さく検証可能なステップでビルドし続ける。

✅ 検証 — テストスキル · 4スキル
代表例: 単体テスト、統合テスト、テストカバレッジゲート、テストパターン参照チェックリスト。
目的: エージェントに、正しさを仮定するのではなく、テストで機能を証明させる。

🔍 レビュー — 品質ゲートスキル · 3スキル
代表例: コードレビュー、セキュリティ監査、パフォーマンスレビュー、アクセシビリティチェックリスト。
目的: マージを承認する前に、シニアエンジニアが使用するのと同じ基準を適用する。

🚀 出荷 — デプロイスキル · 2スキル
代表例: 本番準備完了チェックリスト、デプロイ戦略、ロールバック計画。
目的: エージェントが、本番環境にプッシュする前に、オブザーバビリティ、ロールバック、オンコールへの影響を考慮することを保証する。

コアハイライト

20個のライフサイクル全体を網羅するスキルを1か所に集約 — 初期の仕様から本番デプロイまで、各フェーズには、ステップバイステップの手順と検証ゲートを備えた少なくとも1つの専用スキルがあります。

ワークフロー段階にマッピングされた7つのスラッシュコマンド — /spec、/plan、/build、/test、/review、/code-simplify、/ship は、IDEに関係なく、チームがエージェントに指示するための共通の語彙を提供します。

3つの専門エージェントペルソナ — コードレビュー担当者、テストエンジニア、セキュリティ監査担当者のペルソナがスキルと共に提供され、チームは専用の品質作業のために集中型エージェントを起動できます。

4つの参照チェックリスト — テストパターン、セキュリティプラクティス、パフォーマンス最適化、アクセシビリティ標準のスタンドアロンでリンク可能なチェックリストは、軽量なコンプライアンスゲートとして機能します。

エンジニアリング原則のアンカー — スキルは、エージェントが単に機械的に従うのではなく、プラクティスが存在する理由を推論できるように、命名された原則（Hyrumの法則、Beyonceのルール、Chestertonのフェンス）を埋め込みます。

ファーストクラスのマルチツール統合 — 専用の設定ディレクトリ（.claude/、.cursor/、.windsurf/、.gemini/、.opencode/）と各プラットフォームの設定ガイドにより、任意のIDEでの導入がスムーズになります。

ロール別のユースケース

一般開発者
7つのスラッシュコマンドを日々のワークフローのドライバーとして使用します。任意の機能を開始する前に/specを実行し、実装中に/buildを実行し、PRを開く前に/reviewを実行します。これらのスキルは、スケジュールのオーバーヘッドなしに、あなたの肩越しに見ているシニアエンジニアのように機能します。

DevOps / プラットフォームエンジニア
Ship スキルと本番準備完了チェックリストに焦点を当て、AIによって生成されたデプロイコードが、変更が本番環境に到達する前にロールバック戦略、フィーチャーフラグ、オブザーバビリティフックを考慮することを保証します。

データ & リサーチエンジニア
Define および Plan スキルを使用して、エージェントがパイプラインまたは変換コードの生成を開始する前に、明確なデータコントラクトとスキーマドキュメントを強制します。テストスキルは、データ品質アサーションのカバレッジを強制するのに役立ちます。

プロダクトチーム
Spec スキルを要件翻訳レイヤーとして使用します。プロダクトブリーフをスペックスキルを実行しているエージェントにフィードして、エンジニアリングとのやり取りを減らす構造化された開発者向け要件ドキュメントを取得します。

クイックスタート

🔍 リソースの見つけ方

リポジトリの skills/ ディレクトリで20個すべての .md スキルファイル、agents/ で3つの専門ペルソナ、references/ で4つのスタンドアロンチェックリストを参照してください。docs/ ディレクトリには、ツールごとの設定ガイドが含まれています。

skills/          # 20のライフサイクルスキル
agents/          # code-reviewer, test-engineer, security-auditor
references/      # testing, security, performance, accessibility
docs/            # 各IDE/ツールの設定ガイド

🛠 インストール / 統合方法

オプション1 — Claude Code プラグインマーケットプレイス（推奨）

/plugin marketplace add addyosmani/agent-skills

オプション2 — 任意のツール用のローカルクローン

git clone https://github.com/addyosmani/agent-skills.git
cd agent-skills

# Claude Code — ローカルプラグインディレクトリを指定
claude --plugin-dir ./

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

オプション3 — 個別のスキルをシステムプロンプトとしてコピー

# 任意のスキルを任意のAIエージェントのシステムプロンプトとして使用
cat skills/review.md   # ツールシステムプロンプトに貼り付け

Cursor / Windsurf / Kiro IDE — .cursor/、.windsurf/、および .opencode/ ディレクトリには、すぐに使用できる設定ファイルが含まれています。docs/ のツールごとのガイドに従ってください。

🤝 貢献方法

git clone https://github.com/addyosmani/agent-skills.git
cd agent-skills

# 既存の規約に従って新しいスキルを作成
cp skills/review.md skills/my-skill.md
# my-skill.md を編集 — 以下を含める: goal, steps, verification gates, anti-rationalizations

# プルリクエストを送信
git checkout -b feat/my-skill
git add skills/my-skill.md
git commit -m "feat: add my-skill for <purpose>"
git push origin feat/my-skill
# PRを https://github.com/addyosmani/agent-skills/pulls で開く

プロジェクト構造

agent-skills/
├── skills/                  # 20のライフサイクルスキルMarkdownファイル
│   ├── spec.md              # 要件定義
│   ├── plan.md              # 作業をタスクに分解
│   ├── build.md             # インクリメンタル実装
│   ├── test.md              # 検証ワークフロー
│   ├── review.md            # マージ前の品質ゲート
│   ├── code-simplify.md     # 複雑性削減
│   └── ship.md              # 本番デプロイ準備完了
├── agents/                  # 専門エージェントペルソナ
│   ├── code-reviewer.md
│   ├── test-engineer.md
│   └── security-auditor.md
├── references/              # スタンドアロン品質チェックリスト
│   ├── testing-patterns.md
│   ├── security.md
│   ├── performance.md
│   └── accessibility.md
├── .claude/commands/        # Claude Code スラッシュコマンド統合
├── .gemini/commands/        # Gemini CLI 統合
├── .cursor/                 # Cursor IDE 設定
├── .windsurf/               # Windsurf IDE 設定
├── .opencode/               # Kiro / OpenCode IDE 設定
├── docs/                    # ツールごとの設定ガイド
└── README.md                # プロジェクト概要とクイックスタート

ライセンス

MITライセンス


✅ 許可	個人、オープンソース、商用プロジェクトでの使用
✅ 許可	帰属表示を付けてのフォーク、変更、再配布
✅ 許可	スキルをプロプライエタリなAI製品またはSaaSツールにバンドル
❌ 禁止	再配布コピーから著作権表示を削除すること
ℹ️ 注意	保証はありません。貢献者は本番使用の結果について責任を負いません

FAQ

Q: Claude Code が必須ですか、それとも任意のAIコーディングツールで動作しますか？
A: Markdownをシステムプロンプトとして受け入れる任意のツールで動作します。20個すべてのスキルはプレーンな .md ファイルです。Claude Code は最もリッチなUX（スラッシュコマンド、プラグインマーケットプレイス）を持つ主要な統合ですが、Cursor、Windsurf、Gemini CLI、GitHub Copilot、および任意の汎用AIエージェントも同様にうまく機能します。

Q: 「スキル」は単にプロンプトを貼り付けるのとどう違うのですか？
A: 各スキルは構造化されたワークフローであり、一度きりの指示ではありません。明示的な目標、各段階での検証ゲート付きの番号付きステップ、およびエージェントが一般的に取るショートカットを予測して反論する「合理化防止」セクションが含まれています。これにより、スキルは単純なプロンプトよりもはるかに堅牢になります。

Q: チームの内部規約をスキルに追加できますか？
A: はい、それが推奨されるワークフローです。リポジトリをフォークし、関連する .md ファイルを編集して、チーム固有の標準（例: 内部テストフレームワーク、デプロイチェックリスト）を含め、AIエージェントをフォークに向けます。Markdown形式は、簡単なカスタマイズのために特別に選択されました。

Q: これはAIコーディングエージェントを大幅に遅くしますか？
A: スキルはステップを追加しますが、規律のない生成に続くはるかにコストのかかる手戻りを防ぎます。このプロジェクトでは、これを意図的なトレードオフとして扱います。初期出力は遅くなりますが、レビューまたは本番環境に到達する欠陥ははるかに少なくなります。

Q: 3つの専門ペルソナは20個のスキルとどう違いますか？
A: スキルはワークフロー指示であり、エージェントにタスクを「どのように」実行するかを伝えます。ペルソナ（agents/）は、集中した作業のためにエージェントの「アイデンティティと優先順位」を設定します（例: 常にセキュリティ監査担当者のように考える）。これらは補完的です。最も徹底的な結果を得るために、セキュリティ監査担当者のペルソナを使用してセキュリティ監査スキルを適用できます。

クイックリンク

リソース	URL
GitHub リポジトリ	https://github.com/addyosmani/agent-skills
プラグインマーケットプレイス (Claude Code)	`/plugin marketplace add addyosmani/agent-skills`
Issues & Discussions	https://github.com/addyosmani/agent-skills/issues
Releases	https://github.com/addyosmani/agent-skills/releases
Author	https://github.com/addyosmani

まとめ

Agent Skills は、機能ギャップではなく構造的な問題を解決する珍しいオープンソースプロジェクトです。AIコーディングエージェントを、自信過剰なジュニアではなく、規律あるシニアエンジニアのように振る舞わせます。25k以上のGitHubスター、主要なAIコーディングプラットフォームすべてに対するファーストクラスのサポート、MITライセンスにより、開発ワークフローでAIを使用しているあらゆるチームがすぐに利用できます。AIコーディングツールから一貫性のある、監査可能で、本番準備のできた出力を得たい開発者は、Agent Skills をエージェント設定の最初のレイヤーとして検討すべきです。

agent-skills