この記事でわかること

  • claude.aiでは「コード実行とファイル作成」をオンにしたうえで、Customize > Skills からZIPを上げてトグルでオンにします
  • Claude Codeでは ~/.claude/skills/<名前>/SKILL.md(自分用)か .claude/skills/<名前>/SKILL.md(プロジェクト用)に置くだけで読み込まれ、別途オンにする操作は要りません(/skills メニューや skillOverrides で個別にオフにすることはできます)(Claude Code Docs 2026-11-04)
  • SKILL.mdは name と description のフロントマター+手順の本文で、claude.aiと共用するならフロントマターは公式が認める6項目に絞ります
  • 呼び出しは「descriptionに合う依頼でClaudeが自動で読む」と「/名前 で自分が呼ぶ」の2通りで、Claude Codeでは disable-model-invocation: true で自動を止められます
  • 発動しない・グレーアウトしているときに、どの設定と項目を見ればよいかがわかります

結論を先に書くと、Skillsの中身(SKILL.mdの形式)は同じでも、claude.aiとClaude Codeでは有効化・置き場所・使えるフロントマター項目が違います。最初の1本は name と description だけの最小構成で書き、両方で同じファイルを使い回すのが安全です。


1. 一次資料の対応表

この記事は、手元で発動テストをした記録ではなく、公式ドキュメントの照合で書いています。企画段階では同じスキルを両方に置いて発動回数を比べる予定でしたが、この版では実施していません。そのため「実測結果」の表は置かず、確認した一次資料を先に並べます。

主張一次資料種別確認日
Claude Codeのスキルの置き場所、フロントマター全項目、呼び出しの仕様、トラブルシューティングExtend Claude with skills公式ドキュメント2026-11-04
Agent SDKでのスキルの読み込み、skills オプション、allowed-tools の扱いExtend agents with skills公式ドキュメント2026-11-04
claude.aiでの有効化手順、ZIPのアップロード、共有、グレーアウト時の確認先Use skills in ClaudeHelp Center2026-11-04
Skillsの定義、対象プラン、種類What are skills?Help Center2026-11-04
skill.mdの必須項目と文字数、ZIPのフォルダ構成、テストの手順How to create custom skillsHelp Center2026-11-04
段階的な読み込みとトークン量、nameの文字種、面ごとの同期、セキュリティAgent Skills(overview)公式ドキュメント2026-11-04
発表日と当初の対象プランIntroducing Agent Skills公式ブログ2026-11-04
公式のサンプルスキルとライセンスanthropics/skillsGitHub2026-11-04

https://www.anthropic.com/news/skills はHTTP 308で claude.com/blog/skills へ転送されたため、転送先を読みました。Help Centerの3ページは更新日が「Updated this week」とだけ表示され、正確な日付は出ていません。


2. Claude Skillsとは(3行で)

  • Help Centerの定義は「Claudeが専門的な作業の精度を上げるために動的に読み込む、指示・スクリプト・リソースのフォルダ」です(What are skills? 2026-11-04確認)
  • 普段はスキルの名前と説明(1本あたり約100トークン)だけが読み込まれ、依頼に合ったときに本文(目安は5,000トークン未満)、さらに必要なら同梱ファイルが読まれます(Agent Skills overview)
  • 形式はagentskills.ioで公開されたオープン標準「Agent Skills」に沿っています。Anthropicの公式ブログは、発表日を2025年10月16日としています(Introducing Agent Skills)

3. できることとほかの機能との分担

Claude Codeのドキュメントは、スキルを作る場面を「同じ指示やチェックリストを何度もチャットに貼っているとき」、または「CLAUDE.mdの一部が事実ではなく手順になってきたとき」と説明しています。CLAUDE.mdとの違いは、スキルの本文が使われるときにだけ読み込まれる点です(Extend Claude with skills)。

