Claude Agent Skillsとは：仕組み・導入先・作り方を整理¶

対象 / ポイント

対象: 同じ手順や専門知識をClaudeに繰り返し使わせたい利用者、開発者、管理者

ポイント:

Skillは、指示、メタデータ、任意のスクリプトや資料をまとめたファイル群である
必要なSkillだけを段階的に読み込むため、大量の資料を常時プロンプトへ入れずに済む
claude.ai、API、Claude Codeでは配置、共有範囲、実行環境が異なり、自動同期しない

Claude Agent Skillsは、Claudeへ再利用可能な専門手順を追加する仕組みだ。一回限りのプロンプトと違い、Skillはファイルシステム上のパッケージとして保存され、関連する依頼で自動的に使われる。¹

Skillが向くのは「毎回同じ長い指示を書く」作業である。たとえば社内レポートの構成、PDF検査、データ変換、ブランド表現の確認を、手順と検証コードごとまとめられる。

Skillの中身¶

最小のSkillには SKILL.md が必要で、YAMLフロントマターに name と description を持つ。

monthly-report/
├── SKILL.md
├── references/
│   └── metric-definitions.md
├── scripts/
│   └── validate_rows.py
└── assets/
    └── report-template.xlsx

要素	役割
`name`	Skillの識別子。小文字、数字、ハイフンを使う
`description`	何を行い、どんな依頼で使うかを示す発火条件
`SKILL.md` 本文	作業順序、判断基準、出力形式、検証手順
`references/`	必要なときだけ読む仕様、定義、例
`scripts/`	反復処理や検証を決定的に実行するコード
`assets/`	テンプレート、画像、成果物の素材

description は紹介文ではない。Claudeが依頼との一致を判断する主要な入口である。「何をするか」だけでなく「どの状況で使うか」まで具体的に書く。¹

段階的開示の3層¶

Skillsは、情報を一度にすべて読み込まない。

メタデータ: name と description は常に参照される
本文: 依頼が一致してSkillが発火したときだけ SKILL.md を読む
追加資料・コード: 本文から必要と判断したファイルだけを読む、またはスクリプトを実行する

この構造により、専門資料を複数のSkillへ分けても、無関係な本文が毎回コンテキストを占有しない。¹ ただしメタデータは常に載るため、役割の重なるSkillを大量に入れると発火判断が曖昧になる。

どこで使うか¶

「どこか1箇所へ登録すれば全Claude製品へ同期する」という理解は誤りである。

利用面	導入方法	共有範囲	主な制約
claude.ai	Settings > Featuresからzipを追加	利用者個人	Pro、Max、Team、Enterprise。code executionが必要
Claude API	Skills APIへアップロードし、containerで指定	APIワークスペース	code executionとbeta headerが必要。実行時ネットワークなし
Claude Code	`~/.claude/skills/` または `.claude/skills/` に配置	個人またはプロジェクト	端末の権限とネットワークを引き継ぐ

claude.aiへ追加したSkillはAPIへ現れず、APIのSkillもclaude.aiへ現れない。 Claude CodeのSkillはローカルファイルであり、どちらとも別管理になる。¹

AnthropicのPowerPoint、Excel、Word、PDF用の事前構築Skillは、claude.ai、API、Claude Platform on AWS、Microsoft Foundryで利用できる。 Claude Codeではこの事前構築文書Skill群は提供されず、カスタムSkillを使う。¹

最初のSkillを作る手順¶

1. 反復作業を1つ選ぶ¶

入力と成功条件を説明できる、小さな作業から始める。

入力: CSVの月次利用データ
出力: 部門別サマリーと異常値一覧
成功条件: 元行数と集計行数が一致し、欠損値が明示される

2. `description` で発火範囲を定義する¶

対象ファイル、利用場面、成果物を含める。隣接Skillと競合する場合は、使わない場面も本文で整理する。

3. 本文を作業順に書く¶

背景説明を長くするより、入力確認、実行、検証、出力の順に書く。柔軟な判断は文章、壊れやすい反復処理はスクリプトへ分ける。²

4. 正常系と境界例で試す¶

典型的な依頼で発火するか
明示的に名前を呼ばなくても発火するか
似ているが対象外の依頼で誤発火しないか
入力欠損や空データで安全に止まるか
出力を機械的に検証できるか

5. 配布先ごとに導入する¶

利用面は自動同期しない。claude.ai、API、Claude Codeのどこで使うかを決め、その面の配布と更新手順を持つ。

セキュリティ¶

Skillは単なる文章ではない。スクリプト実行、ファイル読み書き、外部ツール利用をClaudeへ指示できるため、ソフトウェアと同じように審査する。¹

SKILL.md だけでなく、すべてのスクリプト、資料、素材を読む
外部URL、依存パッケージ、シェルコマンド、書き込み先を確認する
Skillの説明と一致しない通信やファイルアクセスを拒否する
本番データでは最小権限と隔離環境を使う
更新時に差分レビューと再テストを行う

APIのSkills実行環境にはネットワークアクセスがなく、実行時のパッケージ追加もできない。一方、Claude CodeのSkillは端末上の通常プログラムと同じネットワーク条件を持つ。設計は利用面ごとに変える必要がある。¹

Agent SkillsはZero Data Retentionの対象外である。ZDRが必須のAPIワークロードでは採用前に保持条件を確認する。¹

まとめ¶

Skillは手順、資料、コードをまとめる再利用可能なファイルパッケージである
description が発火を担い、本文と追加資料は必要時だけ読まれる
claude.ai、API、Claude Codeでは配置と共有範囲が違い、自動同期しない
外部Skillはソフトウェアとして全ファイルを審査する

最初から巨大な万能Skillを作る必要はない。1つの反復作業を選び、成功条件を固定し、発火と出力をテストできる形から始める。