Claude Skills解説:その正体と、Anthropic自身の2つのページが食い違うプラン制限の細部

Skillが機構的に何であるか

マーケティングをはぎ取ると、Skillは必須ファイルを1つ持つディレクトリだ。SKILL.mdは、最低限nameとdescriptionを含むYAMLフロントマターに続けて、Markdown形式の指示を持つ。その周りには任意で、実行可能コードのscripts/フォルダ、必要になったときだけClaudeが開くreferences/フォルダ、そのスキルが生成するもの向けのテンプレート・フォント・アイコンを収めたassets/フォルダが置かれる。Anthropic自身のプラットフォームドキュメントは、その仕組みをほぼ文字通りに説明している:モデルはbash: cat pdf-processing/SKILL.mdに相当する処理を実行する、と。特別なAPIのプリミティブではなく、ファイルシステムの読み込みにすぎない。

これが単に長いシステムプロンプトを貼り付けるのと違うのは、progressive disclosureであり、これには漠然とした安心材料ではなく実際の、文書化されたトークンコストが伴う。Anthropicのプラットフォームドキュメントはこれを3段階に分けている。レベル1は、スキルのnameとdescriptionで、インストール済みスキル1つあたり約100トークンのコストで全会話に自動的に読み込まれる。レベル2はSKILL.mdの本文全体で、Claudeがあなたのリクエストが説明と合致すると判断したときだけ読み込まれ、Anthropicはこれを5,000トークン未満に制限している(別のスキル構築ガイドでは同じ助言を5,000語未満と言い換えており、このコストを抑えることが目的だ)。レベル3は同梱の参考ファイルやスクリプトで、Claudeが実際に開いた場合にのみ読み込まれ、スクリプト自体のソースコードがコンテキストウィンドウに入ることは一切なく、実行時に標準出力に出力された内容だけが入る。Anthropic自身の32ページのスキル構築ガイドは、引用する価値のあるキッチンの比喩を使っている:「MCPはプロのキッチンを提供する:ツール、材料、設備へのアクセスだ。Skillsはレシピを提供する:一段階ずつの手順だ」。

Skillsが実際に動くのはどこか、そして必要なプラン

ここは正確さを大切にする価値がある部分だ。Anthropic自身の2つのページが、この点について異なる説明をしているからだ。Anthropicのコンシューマー向けヘルプセンターはこう述べている:「スキルはFree、Pro、Max、Team、Enterpriseの各プランのユーザーが利用できます。この機能にはコード実行の有効化が必要です」。同じ基盤機能をより技術的な表現で説明しているAnthropicの開発者向けプラットフォームドキュメントは、カスタムスキルは「コード実行が有効なPro、Max、Team、Enterpriseの各プランで利用可能」だとし、claude.aiでは「組織全体で共有されず、管理者による一元管理もできない」と付け加えている。Freeは一方の文には登場し、もう一方には登場しない。

両方を合わせて読むと、Anthropicの既成ドキュメントスキル4種(PDF、Word、Excel、PowerPoint生成)はFreeユーザーを含む全員が自動的に使える一方、自分のカスタムスキルをアップロードして実行するにはコード実行を有効にしたPro以上が必要、というのがありそうな説明だ。Freeプランで期待した場所にスキルが表示されないなら、それがバグではなくおそらくの理由だ。

Surface              Pre-built doc skills    Custom skills              Sharing model
----------------------------------------------------------------------------------------------
claude.ai              Yes, all plans          Pro/Max/Team/Enterprise    Per-user, no org
                        automatically           + code execution on       admin management
Claude Code             No (own reference       Yes, filesystem-based,    Personal (~/.claude),
                        skill ships instead)    no upload needed          project, or plugin
API                     Yes, via skill_id in    Yes, via /v1/skills       Workspace-wide, all
                        the container param     upload endpoints          members share access