機能何を持たせるかいつ読み込まれるか主な場所
Skills手順・書式・チェックリストと付属ファイル説明は常時、本文は使うときだけclaude.ai / Claude Code / API
CLAUDE.mdそのリポジトリの事実と決まり事セッション開始時に毎回Claude Code
プロジェクト指示文とナレッジ(資料)指示文はプロジェクト内の会話に適用。ナレッジの読み込み方は条件によるclaude.ai
MCP外部サービスやデータへの接続クライアントと設定による。Claude Codeは既定でツール名だけを読み、定義は必要時に取得各クライアント

CLAUDE.mdの書き方はClaude Codeの使い方の記事、プロジェクトはClaudeプロジェクトの使い方、MCPはMCPとはで扱っています。

Anthropicが用意したスキルとして、Help CenterはExcel・Word・PowerPoint・PDFの作成と処理を挙げています。これらは呼び出し操作が要らず、依頼内容からClaudeが必要と判断して使います(Use skills in Claude)。一方、API側の資料には「この文書系の既製スキルはClaude Codeでは使えない」と書かれています(Agent Skills overview)。ただし公式GitHubのanthropics/skillsは、これらの文書スキルを参考実装として公開しており、Claude Codeに /plugin install document-skills@anthropic-agent-skills で入れる手順を載せています。


4. 第1章 有効化の手順(claude.ai/Claude Code別)

4-1. 使う場所ごとの対応表

項目claude.ai(Web・デスクトップ・モバイル)Claude CodeAPI・Agent SDK
対象プランFree・Pro・Max・Ultra・Team・Enterprise(Help Center 12512180/12512176)。ただしAPI側overviewはPro・Max・Ultra・Team・Enterpriseと記載(食い違い)プランの区別の記載なしAPIはcode execution toolを使う全ユーザー(Help Center)
有効化の画面個人: Settings > Capabilities → Customize > Skills。組織: Organization settings > Plugins & skills の「Policy」タブ(12512180)。overviewは「Settings > Features」と記載(食い違い)画面なし。フォルダに置けば読み込まれるSDKは既定で user / project のスキルを読み込む(settingSources を明示的に指定する場合は user / project を含める必要がある)(Agent SDK Docs 2026-11-04)
前提条件「Code execution and file creation」がオン。新しい設定画面では「Create and edit files」という名前(12512180)なしAPIはcode execution toolを併用
置き場所・追加方法ZIPをアップロード。ZIPの直下はスキルのフォルダ(12512198)~/.claude/skills/ か .claude/skills/ の下に <名前>/SKILL.mdSDKはClaude Codeと同じフォルダ。APIは /v1/skills で登録
呼び出し方自動。Microsoft 365アドインでは / で選択(12512180)自動と /名前 の両方SDKは自動と /名前 の送信
allowed-tools受け付ける6項目に含まれる。効き方の記載は確認できず呼び出したターンの間、確認なしで使えるツールSDKでも事前承認として効く(SDK文書)
共有Team・Enterpriseで個人・グループへ共有(閲覧のみ)。組織ライブラリへの配布は別操作の「Publish to org」.claude/skills/ をコミット、プラグイン、管理設定で配布APIはワークスペース全体で共有
組織管理者の設定Skills、Skill sharing、User-created skills、Publishingの各設定managed settingsのディレクトリに置くと全員に配布―

企画段階では「allowed-tools はClaude Code CLIでだけ効く」とSDK文書に書かれている想定でした。2026-11-04に読んだ版のSDK文書には、逆に「SDKセッションでもフロントマターの allowed-tools で事前承認できる」と書かれています(Extend agents with skills)。

4-2. claude.ai(個人のFree・Pro・Max・Ultra)

  1. Settings > Capabilities を開き、「Code execution and file creation」(新しい設定画面では「Create and edit files」)をオンにします
  2. 左側の Customize から Skills を開きます
  3. Anthropicのスキルやアップロード済みのスキルが一覧に並ぶので、使うものをトグルでオンにします

成功すると、スキルが一覧に表示され、トグルで切り替えられる状態になります。手順はUse skills in Claudeに沿っています。Free版での上限など、そのほかの使い方はClaudeの使い方の記事を参照してください。

