Agent Skills とは？

Agent Skills は Addy Osmani（Google Chrome チームのシニアエンジニア、Web パフォーマンス分野の著名なエキスパート）が作成したオープンソースフレームワークです。AI プログラミングアシスタント（Claude Code、Cursor、Windsurf など）にプロダクションレベルのエンジニアリングスキルとベストプラクティスを提供することを目的としています。

簡単に言うと、Agent Skills はシニアソフトウェアエンジニアが開発プロセスで使用するワークフロー、品質ゲート、ベストプラクティスを再利用可能なスキルパッケージとしてエンコードします。これにより、AI Agent は経験豊富なエンジニアのように、各開発段階で一貫した高水準を維持できます。

なぜ Agent Skills が必要なのか？

現在の AI プログラミングアシスタント（Claude Code、Codex、Gemini CLI など）はコードを生成できますが、体系的なエンジニアリング思考が欠けていることが多いです。

  • ❌ 仕様書（Spec）を書かずに直接コードを書く
  • ❌ 一度に多くの機能を実装し、タスク粒度が大きすぎる
  • ❌ テスト駆動開発の意識が不足している
  • ❌ コードレビューが形式的になっている
  • ❌ デプロイ前に十分な検証を行わない

Agent Skills は 7 つのスラッシュコマンドを通じて完全な開発ライフサイクルをマッピングします。各コマンドは対応するスキルモジュールを自動的にアクティブ化します。

やっていること コマンド コア原則
何を構築するか定義 /spec コードより先に仕様を書く
どう構築するか計画 /plan 小さくアトミックなタスク
増分的に構築 /build 一度に一つのスライス
有効性を証明 /test テストこそが証明
マージ前にレビュー /review コードヘルスを向上
コードを簡素化 /code-simplify 明晰さは賢さより優先
プロダクションにデプロイ /ship より速く、より安全に

プロジェクトのハイライト

  • 🚀 GitHub 38,971+ スター、コミュニティ活性度が高い
  • 🔧 複数の AI プラットフォームをサポート：Claude Code、Cursor、Windsurf、OpenClaw など
  • 📦 モジュラー設計：各スキルは独立してカプセル化され、必要に応じて有効化可能
  • 🎯 自動トリガー：コンテキストに基づいて関連スキルを自動アクティブ化（API 設計時に api-and-interface-design を自動トリガーなど）
  • 🆓 完全オープンソース無料：MIT ライセンス

Agent Skills のインストール

前提条件

  • Claude Code または他のサポートされている AI プログラミングアシスタントがインストール済み
  • GitHub アカウント（Marketplace インストール用）

方法 1：Claude Code Marketplace 経由でインストール（推奨）

BASH 
# プラグインを追加
/plugin marketplace add addyosmani/agent-skills

# インストール
/plugin install agent-skills@addy-agent-skills

SSH エラーが発生した場合（Marketplace はデフォルトで SSH 経由でリポジトリをクローン）、HTTPS URL に切り替えます。

BASH 
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills

方法 2：ローカルインストール（開発者デバッグ向け）

BASH 
# リポジトリをクローン
git clone https://github.com/addyosmani/agent-skills.git

# プラグインディレクトリを指定して Claude Code を起動
claude --plugin-dir /path/to/agent-skills

方法 3：Cursor ユーザー向け

Cursor エディターユーザーの場合、任意の SKILL.md ファイルを .cursor/rules/ ディレクトリにコピーできます。

