Agent Skills

Description:

AIエージェントに専門的な知識やワークフローをオンデマンドで提供するオープン標準

URL: https://agentskills.io/

Tags:

AI Agent Skill Standard Anthropic

Explore:

Qiita Zenn note Hatena

概要

Agent Skills は、AIコーディングエージェントに特定のタスクを遂行するための「専門スキル」を動的に提供するためのオープン標準です。2025年12月に Anthropic によって発表され、その後 GitHub や OpenAI も賛同する形で急速に普及しました。

従来の「長大なプロンプト（システムプロンプト）」にすべての指示を詰め込む手法とは異なり、必要なときに必要なスキルだけをAIに読み込ませる「オンデマンドな専門知識の注入」を実現します。

---

Agent Skills の構成要素

1つのスキルは、通常以下の要素を含むディレクトリ構造で定義されます。

• SKILL.md: スキルの名前、説明、および具体的な指示（手順）を記載したメインドキュメント。
• /scripts: そのスキルを実行するためにエージェントが利用できる自動化スクリプト。
• /resources: テンプレート、ドキュメント、スキーマ定義などの補助資料。

エージェントはこのディレクトリを「ライブラリ」のように参照し、自身のコンテキスト（記憶）を圧迫することなく、高度なワークフローを再現性高く実行できるようになります。

---

主な特徴とメリット

特徴	詳細
モジュール性と再利用性	一度定義したスキル（例：「プロジェクト構造の分析」）は、Cursor, Claude, VS Code Copilotなど異なるツール間でもそのまま利用可能です。
ダイナミックな専門性の獲得	エージェントは常にすべての知識を持っている必要はなく、タスクの内容に応じて適切なスキルを「オンデマンド」でロードします。
精度の向上	曖昧な指示ではなく、構造化された SKILL.md に基づいて動くため、ハルシネーション（もっともらしい嘘）を抑え、正確なアウトプットが得られます。
組織知のパッケージ化	チーム独自のベストプラクティスやコーディング規約をスキルとして定義し、チーム全体のAIエージェントに配布できます。

---

MCP (Model Context Protocol) との関係

Agent Skills は MCP と補完的な関係にあります。

• MCP (Model Context Protocol): 「何にアクセスするか」を標準化します。データソース（DB, GitHub API, ローカルファイル）への安全な接続路を提供します。
• Agent Skills: 「どのように遂行するか」を標準化します。MCPなどで得られたデータを使って、具体的なワークフローをどう進めるかの「手順書」を提供します。

---

導入と活用例

プロジェクト固有のスキル

プロジェクトの .agent/skills/ ディレクトリに配置することで、そのリポジトリを編集するすべてのエージェントがそのスキルを利用できるようになります。

活用シナリオの例

• プロジェクト分析スキル: プロジェクト全体の構造を把握し、依存関係を可視化する。
• ドキュメント生成スキル: コードの変更内容から README.md や APIリファレンスを自動更新する。
• セキュリティ診断スキル: 特定の脆弱性パターンを検査し、修正案を提示する。

---

現状のエコシステム (2026年時点)

2026年現在、主要なAIコーディングツールのほとんどがこの規格をサポートしています。

• Anthropic: Claude.ai, Claude Desktop, Claude Agent SDK
• GitHub: Copilot (IDE, CLI, GitHub.com)
• OpenAI: Codex, ChatGPT Desktop (Advanced Tools)
• その他: Cursor (Project Rules integration), Zed (Extensions), Windsurf (Cascading contexts)

本プロジェクトでも、.agent/skills/project-analyzer などのディレクトリを通じて、この標準に基づいたスキルが実装されています。