Claude Skills とは何か？── AI に「専門技」を覚えさせる仕組みを、料理本のたとえで一般読者向けに 8 分でわかる

「Claude Skills って聞いたけど、ChatGPT の GPTs と何が違うの?」「プロンプトを うまく書けばいいだけじゃないの?」「自分で作る必要があるの? それとも Anthropic が用意した ものを使えばいいの?」—— 本記事では、Anthropic が 2025 年 10 月 16 日に発表したClaude Skills (Agent Skills) を、AI に詳しくない一般読者向けに整理します。 Anthropic 公式 Docs・公式ブログ・GitHub の公開リポジトリを一次情報として参照しながら、「何ができて」「何が落とし穴で」「明日から触るにはどうするか」を解説します。

本記事は Anthropic 公式ブログ「Claude Skills」(2025-10-16)・Anthropic Engineering Blog「Equipping agents for the real world with Agent Skills」・Claude API Docs 「Agent Skills Overview」・GitHub anthropics/skills 公開リポジトリ・Claude Code Skills 公式 Docs を一次情報として参照しています。一部、文脈整理のため第三者解説も参考にしましたが、 判断の核となる仕様・日付はすべて公式情報に紐づけています。

1. Claude Skills とは — 一言で言うと「AI に持たせる料理本ファイル」

【公式発表】 Anthropic 公式ブログ「Claude Skills」は、Skills を「instructions, scripts, and resources を 含む folders で、Claude が必要なときに読み込んでパフォーマンスを上げる」ものと定義しています。 Anthropic Engineering の解説では「well-organized manual(整理された分厚いマニュアル) のように、目次から章へ、章から付録へと段階的に 必要な部分だけ読む」設計だと説明されています。

【著者見解】 身近な例で言うと、料理本のたとえが一番直感的です。Claude に「世界中の料理を全部覚えておけ」と言うのは無理ですが、 本棚に「フランス料理」「和食」「製菓」と分野ごとの料理本 (Skill フォルダ)を 置いておけば、お客さんから注文が来たときに該当する 1 冊だけを開けばよくなります。 Skills とは、AI にこの「本棚と料理本」を持たせる仕組みだと理解してください。

ポイントは 「automatically when relevant (関連したら自動で使う)」 の部分です。 ユーザーが「PDF を埋めたいから pdf-skill を使え」と毎回言う必要はなく、Claude が説明欄を見て自分で「使う / 使わない」を判断します。 これがプロンプト式の指示との一番大きな違いです。

2. なぜ 2025 年 10 月に Anthropic は Skills を出したのか

【公式発表】 Anthropic 公式ブログによると、Skills は2025 年 10 月 16 日に正式発表され、2025 年 12 月 18 日に「組織全体での管理機能」と「オープンスタンダードとしての公開」が 追加されました (Anthropic Newsroom 2025-12-18)。Anthropic 自身が「Claude が general-purpose agents として fully-fledged computing environments と interact できるようになった」と説明しています。

【著者見解】 噛み砕くと、Skills が出てきた背景は、「プロンプト」と「MCP」のあいだに大きな穴があったことです。前者は会話 1 回で消えてしまい、後者は外部サーバを動かす必要があって重い。 その中間に「ファイルに書いておけば永続的に使える、サーバ不要の手順書」が 欲しいという声が 2025 年に急速に高まりました。Skills はその穴を埋めるために設計された、 と理解できます。

3. Skills の中身 — Progressive Disclosure の 3 段階ロード

【公式発表】 Claude API Docs「Agent Skills Overview」は、Skills のロードを 3 段階に 明確に分けています:

• Level 1: メタデータ (常時ロード、約 100 トークン/スキル) ──SKILL.md 冒頭の YAML フロントマター (name とdescription) のみ。Claude はこれをシステムプロンプトに含めて起動時に把握。
• Level 2: 本体指示 (発動時ロード、5,000 トークン以内) ── ユーザー要求がスキルの説明にマッチすると、Claude が bash で SKILL.md 本体を ファイル読み取りして初めてコンテキストに入る。
• Level 3: 追加ファイル (必要時のみ、実質無制限) ──SKILL.md から参照されている FORMS.md・REFERENCE.md や 実行スクリプト (fill_form.py 等)。スクリプトの中身はコンテキストに入らず、 実行結果だけが返るので大きな処理を軽量に扱える。

