Agent Skills（エージェントスキル）とは？Claudeを賢くする公式スキル機能・作り方・使い方を徹底解説

🌐
Read this article in English:
What Are Agent Skills? Anthropic’s Portable Skill Standard for Claude and Beyond →

Agent Skillsとは

Agent Skills（エージェントスキル）とは、Claudeなどの AI エージェントが動的にロードして利用できる「命令・スクリプト・リソースをまとめたフォルダ」の標準仕様である。Anthropic が 2025 年後半に正式発表し、Claude.ai・Claude Code・Claude Agent SDK・Claude Developer Platform の全製品で共通して利用できる。

イメージとしては「PowerShell のモジュール」や「VSCode の拡張機能」の AI エージェント版だ。スキルはフォルダ構造で配布され、SKILL.md というマニフェストファイルに「このスキルはいつ使うか（description）」と「どう使うか（instructions）」が書かれている。Claude はユーザーの依頼を読み取り、関連するスキルを自動的にロードする。

2026 年 1 月のアップデート以降、スキルを追加したり編集したりしても Claude Desktop のセッション再起動が不要になり、リアルタイムで新しいスキルを Claude が検出できるようになった。ここが重要なポイントです — スキルは動的に追加・更新できる拡張単位であり、アプリ全体を再ビルドする必要がない。

Agent Skillsの読み方

エージェントスキル

エージェントスキルズ

「Agent Skills」は英語の複数形がそのまま使われるため、日本語でも「エージェントスキル」または「エージェントスキルズ」の両表記が混在している。Anthropic 公式日本語ドキュメントでは単数扱いの「エージェントスキル」が採用されている。

Agent Skillsの仕組み

Agent Skills は以下の 3 つの要素で構成される。第一にマニフェスト（SKILL.md）、第二に任意のスクリプトファイル（Python・Shell・Node 等）、第三に参考資料（テンプレート、データファイル、画像等）である。Claude はセッション開始時にスキルディレクトリを走査し、各スキルのdescriptionだけを読み込む。実際に必要になった時点で、SKILL.md 本体や関連スクリプトを動的にロードする仕組みだ。

ディレクトリ構造

スキルのディレクトリ構造

~/.claude/skills/
my-skill/

→

SKILL.md
scripts/
templates/

→

Claudeが
必要時にロード

SKILL.mdの構造

SKILL.md は YAML フロントマター＋Markdown 本文という構成だ。フロントマターに name（スキル名）と description（いつ使うかの説明）が必須で記載される。本文にはスキルの詳細な使い方、前提条件、参照すべきファイル等を Markdown で書く。

ロードのタイミング

Claude は常にすべてのスキルを全文読み込むわけではない。セッション開始時には description だけを収集し、ユーザーの依頼内容と照合してマッチするスキルを判定する。実務では、これにより何十ものスキルをインストールしていてもトークン消費を抑えられる設計になっている。

Agent Skillsの使い方・実例

Agent Skills を使うには、スキルを置く場所を決めてフォルダを作り、SKILL.md を書くだけだ。Claude Code であれば ~/.claude/skills/ 配下、プロジェクト固有であれば .claude/skills/ 配下に置く。

スキル作成の基本例

# ~/.claude/skills/weekly-report/SKILL.md
---
name: weekly-report
description: 毎週の業務報告書を Markdown 形式で生成する。ユーザーが「週報を書いて」「weekly report」などと言った時に必ずこのスキルを使う。
---

# 週報生成スキル

## 手順
1. `~/documents/weekly-logs/` から今週分の作業ログを読み込む
2. 以下のテンプレートに従って Markdown を生成する
3. 出力ファイル名: `weekly-report-YYYY-MM-DD.md`

## テンプレート
```markdown
# 週報（YYYY年第N週）

## 今週の成果
- [作業内容を箇条書き]

## 課題・ブロッカー
- [課題を箇条書き]

## 来週の予定
- [予定を箇条書き]
```

スクリプト付きスキル

スキル内にスクリプトファイルを置くことで、より複雑な処理を実行できる。例えば Excel の集計処理や API 呼び出しを Python スクリプトで実装し、SKILL.md から参照する形だ。

公式プリセットスキル

Anthropic 公式の GitHub リポジトリ（anthropics/skills）では、pptx（PowerPoint 作成）・xlsx（Excel 操作）・docx（Word 文書）・pdf（PDF 処理）といったプリセットスキルが公開されている。これらを参考に自作スキルを書くのが早道だ。

Agent Skillsのメリット・デメリット

メリット

スキルは動的ロードなので、大量にインストールしていてもコンテキスト消費が増えない。マニフェストのみで発見されるので、使われない限り本体テキストはロードされない設計だ。また、スキルはただのフォルダなので Git でバージョン管理でき、チーム内で共有・配布も簡単になる。実務では、社内ドメイン知識を「社内スキル」として公開することで、全エンジニアの AI 生産性を一律に底上げできる。

デメリット

スキル機能は Claude ファミリー製品群で先行導入されているため、他社 AI への移植はオープン仕様とはいえ完全互換ではない点に注意してほしい。また、スキルのdescriptionが曖昧だと発火しない・誤発火するケースもあり、description の記述品質がスキルの実用性を左右する。

Agent SkillsとMCP・Toolの違い

Agent Skills は MCP サーバーや Tool とよく比較されるが、それぞれ役割が異なる。

項目	Agent Skills	MCP Server	Tool (API)
形式	フォルダ＋Markdown	サーバープロセス	JSON Schema 関数
配布単位	zip / Git	npm / Docker	API 呼び出し時指定
動的ロード	○	△（起動時固定）	×
役割	ノウハウ・手順	外部サービス接続	単発関数呼び出し

覚えておきたいのは、Agent Skills は「知識と手順」を、MCP は「外部サービス接続」を、Tool は「単発の機能呼び出し」を担うという棲み分けだ。実務ではこの 3 つを組み合わせて高度なエージェントを構築する。

よくある誤解

誤解1: スキルは Anthropic 専用の仕組み

Agent Skills はオープン仕様として公開されており、他の LLM ベンダーや開発者も採用できる。2025 年 12 月の発表では「ツールやプラットフォーム間で移植可能な標準であるべき」という Anthropic の方針が明示されている。

誤解2: スキルを増やすとトークン消費が増える

スキルは動的ロード設計のため、使われないスキルは description だけが評価される。100 スキルをインストールしても、セッション開始時の追加消費は各スキルにつき数十トークン程度に抑えられる。

誤解3: スキルは Claude Code 専用

初期の実装では Claude Code が先行したが、2025 年後半以降は Claude.ai・Claude Agent SDK・Claude Developer Platform にも拡張された。プラットフォーム間で同じスキルを再利用できるのが強みだ。

実務での活用シーン

実務では、社内の業務プロセス（契約書レビュー手順、インシデント対応マニュアル、コーディング規約）を Agent Skills にまとめ、Git で管理する運用が広まっている。新人が入社しても、Claude に社内スキルをインストールするだけで一通りの業務知識を持った状態でスタートできる。エンタープライズでは、スキルを組織全体に自動配布する管理コンソールも提供されている。

具体例

1. CI/CD トラブルシュート: ビルド失敗時の対処手順を体系化
2. 契約書レビュー: NDA や業務委託契約のチェック項目をスキル化
3. Excel 財務モデル: 予算作成の決まった手順をスキル化
4. コードレビュー: 社内規約に基づく PR レビューをスキル化
5. 顧客対応: エスカレーション基準・テンプレ文面をスキル化