【2026年最新】世界一わかりやすい Agent Skills 完全ガイド — まとめ
元記事: 【2026年最新】世界一わかりやすいAgent Skills完全ガイド（株式会社AIworker） 紹介ポスト: Fujin(@fujin_metaverse)
Agent Skills とは？
一言で言うと、「AIエージェントに渡す新人研修マニュアル」。
会社の新入社員にマニュアルを渡すのと同じ要領で、SKILL.md というテキストファイルに「やり方」を書いて所定のフォルダに置くだけ。AIエージェントが自動的にそれを見つけて読み込み、指示通りに仕事をしてくれる。
- 2025年12月に Anthropic がオープンスタンダードとして公開
- Claude, GitHub Copilot, OpenAI Codex, Cursor など主要AIツールが対応
- 2026年2月時点でマーケットプレイス登録数は20万件超
なぜ Agent Skills が必要か — プロンプトの3つの限界
従来のプロンプト運用には以下の限界があった。Agent Skills はこれらを全て解決する。
| 限界 | 問題 | Agent Skills での解決 |
|---|---|---|
| 毎回同じ説明が必要 | 技術スタック、規約、コミットルールを毎回ゼロから伝える | 一度書けば繰り返し使える |
| チーム共有できない | 優れたプロンプトがチャット履歴に埋もれる | Git で管理・共有可能 |
| コンテキスト圧迫 | 毎回全情報を読み込むと、肝心のタスクの余裕が減る | 必要な時に必要な分だけ読み込む「段階的開示」 |
Claude Code のセットアップ手順
Agent Skills を使う最も一般的な環境は Claude Code（Anthropic 提供のターミナル型AIコーディングツール）。ブラウザ版の Claude.ai と違い、PCのファイルを直接読み書きできるのが特徴。
| |
SKILL.md の書き方
SKILL.md は YAMLフロントマター + Markdown 本文 の2部構成。
| |
name→ スラッシュコマンド（/meeting-notes）になるdescription→ Claude が「このスキルを使うべきか？」を判断する材料
Skills の配置場所
| 種類 | パス | 用途 |
|---|---|---|
| 個人用 | ~/.claude/skills/スキル名/SKILL.md | すべてのプロジェクトで共通利用 |
| プロジェクト用 | プロジェクト/.claude/skills/スキル名/SKILL.md | そのプロジェクト限定。Git でチーム共有 |
| |
使い方（2通り）
# 方法1: スラッシュコマンドで直接呼び出し
/meeting-notes 今日のプロジェクト定例の議事録を作って。
# 方法2: 自然言語で依頼（自動検出）
今日のミーティングの議事録を作ってほしい
方法2 では、description に書いたキーワード（「議事録」「ミーティング」等）を元に Claude が自動的にスキルを検出して適用する。
Progressive Disclosure（段階的開示）の仕組み
「全スキルを毎回読み込んだら重くならない？」→ ならない。3段階で効率的に読み込む。
| Stage | タイミング | 読み込む内容 | トークン量 |
|---|---|---|---|
| 1 | 起動時 | name と description だけ | 約100トークン/スキル |
| 2 | スキル発動時 | SKILL.md 本文 | 推奨5,000トークン未満 |
| 3 | 必要時のみ | scripts/, references/, assets/ 内ファイル | タスク依存 |
10個のスキルを登録していても、コンテキストを消費するのは今のタスクに関係あるスキルだけ。
高度なフォルダ構成
my-skill/
├── SKILL.md ← 必須。エントリポイント
├── scripts/ ← 自動実行するスクリプト
│ └── validate.py
├── references/ ← 詳細な参照資料
│ └── api-docs.md
└── assets/ ← テンプレート等
└── template.json
例: コードレビュースキルなら、SKILL.md にレビュー手順、references/ に社内コーディング規約、scripts/ に自動チェックスクリプトを配置。
CLAUDE.md・MCP との違い
| 仕組み | 役割 | たとえると |
|---|---|---|
| CLAUDE.md | プロジェクト全体の基本設定（技術スタック、規約） | プロジェクトの概要書 |
| MCP | AIに「新しいツール」を追加（DB接続、Slack投稿等） | 能力の拡張（何ができるか） |
| Agent Skills | 特定タスクの手順を教える | タスクの手順書（どうやるか） |
CLAUDE.md でプロジェクトの前提を伝え、MCP で使えるツールを増やし、Skills でタスクの手順を教える — 3層構造
対応プラットフォーム
Claude Code / Claude.ai / GitHub Copilot (VS Code) / OpenAI Codex / Cursor / Google Gemini CLI / Goose / Kiro / Amp ほか多数。
SKILL.md の書き方は全ツール共通。一度作ったスキルを複数ツールで使い回せるのがオープンスタンダードの強み。配置場所はツールにより若干異なる（GitHub Copilot は .github/skills/、.claude/skills/ も互換パスとして認識）。
セキュリティ注意
2026年2月に、悪意あるコードを含むスキルが300件以上配布される事案（ClawHavoc キャンペーン）が報告されている。
- 自分で書くのが一番安全
- 外部ダウンロードしたスキルは使う前に必ず中身を確認
- 特に
scripts/フォルダ内のスクリプトは要注意
まとめ — 始め方チェックリスト
- ターミナルを開く
- Node.js を確認・インストール
curl -fsSL claude.ai/install.sh | bashで Claude Code インストール- ブラウザで認証
mkdir -p ~/.claude/skills/スキル名でフォルダ作成SKILL.mdに name・description + 手順を記述- Claude Code で
/skillsで確認、スラッシュコマンドまたは自然言語で呼び出し
Skill の正体は「テキストファイル」。プログラミング不要。Markdown で手順を書いて決まったフォルダに置くだけで、AIの仕事の質が劇的に変わる。