BASH 
# すべてのスキルファイルをコピー
cp -r agent-skills/skills/* ~/.cursor/rules/

または Cursor 設定でリモートリポジトリを参照します。

方法 4：他の AI アシスタント

Agent Skills の核心は Markdown 形式のスキル記述ファイル（SKILL.md）です。理論的にはカスタムルールをサポートするあらゆる AI プログラミングアシスタントで使用できます。

  • Windsurf：SKILL.md を .windsurfrules/ に配置
  • OpenClaw：プロジェクトの skills/ ディレクトリ構造を参照
  • カスタム Agent：SKILL.md を解析して system prompt に注入

コア機能の実践

1. /spec — コードより先に仕様を書く

これは Agent Skills の最も重要な理念の一つです。どんなコードを書く前にも、まず何を構築するかを明確にします。

使用方法：

/spec ユーザー登録、ログイン、JWT 認証をサポートする REST API を構築したい

AI は構造化された仕様ドキュメントを生成します。以下内容を含みます。

  • 機能要件リスト
  • API エンドポイント設計
  • データモデル定義
  • 技術スタック選択理由
  • 受け入れ基準

出力例の一部：

MARKDOWN 
## API 仕様説明

### エンドポイント設計

- POST /api/auth/register
  - リクエストボディ: { email, password, name }
  - レスポンス: { userId, token }
  - エラー: 409 (メール既存), 400 (パスワード強度不足)

- POST /api/auth/login
  - リクエストボディ: { email, password }
  - レスポンス: { token, expiresIn }

### データモデル

User:
  - id: UUID
  - email: string (unique, indexed)
  - password_hash: string (bcrypt)
  - created_at: timestamp

2. /plan — 小さくアトミックなタスク

仕様ができたら、すぐにコードを書かないでください。/plan を使って大きなタスクを小さくアトミックなサブタスクに分解します。各タスクは以下条件を満たすべきです。

  • 15〜30 分で完了可能
  • 明確な入力と出力がある
  • 独立してテスト可能

使用方法：

/plan 上記の仕様に基づいて実装ステップを計画

AI は以下のようなタスクリストを生成します。

MARKDOWN 
## 実装計画

### Phase 1: プロジェクト初期化
- [ ] Task 1.1: Node.js プロジェクトを初期化、express、jsonwebtoken、bcrypt をインストール
- [ ] Task 1.2: ESLint + Prettier を設定
- [ ] Task 1.3: データベース接続を設定（PostgreSQL + Prisma）

### Phase 2: ユーザーモデル
- [ ] Task 2.1: User Schema を定義
- [ ] Task 2.2: 単体テストを作成：ユーザー作成、ユーザー検索

### Phase 3: 認証ロジック
- [ ] Task 3.1: パスワードハッシュユーティリティ関数を実装
- [ ] Task 3.2: JWT 生成と検証を実装
- [ ] Task 3.3: 統合テストを作成：登録 → ログイン → トークン検証
...

3. /build — 増分的に構築

これは最も強力なコマンドの一つです。/build は自動的に計画を生成し、すべてのタスクを順次実行します。計画を一度承認するだけで、その後は自律的に実行できます。

主要な設計理念： - ✅ 手動での段階的な確認という煩雑なステップを削除 - ✅ 各タスクのテスト駆動と独立コミットを維持 - ✅ 失敗や高风险ステップで自動的に一時停止

使用方法：

/build 上記の計画を実装

AI は以下を行います。 1. 完全な計画を表示して承認を依頼 2. 承認後、タスクを順次実行 3. 各タスク完了後に自動的にテストを実行 4. テスト合格後に git commit を提交 5. エラー発生時に一時停止して人手による介入を待機

4. /test — テストこそが証明

Agent Skills は**テスト駆動開発（TDD）**を強調します。コード変更を実行する前に、対応するテストがあることを確認します。

使用方法：

/test 新しく追加したユーザー登録インターフェースのテストを作成

AI は以下内容を生成します。 - 単体テスト（Jest/Vitest） - 統合テスト（Supertest） - 境界ケーステスト（null 値、重複メール、弱いパスワードなど）

5. /review — コードヘルスを向上

コードをマージする前に、/review を使用してコードレビューを行います。これはバグチェックだけでなく、以下内容にも注目します。

  • コード可読性
  • パフォーマンス隐患
  • セキュリティ脆弱性
  • アーキテクチャ一貫性

使用方法：

/review 最近の PR #42 をレビュー

6. /code-simplify — 明晰さは賢さより優先

このスキルは複雑なコードのリファクタリングに特化しています。「明晰さは賢さより優先」という原則に従います。

使用方法：

/code-simplify auth.middleware.js のロジックを簡素化

AI は以下を行います。 - 長い関数を小さな関数に抽出 - 深すぎるネストの条件判断を消除 - 晦涩な変数名をより直感的な名前に置換 - 必要なコメントを追加

7. /ship — より速く、より安全に

デプロイ前の最終チェックです。/ship は以下内容を確認します。

  • すべてのテストが合格
  • 未コミットの変更がない
  • CI/CD パイプラインが正常
  • ロールバック方案が準備済み

使用方法：

/ship プロダクション環境へのデプロイを準備

自動トリガーされるスキル

スラッシュコマンドを手動で呼び出す以外にも、Agent Skills はコンテキストに基づいて関連スキルを自動的にアクティブ化します。

シナリオ 自動トリガーされるスキル
API 設計 api-and-interface-design
フロントエンド UI 構築 frontend-ui-engineering
データベースマイグレーション処理 database-migrations
TypeScript 記述 typescript-best-practices
パフォーマンス最適化 performance-optimization
セキュリティ問題処理 security-review

つまり、すべてのコマンドを暗記する必要はありません。タスクを自然に説明するだけで、Agent Skills が適切なベストプラクティスを自動的にマッチングします。

カスタムスキル

Agent Skills の設計はモジュラーです。独自のスキルを作成できます。各スキルは SKILL.md ファイルで、以下内容を含みます。

MARKDOWN 
---
name: my-custom-skill
description: 私のカスタムスキルの説明
---

## 使用時機

以下の条件を満たす場合にこのスキルを使用します。
- 条件 1
- 条件 2

## 実行ステップ

1. ステップ 1
2. ステップ 2
3. ...

## 注意事項

- 注意 1
- 注意 2

ファイルを skills/ ディレクトリに配置すれば有効になります。

他のツールとの比較

機能 Agent Skills Cursor Rules Windsurf Flows
オープンソース ✅ ❌ ❌
クロスプラットフォーム ✅ ❌ (Cursor のみ) ❌ (Windsurf のみ)
コミュニティ貢献 ✅ (GitHub PR) ❌ ❌
自動トリガー ✅ 一部 一部
学習曲線 中 低 低

Agent Skills の最大の利点は開放性とコミュニティエコシステムです。誰でもスキルを貢献でき、共有されたベストプラクティスライブラリを形成できます。

まとめ

Agent Skills は AI プログラミングアシスタントの次の進化方向を表しています。「コードを書ける」から「エンジニアリングできる」へ。

シニアエンジニアの経験を再利用可能なスキルパッケージとしてエンコードすることで、AI Agent は単なるコードジェネレーターではなくなります。体系的な思考を持つ真のエンジニアリングパートナーになります。

推奨読書パス：

  1. まず 公式ドキュメント を読んで完全なスキルリストを理解
  2. /spec と /plan から始めて、「考えてからコードを書く」習慣を養成
  3. /build を試して自動化実行の魅力を経験
  4. 必要に応じて新しいスキルをカスタマイズまたは貢献

Claude Code、Cursor、その他の AI プログラミングアシスタントを使用している開発者にとって、Agent Skills は時間をかけて学ぶ価値のある生産力倍増器です。

関連リンク：