Cowork / cloud          N/A                     Loads skills enabled on   Doesn't read your
sessions                                        your claude.ai account,  local ~/.claude/skills
                                                 synced at session start  unless committed to it
Enterprise (org-wide)   Inherits API behavior   Admins can push skills    Org-wide, automatic
                                                 workspace-wide since     updates
                                                 18 Dec 2025

計画しておく価値がある行は、同期が存在しないという点だ。claude.aiのSettingsパネルからアップロードしたスキルはAPI呼び出しからは見えず、APIの/v1/skillsエンドポイント経由でアップロードしたスキルはclaude.aiには表示されない。Claude Codeのスキルは自分のマシン上の単なるファイルで、個人利用なら~/.claude/skills/、リポジトリ内でチームと共有するプロジェクトスキルなら.claude/skills/に置く。Coworkのクラウドセッションは、そのリポジトリにコミットされたものしか見えず、自分のノートパソコンにあるものは見えない。1つ良いスキルを作ったら、全サーフェスで1回インストールすれば済むとは考えず、実際に使うサーフェスごとに再インストールする前提でいるべきだ。

今すぐインストールして使う方法

• claude.aiでは: Settings → Capabilities(アカウントによっては「Features」と表示)→ Skillsに進み、Anthropic自身のディレクトリを開く「Browse skills」か、自分で作った・入手したzip化フォルダを追加する「Upload a skill」を選び、トグルをオンにする。
• Claude Codeでは: 個人用スキルなら~/.claude/skills/<name>/SKILL.mdを作成すると再起動なしで即座に検知される。バージョン管理でチームと共有するなら、リポジトリ内の.claude/skills/<name>/SKILL.mdに置く。公式のAnthropicスキルはプラグインマーケットプレイス経由でインストールできる:/plugin marketplace add anthropics/skillsの後、/plugin install document-skills@anthropic-agent-skillsを実行する。/skill-nameで明示的にスキルを呼び出すか、リクエストが説明に合致したときにClaudeに自動読み込みさせる。
• APIでは: Messages APIの呼び出しのcontainerパラメータ内で、コード実行ツールと合わせてAnthropicの既成スキルをskill_id(pdf、docx、pptx、xlsx)で参照するか、Consoleの/v1/skillsエンドポイントを通じてカスタムスキルをアップロードしてワークスペース全体で共有する。
• 自分でスキルを作るには: スキルを作るためのAnthropicのメタスキルであるskill-creator自体を使う。よく繰り返す作業を平易な言葉で説明すれば、正しい形式のSKILL.mdが組み立てられ、descriptionのトリガー表現が提案され、確実に発火させるには曖昧すぎる言い回しにはフラグが立つ。Anthropic自身のガイドは、自分がよく繰り返す上位2、3のタスクさえ分かっていれば、これは15〜30分の作業だとしている。

Skills対MCP対Custom GPTs対Gemini Gems

Skillの正体を実際に明確にしてくれる比較は、Anthropicが自社のMCP(Model Context Protocol)と対比させて描いているものだ:「MCPはClaudeを外部サービスやデータソースに接続します。Skillsは手続き的な知識、つまり特定のタスクやワークフローをどう完了させるかの指示を提供します。両者は一緒に使えます:MCP接続はClaudeにツールへのアクセスを与え、スキルはそのツールを効果的に使う方法をClaudeに教えます」。機構的に言えば、MCPは新しいツールを公開するプロトコルであり、プライベートAPIを呼び出すような、Claudeが本来できなかった能力を本当にもたらす。Skillは、Claudeがすでに実行できるツール呼び出しをどう並べるかを教える、プロンプト内容と任意のコードだ。それが、以下で扱う懐疑的な議論の正直な核心だ:背後にスクリプトもMCP接続も持たないスキルは、十分に詳細な単発のプロンプトでもできないことを何も実行できない。その価値は新しい能力ではなく、パッケージ化とコンテキスト効率の良い再利用にある。

                 Claude Skills             MCP                      Custom GPTs (OpenAI)   Gemini Gems