4-3. claude.ai(Team・Enterprise)

  1. 組織のオーナーが Organization settings > Plugins & skills の「Policy」タブを開きます
  2. 「Cloud code execution and file creation」と「Skills」の両方をオンにします
  3. メンバーは各自の Customize > Skills でスキルをオンにします

Help Centerによると、Teamでは組織単位で既定でオンです。Enterpriseはオーナーが2つの設定を確認する必要があります。同じページの中でも、前提条件の節は「Code execution and file creation」、手順の節は先頭にCloudを付けた「Cloud code execution and file creation」と書いていて、表記が揃っていません(Use skills in Claude)。

4-4. Claude Code

別途オンにする操作は要りません(/skills メニューや skillOverrides で個別にオフにすることはできます)。次の場所にフォルダを作れば読み込まれます(Extend Claude with skills)。

種類パス効く範囲
個人~/.claude/skills/<名前>/SKILL.mdそのマシンのすべてのプロジェクト(Coworkとクラウドセッションは対象外)
プロジェクト.claude/skills/<名前>/SKILL.mdそのリポジトリのセッション。コミットすればチームにも届く
プラグイン<プラグイン>/skills/<名前>/SKILL.mdプラグインが有効な場所で /プラグイン名:スキル名
組織managed settingsディレクトリ内の .claude/skills/組織が配布したマシンの全ユーザー

同じ名前が重なったときは「組織 > 個人 > プロジェクト」の順に優先されます。旧来の .claude/commands/deploy.md と .claude/skills/deploy/SKILL.md が両方あれば、スキルが優先です。


5. 第2章 最初のSKILL.mdを書いて置く

例として、日本語の原稿を決めた表記ルールで点検するスキル jp-style-check を作ります。コードブロックの中は英語で書いていますが、本文は日本語で書いても構いません。

5-1. フォルダ構成

jp-style-check/
├── SKILL.md
└── rules.md

rules.md には表記ルールの一覧を書き、SKILL.mdから参照させます。Claude Codeのドキュメントは、SKILL.mdを500行未満に収め、詳しい資料は別ファイルに分けるよう勧めています。

5-2. SKILL.md(claude.aiとClaude Codeで共用できる最小構成)

---
name: jp-style-check
description: Check Japanese drafts against the house style rules in rules.md. Use when the user asks to proofread, check notation, or review a Japanese article before publishing.
---

# Japanese style check

1. Read rules.md in this skill folder.
2. Read the draft the user provided.
3. List every violation as a table: line, original text, rule id, suggested fix.
4. Do not rewrite the whole draft. Only report violations.
5. End with the total number of violations.

書くときの決まりは、公式ページごとに上限の数字が違います。

項目Help Center(12512198)API側overviewClaude Code
ファイル名「skill.md」と小文字で表記SKILL.mdSKILL.md
name64文字まで。例は「Brand Guidelines」(空白あり)64文字まで。英小文字・数字・ハイフンのみ。anthropic と claude は使えない省略時はフォルダ名。/ メニューに出る名前
description200文字まで1,024文字までwhen_to_use と合わせて一覧では1,536文字で切られる

いちばん厳しい側に合わせると、name は少なくとも英小文字・数字・ハイフンのみで64文字以内、description は200文字以内にする必要があります(ここに挙げたのは上の3資料から拾える条件で、規則のすべてではありません)。上の例の description は200文字に収めています。Help Centerの例は名前に空白を含み、API側の規則と食い違うため、両方で使うならハイフン区切りにしておくのが無難です。

5-3. claude.aiに置く

  1. フォルダ名を name と同じ jp-style-check にします
  2. フォルダごとZIPにします。ZIPを開いた直下にファイルが並ぶ形はHelp Centerが誤りの例として挙げています
  3. Customize > Skills で「+」→「+ Create skill」→「Upload a skill」を選び、ZIPを上げます
  4. 一覧に表示されたらトグルをオンにします
cd ~/work
zip -r jp-style-check.zip jp-style-check
unzip -l jp-style-check.zip

unzip -l の出力で、各パスが jp-style-check/SKILL.md のようにフォルダ名から始まっていれば、構成は正しい形です。

5-4. Claude Codeに置く

