Claude Agent Skills 入門｜概要・メリット・使い方・活用ケース

要約

Claude Agent Skills は Anthropic が 2025 年 10 月に発表し、2025 年 12 月 18 日に オープンスタンダード化 された「再利用可能な知識パッケージ」である。本稿では前編として、スキルの定義・オープン標準としての位置付け・Progressive Disclosure による段階的ロード・決定論的スクリプト同梱の強み・Claude Code に同梱された ビルトインスキル 5 種 (/simplify /batch /debug /loop /claude-api) までを、中級エンジニア向けに整理する。

この記事を読むことで得られるメリット

この記事を読むことで以下のことが分かる:

• Claude Agent Skills の定義と、単なるプロンプトとの決定的な違い
• agentskills.io に公開されたオープンスタンダードとしての仕様と採用プラットフォーム
• Progressive Disclosure（段階的情報開示）の 3 層構造がコンテキストコストを抑える仕組み
• ビルトイン 5 種 (/simplify /batch /debug /loop /claude-api) の挙動と使い分け
• 自作カスタムスキル作成に向けた前提知識

この記事を読むのにかかる時間

約 12 分

環境

• MacOS Apple M4 Max Sequoia 15.1
• Claude Code v2.1.x 系（バンドルスキル同梱バージョン）
• 参照: agentskills.io 仕様（2025-12-18 公開版）

Claude Agent Skills とは何か

Claude Agent Skills は、Claude の能力を拡張するための 再利用可能な知識パッケージ である。専門知識・実務プラクティス・作業手順・社内規約・パターン・スタイルガイドをひとつのフォルダにまとめ、エントリポイントとして SKILL.md を置き、必要に応じてスクリプト／リファレンス／テンプレートをバンドルする。

重要な特徴は オンデマンドロード である。スキルは登録しておくだけでは起動時のコンテキストをほぼ消費せず、トリガーがかかったときに初めて本文が読み込まれる。これにより「組織に数百のスキルが存在しても起動は軽い」という設計が成立する。

プロンプトとの違い

スキルとプロンプトは似て非なるものである。以下に整理する。

プロンプトが「1 回限りの指示」であるのに対し、スキルは 組織的資産 として蓄積できる点が本質的に異なる。

Claude Agent Skills はオープンスタンダード

仕様と SDK は agentskills.io で公開済み

Anthropic は 2025 年 12 月 18 日に、Agent Skills を オープンスタンダード化 した。仕様と SDK は agentskills.io で公開されており、「一度書けばどこでも動く」ポータビリティが保証されている。

40+ ツール／プラットフォームが採用

公開からわずか数カ月で、40 を超えるツール・プラットフォームが Agent Skills の仕様を採用した。代表的な採用先を以下に挙げる。

OpenAI Codex も Skills 対応を段階的に導入中である。Anthropic の戦略は、先行して標準化に成功した MCP（Model Context Protocol）のオープン化パターン をそのまま踏襲しており、業界インフラ定義者としての地位を確立しつつある。

標準化までの経緯

時系列で整理すると以下のようになる。

1. 2025-10-16: Anthropic Engineering が Agent Skills を発表。「エージェントは能力を持ったが、実務遂行の 文脈 が欠如している」という課題提起から始まった
2. 2025-12-18: agentskills.io で仕様を公開し、オープン標準化を宣言。同時に Team / Enterprise 向け管理機能もリリース
3. 2026 年以降: 40+ プラットフォームが採用。Microsoft / Google / JetBrains を含む大手ベンダーが段階的に対応

Agent Skills の活用シーン

スキルが真価を発揮するのは、以下のような 繰り返し発生する知識適用タスク である。

参照を含む高レベルガイド

社内規約・API 仕様書・ドメイン用語集など、普段はコンテキストに載せたくないが必要時には即座に参照したい資料を、オンデマンドロードで安全に扱える。

ドメイン固有の組織ルール

部署別の書式・コミュニケーション規約・レビュー基準などを、スコープ制御（後述の呼び出し制御）で配布する。

企業固有ワークフロー

リリースノート生成・デプロイ前チェックリスト・稟議フォーマットなど、定型業務 を標準化する用途で特に効く。

Agent Skills の 3 つのメリット

メリット①: 再利用可能性

前述のプロンプト比較表の通り、スキルは Git で管理でき、チーム全員が同じ手順で作業できる。新メンバーのオンボーディングが劇的に速くなるのも、この組織的資産としての性質に由来する。

メリット②: Progressive Disclosure（段階的情報開示）

ファイルシステムベースのアーキテクチャで、必要な時に必要な情報だけ を読み込む仕組みが Progressive Disclosure である。3 層構造を表で示す。

この設計により、20 スキル登録しても起動時のコストは 約 2,000 トークン に収まる。SKILL.md が 500 行を超えた場合は、リファレンスやスクリプトを L3 に切り出すのがベストプラクティスとされる。

メリット③: 決定論的スクリプト（Deterministic Scripts）

スキルにはスクリプトを同梱できる。これは以下の理由で強力である。