-----------------------------------------------------------------------------------------------------------
Grants new        No - packages prompting   Yes - exposes new        No - system prompt +    No - saved
capability?       Claude already has        tools/API access         optional Actions        persona/prompt
Invocation        Automatic, matched to     Always-on connection     Manual - pick the GPT   Manual - switch
                  your request's wording    once configured          from a list             into the Gem
Portable across   Yes in spirit (open       Yes, it's a protocol,    No - ChatGPT only       No - Gemini
tools?            agentskills.io standard), works with any MCP                                ecosystem only
                  but doesn't sync accounts client
Entry cost        Pro+ for custom skills,   Varies by server, often  ChatGPT Plus/Team/       Included with
                  code execution required   free/self-hosted         Enterprise               most Gemini plans
Instruction       ~5,000 words recommended  N/A - it's a tool        Knowledge files, no      Reportedly capped
length limit      per SKILL.md              connection, not a prompt hard length limit stated ~4,000 characters

Gemini Gemsの最後の行には注釈が必要だ:これはGoogle公式の仕様書ではなく、第三者による比較記事に由来する数字なので、確定した上限ではなく報告されたおおよその値として扱うべきだ。

これは単なる高度なプロンプティングなのか?懐疑派の言い分

最も実質を伴う公の批判はSibylline Softwareの「Claude Skills Considered Harmful」であり、著者自身が後に一部を撤回しているため、見出しだけで済ませず読む価値がある。その中核的な主張はこうだ:スキルはあなたの文書化されたワークフローをAnthropic自身のランタイムに結びつけてしまい、移行や監査を素のファイルより難しくする。そして直接引用すると「Skillがなぜトリガーされたのか、それがモデルの推論にどう影響しているのかは、あなたには一切見えない」とし、Skillsは「イノベーションのふりをした、顧客を囲い込むためのマイクロ最適化だ」と結論づけていた。提案されていた代替案は、どのモデルでも読める、人間が監査可能で1社のランタイムに縛られない、プレーンでバージョン管理されたREADME.mdの階層だった。

この記事にはAnthropicがフォーマットを開放した後に追加された、著者自身による追記がある:「この記事を書いた後、Anthropicはスキルの仕様をオープンにし、Codexもそれをサポートするようになった。私は今もスキルは過大評価されていると思うが、積極的に有害だとはもう思わない」。ベンダーロックインという議論は、もとの批判の中で最も重みのある部分だったが、SKILL.md形式がオープンな標準(agentskills.io)になり、Claude以外のエージェントツールもそれを実装し始めたことで、大きく揺らいだ。撤回の後にも残っているのは、上のセクションで扱ったより限定的で、今も正確な論点だ:コードもツールアクセスも背後に持たないSkillは条件付きで読み込まれるプロンプティングにすぎず新しい能力ではない、という点であり、Anthropic自身の説明もそれを否定するのではなく、暗黙のうちに認めている。

知っておく価値のある実在のスキル(具体名で)

Anthropicは既定で4つの既成スキルを提供している。PDF、Word、Excel、PowerPointの生成で、Markdownを文書らしく整形したものではなく、本物のネイティブ形式の出力を意味する。それらに加えて、skill-creator(スキルを作るためのメタスキルで、最初にインストールする価値がある)とfrontend-design(コーディングタスク向けのインターフェース品質プロンプティング)はAnthropic自身のものだ。APIには、8言語にわたってSDKの使い方を最新に保つオープンソースのリファレンススキルも用意されている。