【著者見解】 この 3 段階設計の凄さは「スキルを 100 個入れてもコンテキスト窓を圧迫しない」点にあります。100 個 × 100 トークン = 10,000 トークン (Claude Opus 4.7 の 1M token に比べたら 1% 程度) で「使えるスキル一覧」が常時保持できる。料理本に例えると、本棚に 100 冊並んでいても、 普段見えているのは背表紙のタイトルだけで、注文が来たときに該当する 1 冊を 本棚から取り出すイメージです。

4. SKILL.md の書き方 — 一般読者でも 5 分でわかる構造

公式 Docs に載っているテンプレートはとても単純です:

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see FORMS.md.

【公式発表】 name と description には公式の制約があります:

• name: 最大 64 文字、英小文字・数字・ハイフンのみ。 XML タグ禁止。「anthropic」「claude」という単語は使用不可。
• description: 最大 1,024 文字、空文字禁止。XML タグ禁止。「何をするか」と「いつ使うか」の両方を必ず書くのが推奨。

【著者見解】 ここで一般読者が一番つまずくのは description の書き方です。「PDF を扱う」だけでは不十分で、「PDF を扱うときや、ユーザーが PDF・フォーム・文書抽出に 言及したときに使う」と書くのが正解。Claude はこの説明を読んで「今これを 使うべきか」を判断するので、料理本の「いつ開く本か」を書く目次みたいに考えてください。

この引用は「本体は薄く、付録は厚く」という Skills 設計の核心です。SKILL.md 本体に全部詰め込むと、発動するたびに 5,000 トークンが消費されて しまいます。「フォーム入力のときだけ FORMS.md を別途読む」ように分けて おけば、普段の発動コストを最小化できます。詳しくはMCP (Model Context Protocol) 完全ガイドも併読してください。

5. どこで動くか — Claude.ai / Claude Code / API の 3 つの世界

(1) Claude.ai — 一番カジュアル

【公式発表】 Claude.ai では Pro / Max / Team / Enterprise プランのユーザーが 「Settings > Features」から zip ファイルでスキルをアップロードできます (公式 Docs)。 Anthropic 公式の PowerPoint / Excel / Word / PDF スキルはセットアップ不要で裏で動いているため、「Excel ファイルを作って」と 頼むだけで自動的に xlsx スキルが発動します。

(2) Claude Code — 開発者向けに最適

【公式発表】 Claude Code はカスタムスキルのみサポート。~/.claude/skills/ (パーソナル) または.claude/skills/ (プロジェクト) にフォルダ単位で置くだけで、Claude が自動検出します。 API アップロード不要で、ファイルシステムベースで完結する点が特徴です。 Claude Code Plugins 経由で配布もできます。

(3) Claude API — 本番自動化向け

【公式発表】 API では /v1/skills エンドポイントでカスタムスキルをアップロードでき、ワークスペース全員で共有されます。利用には次の 3 つの beta ヘッダーが 必要です: code-execution-2025-08-25・skills-2025-10-02・files-api-2025-04-14。

6. ふつうの人がはじめる手順 — 既製スキルを使う or 自作する

ステップ 1: 組み込みスキルを「意識せず使う」(0 円〜)

Claude.ai Pro 以上なら、もうあなたはすでにスキルを使っています。「この Excel を整えてグラフを付けて」「PDF からテキストを抽出して」と 頼むだけで、裏で xlsx や pdf スキルが発動しています。 まずは「組み込みスキルが何ができるか」を体感するところから始めるのが最短ルートです。

ステップ 2: GitHub の公式サンプルを真似て自作 (Claude Code)

Anthropic は github.com/anthropics/skillsでオープンソースのスキルを公開しています。Claude Code ユーザーなら、好きなサンプルを~/.claude/skills/ にコピーするだけで使えます。自作するときはSKILL.md をテンプレに従って 1 枚書き、必要なら追加 md ファイルと scripts/ ディレクトリを足せば完成です。

ステップ 3: 業務独自のスキルを社内に展開 (API ワークスペース)

社内で「営業文の書き方ガイドライン」「サポート返信のトーン規定」などを Claude に 守らせたいなら、API ワークスペースにスキルをアップロードすれば全員に共有されます。 Sales Claw のような業務特化エージェントでも、フォーム送信の マナー・記入ルール・NG ワードを SKILL.md に書いておくと、Claude が 毎回確認してから送信する設計が組めます。

7. リスクと注意点 — 信頼できないスキルを入れる怖さ

【公式発表】 Anthropic Docs は明確に「Use Skills only from trusted sources (信頼できるソースの スキルだけ使え)」と警告しています。スキルは Claude に新しい能力を与えますが、 悪意あるスキルは Claude のツール (ファイル操作・bash・コード実行) を悪用してデータ流出・不正アクセス・破壊操作を行わせる可能性があります。