• 生成コードより 信頼性が高い（毎回同じ挙動）
• コード生成が不要になり 時間を節約 できる
• スクリプト本体は コンテキストに乗らない。Claude が受け取るのは出力（「検証成功」等）だけ

代表的なパターンとして バリデーションループ がある。例えば Word ドキュメント編集スキルなら、以下のフローを SKILL.md に書いておく。

copy1. word/document.xml を編集
2. validate.py を即座に実行
3. エラーがあれば修正 → 再検証
4. 検証成功で初めて続行
5. pack.py で .docx に再構築
6. 出力をテスト

バリデーションの失敗時メッセージだけがコンテキストに戻るため、低コストかつ高精度で品質を担保できる。

Agent Skills の使い方

①: ビルトインスキルで動作を体感する

Claude Code には、ユーザーが自作するカスタムスキルと 同じ仕組み で動作するビルトインスキルが最初から同梱されている。

copy/simplify              # 3並列エージェントによるコード品質レビュー
/batch migrate ...     # 5-30 ユニットを worktree で並列変更
/debug                 # セッションデバッグ・ログキャプチャ
/loop 5m /test-build   # 5 分おきに定期実行
/claude-api            # Claude API リファレンス自動ロード

スラッシュから始まるのでコマンドと区別しにくいが、実体は SKILL.md ベースのプロンプトベーススキル である。まずはこれらを触って挙動を理解するのが近道である。

②: 呼び出し制御マトリクス

スキルは「誰が呼べるか」を細かく制御できる。

例えば /deploy や /commit のように副作用の大きいスキルは、disable-model-invocation: true で「ユーザーが明示的に呼んだときだけ動く」安全装置をかけるとよい。逆に社内規約のように「常に適用されていてほしい」背景知識は user-invocable: false で / メニューから隠す。

③: /skills で一覧確認とスコープ優先順位

/skills コマンドで現在有効な全スキル一覧を確認できる。スコープは以下の優先順位で解決される。

copyEnterprise  (managed settings)
    ↓  上書き
Personal    (~/.claude/skills/)
    ↓
Project     (.claude/skills/)
    ↓
Plugin      (<plugin>/skills/)

同名スキルと同名コマンドが競合する場合、スキルが優先される点も押さえておきたい。

ビルトインスキル 5 種の概要

Claude Code にプリインストールされているバンドルスキルは以下の 5 種である。

/simplify: 3 並列エージェントレビュー

/simplify は 3 つの独立した専門エージェントを並列起動し、git diff から対象ファイルを自動検出してレビューする。

• コード再利用 エージェント: 重複ロジックを検出
• コード品質 エージェント: 構造・パターン改善を提案
• 効率性 エージェント: アルゴリズム最適化を提案

有効な指摘は自動適用まで走る。推奨タイミングは 実装完了後、PR 提出前 である。

copy/simplify
/simplify focus on memory efficiency

/batch: 大規模並列コード変更

/batch はコードベースを 5〜30 の独立ユニットに分解し、各ユニットを git worktree で並列実行 する。フローは以下の 4 ステップである。

1. 調査: コードベース分析、独立ユニットに分解
2. 計画提示: 5-30 ユニットの作業計画を提示
3. 承認: ユーザーが確認・承認
4. 並列実行: 各ユニットを worktree で分離実行し PR 作成

copy/batch migrate src/ from Solid to React
/batch add unit tests to all service files in src/services/

大規模なマイグレーションやテスト追加で特に効く。

/debug /loop /claude-api

残り 3 種は以下の特徴を持つ。

/debug: セッションデバッグ・ログ分析用。Hooks の実行状況も記録する。v2.1.71 でデフォルト OFF のトグル式になった。

/loop: 定期実行・継続監視用。/loop 5m check build errors のように書ける。引数省略時は .claude/loop.md に従い、72 時間で自動期限切れする。クラウド側の /schedule とは別物である点に注意。

/claude-api: Claude API リファレンスを自動ロード。Python / TypeScript / Java など 8 言語対応で、anthropic の import を検出すると自動起動する。v2.1.97 からは Managed Agents のカバレッジも追加された。

まとめ

Claude Agent Skills は、Anthropic が 2025 年 12 月 18 日にオープンスタンダード化した、再利用可能な知識パッケージである。前編の要点を振り返る。

• 定義: SKILL.md をエントリポイントにフォルダ単位でバンドルされる、組織的資産としての知識パッケージ
• オープン標準: agentskills.io で仕様公開。40+ プラットフォームが採用済み
• 3 つのメリット: 再利用可能性／Progressive Disclosure（3 層構造）／決定論的スクリプト
• ビルトイン 5 種: /simplify /batch /debug /loop /claude-api — 自作スキルと同じ仕組みで動作する格好の学習サンプル
• 呼び出し制御: disable-model-invocation と user-invocable の 2 軸でスコープを設計する

後編「実践編」では、カスタムスキル作成の基本（skill-creator と evals.json）、フロントマター全フィールド解説、description の書き方、プラクティス／TIPS／アンチパターン、そして Agent Skills が ZDR 対象外である というセキュリティ上の必須知識まで踏み込む。