コミュニティ層は、マーケティングページが示唆するよりも大きく、より具体的だ。上でスクリーンショットを載せたComposioHQのawesome-claude-skillsリポジトリは、現時点で74.5kのスターと8.6kのフォークという実際に確認できる、開発者の注目度を示す本物のシグナルを伴っており、名前付きで作者が明記されたスキルとして、gitコミットをユーザー向けのリリースノートに変換するChangelog Generator、平易な言葉での説明からPythonまたはTypeScriptでMCPサーバーをスキャフォールドするMCP Builder、SEOからデプロイまでウェブサイトのライフサイクル全体をカバーする59スキルのBrand Build Skillsライブラリ、そしてSentryのIssue、イベント、プロジェクト、リリース、アラートをClaudeから直接管理するパートナー製スキルのSentry Automationを掲載している。これとは別のパートナー製スキルSentry Code Reviewは、このリポジトリではなくSentry自身のプラグインディレクトリに掲載されており、SentryのMCPサーバーを使って実際の本番環境のエラーデータをもとにGitHubのプルリクエストのバグを自動分析・修正する。

より選別が効いている情報源は、開発者Suraj Khaitan氏による「I Tried 100 Claude Skills」で、テストした各スキルを、安全姿勢(意外なネットワーク呼び出しをしていないか、不透明なバイナリを同梱していないか)を含む5軸のルーブリックで採点している。彼自身が報告した淘汰率は、業界全体ではなく彼個人がテストした約100件のバッチにおいて、2軸以上で5点満点中3点未満だったものがおよそ70%だった。彼のトップピックは、埋め込みパーサーによって幻覚のフォームフィールドを避けられる「私を信者にしたスキル」と評したPDF、DOCX/PPTX/XLSX、他のどのスキルより先にインストールすべきだと言うskill-creator、mcp-builder、そしてWebアプリをエンドツーエンドでスモークテストするPlaywright駆動のブラウザ自動化スキルwebapp-testingだ。

何が壊れるのか、そして誰もが繰り返すセキュリティ警告

Anthropic自身のプラットフォームドキュメントは、決まり文句としてではなく、このリスクを率直に述べている:「信頼できる情報源からのSkillsのみを使用してください:自分で作成したものか、Anthropicから入手したもの……悪意のあるSkillは、そのSkillの明言された目的と一致しない形でツールを呼び出させたり、コードを実行させたりするようClaudeに指示できます」。外部URLを取得するスキルは特にリスクが高いとフラグを立てており、取得したコンテンツには埋め込まれた指示が紛れている可能性があるためだと説明している。また、正当なスキルであっても、依存している外部要素が後で変わればリスクを帯びる可能性があると警告している。Khaitan氏の独立したテストも外部からこれと同じ結論に達している:彼はインストール前にすべての同梱スクリプトを監査し、依存関係を固定し、実行をサンドボックス化し、「パートナーバッジをマーケティングとして扱い、保証としては扱わない」ことを推奨している。実際にコードを読むことの代わりにはならない、という点も含めてだ。

Enterpriseアカウントには部分的な緩和策がある:Anthropicはスキルのコンテンツスキャンを提供しているが、それはclaude.aiとCowork経由のアップロードに限られ、APIやConsole経由でアップロードされたスキルは対象外だ。API経由でプッシュされたワークスペース全体向けのカスタムスキルは、このスキャナーをまったく通過しない。

• コンテキストコストは量に応じて積み上がる。 Anthropic自身のガイドは、同時に有効なスキルがおよそ20〜50個を超えると実際に応答品質の低下が見られると警告し、すべてをオンにしたままにするのではなく、今使っていないスキルは無効化することを推奨している。
• 発火不足・発火過多は、対処法が定められた既知の失敗モードだ。 一度も発火しないスキルには、ユーザーが実際に打ち込む言い回しをより多く盛り込んだ鋭いdescriptionが必要であり、発火しすぎるスキルには、同じフィールドに明示的な否定トリガー(「〜には使用しないこと」)を加える必要がある。
• スキルの内容はセッション中にリフレッシュされない。 Claude Codeがすでに現在の会話で読み込んだ後にスキルファイルを編集しても、変更を反映させるには明示的に再度呼び出す必要がある。
• 正確なファイル名と予約名が重要だ。 SKILL.mdはその通りの綴りで、大文字小文字も区別して書かなければならない。さもないとAnthropic自身のトラブルシューティングガイドによれば「Could not find SKILL.md in uploaded folder」というエラーになる。スキル名はケバブケースでスペースや大文字を含んではならず、「claude」や「anthropic」を含む名前は予約語として一律に拒否される。