【未確認】 2026 年 5 月時点で「悪意あるスキルが原因の重大事故」が公式に発表された事例は 確認できていません。ただし、Anthropic が「インストールするソフトウェアと同じ重みで扱え」と わざわざ警告していること自体が、リスクが理論的に存在することを示しています。

【推測】 スキルのエコシステムが拡大するにつれて、サードパーティ製スキルの審査・配布の仕組みが 2026 年後半までに登場する可能性が高いと著者は見ています。npm のように 「公式バッジ」や「サンドボックスでの審査ログ」が整備されれば、企業の調達担当も 導入判断がしやすくなります。

(1) Zero Data Retention (ZDR) の非対象

【公式発表】 Anthropic Docs は「Skills は ZDR (Zero Data Retention) の対象外」と 明記しています。Skill 定義と実行データは Anthropic の標準データ保持ポリシーに従って保持されます。 コンプライアンス要件で ZDR が必須の業種 (金融・医療・政府等) では、Skills を使うかどうかを 事前に法務に確認するのが安全です。営業自動化文脈であれば、CAPTCHA を突破させない設計、 送信頻度の上限、特定電子メール法のオプトアウト導線の確保といった法的観点もまとめて スキルに書いておくのが堅実です。

(2) プラットフォーム別のネットワーク制約

実行環境はプラットフォームで違います: Claude API は完全にネットワーク遮断(外部 API 呼び出し不可、ランタイムでのパッケージインストール不可)、Claude Code は完全アクセス可能 (ユーザー PC と同じ権限)、Claude.ai は管理者設定次第。同じスキルでも動く環境を間違えると意図せず 動かなかったり、逆に必要以上に強い権限で動いたりします。

(3) プラットフォーム間で同期されない

前述のとおり、Claude.ai / Claude Code / API でスキルは別々に管理されます。 Claude.ai では「個人ユーザーのみ」「組織で一元管理する仕組みなし」のため、 社内で全員に統一スキルを配るには API ワークスペース or Claude Code Plugins を使う必要があります。 管理運用の設計を最初に考えておかないと、後で「人によって持ってるスキルが違う」混乱が起きます。

8. 業務利用と Sales Claw 文脈 — 営業エージェントから見た意味

【著者見解】 Sales Claw 開発の現場で見えてきたのは、「組織のやり方」をどこに書いておくかが AI 営業自動化の品質を決める、という事実です。プロンプトに書くと毎回 (高い) ロングコンテキストを 消費し、メンテも分散します。MCP サーバに実装するとオーバーキル。中間の Skills が 「営業 NG ワードリスト」「フォーム記入のマナー」「監査ログのフォーマット」のような ガイドラインを置く器として最適です。

Sales Claw 本体 (営業フォーム送信エンジン) は OSS の Python/TypeScript で実装されており Skills には依存しませんが、このブログ記事の自動執筆 (blog-write スキル) や note.com 投稿 (note-publish スキル) は Claude Code Skills として実装されています。SKILL.md に「Fatal Gate 18 項目」「Brand Editor の禁止語」「画像生成の wrapper 経由ルール」 など組織固有のガイドラインを書いておき、Claude が毎回確認してから動く構成です。

業務でスキルを採用する前のチェックリスト

まとめ — 「組織のやり方」を AI に持たせる時代に

Claude Skills は、プロンプトの軽さと MCP の永続性の中間を埋める 新しい器です。SKILL.md 1 枚から始められる手軽さと、Progressive Disclosure による効率的なコンテキスト管理。Anthropic がオープンスタンダードとして公開したことで、 2026 年以降は「組織のやり方」を AI に持たせる主流フォーマットになる可能性が 高いと著者は見ています。

次のアクション: まずは Claude.ai Pro 以上で「Excel ファイルを作って」と頼んで、 裏で組み込みスキルが動く体験をしてみてください。それで仕組みが腑に落ちたら、 Claude Code ユーザーは ~/.claude/skills/ にgithub.com/anthropics/skillsのサンプルを置いて自作の練習を。業務での営業エージェント文脈での活用例はSales Claw クイックスタートガイドか無料ダウンロードページから確認できます。

「組織のやり方」を AI に持たせる時代へ。Sales Claw の Skills 設計を、自分のリストで動かしてみよう。

無料・MIT ライセンス。インストールせずにライブデモも試せます。

無料でダウンロードライブデモを試すGitHub