mkdir -p ~/.claude/skills
cp -r ~/work/jp-style-check ~/.claude/skills/
ls ~/.claude/skills/*/SKILL.md

Claude Codeはスキルのフォルダを監視していて、セッション中に追加・編集しても再起動なしで反映します。ただし、セッション開始時に存在しなかった最上位の skills ディレクトリを新しく作った場合は、/reload-skills を実行します(Extend Claude with skills)。


6. 第3章 呼び出し方は2通り

6-1. 自動で使わせる

既定では、スキルの description が常にClaudeに見えていて、依頼が説明に合うとClaudeが本文を読み込みます。claude.aiではこの方法が基本で、Help Centerは「Claudeの思考を見て、スキルを読み込んだか確認する」ことをテスト手順に入れています(How to create custom skills)。

6-2. /名前 で自分が呼ぶ(Claude Code)

メッセージの先頭に /jp-style-check draft.md と打つと、そのスキルが直接実行されます。文の途中に /jp-style-check を書いた場合は直接の実行にはならず、「そのメッセージでそのスキルを使ってよい」という許可として扱われます。引数は本文中の $ARGUMENTS に入り、プレースホルダが無ければ末尾に ARGUMENTS: <値> として付け足されます(Extend Claude with skills)。

6-3. どちらに寄せるかを決めるフロントマター

設定自分が呼べるかClaudeが自動で呼ぶか説明が常時読み込まれるか
既定はいはいはい
disable-model-invocation: trueはいいいえいいえ
user-invocable: falseいいえ(/ メニューに出ない)はいはい

disable-model-invocation の既定値は false です。true にすると、サブエージェントへの事前読み込みや、セッション内の予約タスクからの実行も止まります。デプロイやコミットのように、Claudeの判断で勝手に動いてほしくない手順に向いています。説明文がコンテキストに載らなくなるので、スキルが多いときの一覧の圧迫も減ります。

注意点として、この項目はClaude Code専用です。claude.aiへのアップロード、Skills API、package_skill.py が受け付けるのは name・description・license・compatibility・metadata・allowed-tools の6項目だけで、それ以外の項目があるとエラーになります。公式ドキュメントが挙げる文言は次のとおりです。

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

Claude Code用に disable-model-invocation を付けたSKILL.mdを、そのままZIPにしてclaude.aiに上げると、この種のエラーに当たる構成になります。両方で使うなら、Claude Code側だけ別ファイルにするか、最小構成のまま使います。


7. つまずいた箇所と対処

この節の文言は、公式ドキュメントに記載されたものです。手元の画面で出た表示ではありません。

症状原因対処
claude.aiでスキルがグレーアウトしている考えられる原因の一つは、コード実行が組織単位(Team・Enterprise)または個人でオフになっていることオーナーに依頼するか、Settings > Capabilitiesでコード実行をオンにする(12512180)
Skillsの欄が見えない同上の設定がオフ個人はSettings > Capabilities、組織はPlugins & skillsの「Policy」タブを確認(12512180)
スキルを作れない・アップロードできない組織で「User-created skills」がオフ、またはEnterpriseのカスタムロールに「Create skills」権限がない管理者に設定を確認してもらう(12512180)
ZIPのアップロードが失敗する「ZIP file exceeds size limits」「Skill folder name doesn’t match the skill name」「Missing required skill.md file」「Invalid characters in skill name or description」フォルダ名と name を揃え、ZIP直下をフォルダにする。サイズ上限の具体的な数字は本文テキストからは確認できなかった(12512180)。APIのSkills guideではアップロード上限が非圧縮の全ファイル合計で30MBとされている(claude.aiのZIP上限とは別の資料)(Claude Docs 2026-11-04)
「Unexpected key(s) in SKILL.md frontmatter」Claude Code専用の項目を含めたまま、claude.aiやAPIに上げた6項目以外を削る(skillsドキュメント)
Claude Codeで自動発動しない説明に依頼で使う言葉が入っていない、YAMLの書式が壊れている説明に依頼の言葉を入れる。「What skills are available?」と聞いて一覧に出るか確認。--debug で起動してパースエラーを見る
/名前 が認識されないClaude Codeがスキル名を拒否した、または<や>、ゼロ幅スペースなどが含まれる名前から該当の文字を除き、claude plugin validate .claude/skills で検査(v2.1.233以降)
呼んでいないのに発動しすぎる説明が広すぎる説明を具体的にするか、disable-model-invocation: true を付ける
説明が途中で切れるスキル一覧の予算(既定でコンテキストの1%)を超えたskillListingBudgetFraction で予算を上げる。/doctor で一覧の消費量を見る
個人スキルが消えたv2.1.280より前の不具合で .trash へ移動していた~/.claude/skills/.trash/ を確認(既定で30日後に削除)

Claude Codeでは、YAMLの書式が壊れていてもスキル本体は空のメタデータで読み込まれます。そのため /名前 では動くのに、自動では一度も発動しない状態になります(Extend Claude with skills)。「手動では動く・自動では動かない」なら、まずフロントマターの書式を疑うのが近道です。


8. ケース別の使い方

用途スキルに入れるもの呼び出しの寄せ方
社内の手順書(経費精算、障害の一次対応)手順を番号で書いた本文と、申請先や連絡先の一覧ファイル自動。説明に「経費」「障害」など依頼で使う言葉を入れる
定型のレビュー(PRの観点、原稿の表記)観点のチェックリストと、出力する表の形式Claude Codeでは /名前 中心。誤発動が気になれば disable-model-invocation: true
資料の書式(社内テンプレートのスライドや報告書)色・フォント・構成の決まりと、テンプレートファイル自動。claude.aiの文書作成スキルと一緒に使われる
チームの決まり事(コミットメッセージ、ブランチ名)書式の規則と良い例・悪い例.claude/skills/ に置いてリポジトリにコミット

Help Centerは、スキルどうしを明示的に参照し合うことはできないが、Claudeが複数のスキルを自動で組み合わせて使うことはあると説明しています(How to create custom skills)。1本に機能を詰め込まず、用途ごとに分けておけば、説明文も具体的に書けます。


9. 共有と注意点・セキュリティ

9-1. 共有の方法

  • claude.ai(Team・Enterprise)は、Customize > Skillsで該当スキルの「…」メニューから「Share」を選びます。共有されたスキルは閲覧のみで、更新は相手に自動で届きます。グループへの共有はEnterpriseだけです(Use skills in Claude)。組織全体への配布はこれとは別の「Publish to org」で組織ライブラリに出す操作で、公開後は組織が管理し、新しい版は提出し直して(設定によってはレビューを経て)反映されます(Provision and manage skills for your organization)
  • アップロードした個人スキルは、共有するまで同僚から見えません。管理者からは名前と共有状況は見えますが、ファイルの中身は見えません
  • Claude Codeは、.claude/skills/ のコミット、プラグインの skills/ ディレクトリ、managed settingsの3つが配布方法です

9-2. 面をまたぐ同期は公式どうしで記述が合わない

API側overviewは「カスタムスキルは面をまたいで同期しない」と書き、claude.aiに上げたスキルはAPIに別途上げる必要があるとしています。一方、Claude CodeのドキュメントとHelp Centerには、Claude Code v2.1.273以降でclaude.aiのスキルが ~/.claude/skills/synced/ に同期され、/skills の「claude.ai sync」に表示されると書かれています。止めるには syncClaudeAiSkills を false にします。2026-11-04時点の公式資料では、この2つの記述が食い違っています。

9-3. 他人が作ったスキルを入れる前に

Help Centerは「信頼できる提供元からだけスキルを入れる」よう警告しています。同僚から共有されたものを含め、出所が確かでないスキルは、オンにする前に同梱ファイルを読むよう求めています。最大のリスクとして挙げているのはプロンプトインジェクションとデータの持ち出しです(Use skills in Claude)。API側overviewも「ソフトウェアをインストールするのと同じように扱う」よう書いています。

入れる前に確認するとよい点は次の3つです。

  1. scripts/ などに実行ファイルがあれば、何を実行し、どこへ通信するかを読む
  2. 本文に外部URLの取得や、パッケージのインストールを指示する文がないか探す
  3. Claude Codeの場合、allowed-tools で確認なしに使えるツールが広く与えられていないか見る

実行環境の制約も面ごとに違います。overviewによると、APIはネットワーク接続なし、claude.aiは接続の可否がまちまち、Claude Codeはユーザーのコンピューター上のほかのプログラムと同じネットワーク接続を持ちます(Agent Skills overview 2026-11-04参照)。

Enterpriseでは、アップロードされたスキルを悪意ある内容がないか検査する「skill scanning」を使えます。Help Centerは、多くの検査が1〜2分で終わるとしています。ただしoverviewによると、Skills APIやClaude Consoleから上げたスキルは検査の対象外です。


10. 料金と上限

確認した公式ページ(Help Center 3ページ、API側overview、Claude Codeのドキュメント)の本文からは、Skills自体の別料金に関する記載は見つかりませんでした(実行にはコード実行やトークン消費が伴います)(Claude Code Docs 2026-11-04)。確認できなかったのはSkills専用の追加料金で、実行に伴う料金が無いという意味ではありません。プランごとの月額はClaude料金の記事にまとめています。

数字として確認できた上限は次のとおりです。

項目値出典
APIの1リクエストに含められるスキル数20本までSkills guide
Claude Codeのスキル一覧の予算既定でモデルのコンテキストの1%(skillListingBudgetFraction で引き上げ可)skillsドキュメント
説明文1本の上限(Claude Codeの一覧)1,536文字skillsドキュメント
要約後に残る各スキルの量先頭5,000トークン、全体で25,000トークンskillsドキュメント

なおAPI側overviewは、Agent SkillsがZDR(データ保持ゼロ)の取り決めの対象外だと明記しています。


11. よくある質問

無料プランでも使えますか

Help Centerの3ページはFreeを対象プランに含めています。ただしAPI側overviewのclaude.aiの項はPro・Max・Ultra・Team・Enterpriseと書いていて、Freeを挙げていません。Freeで使えるかは、自分の画面でCustomize > Skillsが表示されるかで確かめてください。

日本語で説明文を書いても発動しますか

公式ページに、説明文の言語についての制限は見当たりませんでした。Help Centerは、説明文に「いつ使うか」を具体的に書くよう求めています。日本語で依頼するなら、依頼で実際に使う日本語の言葉を説明文に含めるのが筋です。

自作のスキルをclaude.aiとClaude Codeで1つにまとめられますか

ファイルとしては共用できます。基本はclaude.aiにはZIPで上げ、Claude Codeにはフォルダを置く形です。ただしClaude CodeのドキュメントとHelp Centerによると、v2.1.273以降のClaude Codeはclaude.aiのスキルを ~/.claude/skills/synced/ に同期するため、Claude Code側に別途置かなくてよい場合があります。API側overviewは同期しないと書いており、記述が揃っていません。

スキルを作るのを手伝ってもらう方法はありますか

公式ブログは、対話しながらスキルを作る「skill-creator」スキルを紹介しています。Claude Codeでは /plugin install skill-creator@claude-plugins-official で入れられます。Help CenterはMac版ClaudeのCoworkで、作業を録画してスキルにする機能も案内しています(Pro・Max・Ultra・Teamのみ)。


12. まとめ

  • claude.aiはコード実行をオンにしてからCustomize > SkillsでZIPを上げ、トグルでオンにします。Claude Codeは ~/.claude/skills/ か .claude/skills/ にフォルダを置くだけです
  • 最初の1本は name(英小文字とハイフン)と description(200文字以内)だけの最小構成にすると、両方で使い回しやすくなります
  • 呼び出しは自動と /名前 の2通りで、勝手に動いてほしくない手順はClaude Codeで disable-model-invocation: true を付けます。この項目はclaude.aiに上げるとエラーになります
  • 対象プラン、設定画面の名前、文字数上限、面をまたぐ同期は、公式ページどうしで記述が食い違っています。自分の画面と最新の公式ページで確認してください

13. 関連記事