Skillsを使うべきでないとき

• タスクが本当に一度限りの場合。 プロンプトをスキルにパッケージ化する価値が出るのは、そうしなければ複数の会話にわたって同じ指示を打ち直すことになる場合だけだ。
• 本当に必要なのが、より整理されたプロンプティングではなく新しい能力の場合。 それはスキルの仕事ではなくMCPサーバーの仕事だ。スキルをインストールしても、Claudeがもともと到達できなかったシステムにアクセスできるようにはならない。
• Freeプランでカスタムスキルが欲しい場合。 上記のプラン制限の食い違いを踏まえると、Anthropicの一部のページがそう示唆していないとしても、カスタムアップロードにはコード実行が有効なPro以上が必要だと想定しておくほうが安全だ。
• インストール前にそのスキルの同梱スクリプトを読むことができない、あるいは読む気がない場合。 これはAnthropic自身のセキュリティ指針と、実際にコミュニティ製スキルを監査したすべての独立したテスターが、例外なく一致している一点だ。

よくある質問

Claude Skillsとは何ですか?

Skillとは、必須の指示ファイルであるSKILL.mdに、任意のスクリプト、参考資料、テンプレートを加えたフォルダです。Claudeはスキルの名前と説明を全会話に自動的に読み込み、リクエストが合致したときだけ完全な指示を読み込みます。この仕組みはprogressive disclosure(段階的開示)と呼ばれます。

Claude Skillsは追加料金がかかりますか、どのプランが必要ですか?

Anthropicの既成ドキュメントスキル(PDF、Word、Excel、PowerPoint)はFreeを含む全プランで動作します。自分で作成またはダウンロードするカスタムスキルには、Anthropicの開発者向けプラットフォームドキュメントによれば、コード実行を有効にしたPro、Max、Team、Enterpriseのいずれかが必要です。コンシューマー向けヘルプセンターの記述はこの点についてやや不正確です。

SkillとMCPサーバーの違いは何ですか?

MCPは、Claudeが本来到達できない外部のツールやデータに接続する、本物の新しい能力です。Skillは、Claudeがすでに持っている能力をどう使うかの指示をパッケージ化したものであり、スクリプトやMCP接続を同梱しない限り、それ自体では新しい能力を付与しません。

GitHub上のClaude Skillsをインストールするのは安全ですか?

監査するだけの信頼を置ける情報源からのものに限られます。Anthropic自身のドキュメントは、悪意のあるスキルがその明言された目的と一致しないコードをClaudeに実行させる可能性があると警告しており、特に外部URLを取得するスキルに注意を促しています。数十のコミュニティ製スキルを試した独立のテスターは、インストール前にすべての同梱スクリプトを読むことを推奨しています。GitHubのスター数やパートナーバッジは安全性の保証にはならないからです。

Claude Skillsは同時にいくつまでインストールできますか?

Anthropic自身の指針は、同時に有効なスキルがおよそ20〜50個を超えると、コンテキスト負荷から応答品質が低下し始めるという緩やかな上限を示しています。すべてをオンにしたままにせず、今使っていないスキルは無効化してください。

Claude SkillsはChatGPTやGeminiでも使えますか?

いいえ、SkillsはClaude固有の機能ですが、その基盤となるSKILL.md形式はオープンな標準(agentskills.io)であり、Anthropic以外の一部のエージェントツールも独自にこれを採用し始めています。