Claude Skillsは、Claude Codeに繰り返しの手順や専門知識をフォルダで教える仕組みだ。この記事では、AnthropicエンジニアBarry・Maheshの実演動画と公式ドキュメント(2026年8月11日再確認)をもとに、Claude Skillsの仕組み・作り方・使い方を整理する。

CLAUDE.md VS SKILLS何を代替するか

毎回読むCLAUDE.mdから、必要なときだけ読むスキルへ

CLAUDE.md に全部書く

セッション開始時に常時ロード

  • 手順書の分だけ毎回トークンを消費
  • ファイルは1つ(@importで分割)
  • 使わない手順も常に文脈にいる

スキル(SKILL.md)にする

呼び出されたときだけロード

  • 普段は description だけ読む
  • テンプレートやスクリプトを同梱できる
  • /スキル名 か Claude の自動判断で起動
出典: Claude Code 公式ドキュメント(Extend Claude with skills・2026-08-11 確認)
30秒でわかるClaude Skills
スキルは `.claude/skills/<名前>/SKILL.md` というフォルダ+Markdownだけで作れる
CLAUDE.mdは常時ロード、スキルは呼び出し時だけロードなのでトークンを節約できる
自動呼び出しの精度は本文ではなく description の書き方でほぼ決まる </div> Claude Code全般は Claude Code|2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き を参照してほしい。スキルはClaude Codeを拡張する手段のひとつで、全体像は Claude Codeのベストプラクティス完全ガイド2026年版 にある。 ## Claude Skillsとは:「スキル=フォルダ」の意味 2026年4月、AnthropicのエンジニアBarryとMaheshが「Claude Skillsをゼロから作る」16分の動画を公開した。Xでは14万3,792回表示された。冒頭でMaheshは、確定申告を頼むなら天才数学者のMaheshより経験豊富な税理士のBarryを選ぶ、と例えた。今のエージェントはMaheshに近く、頭は良いが専門知識がない。それを補うのがスキルだ。 動画の中心メッセージが「Skills are just folders」だ。フォルダに SKILL.md を1つ置けば、ワークフロー・専門知識・判断基準をClaudeに教えられる。プログラミングは要らず、Markdownで手順書を書けばそのまま指示書になる。Gitで管理でき、Zipでチームに共有できる。 ## Claude Skillsの構造とCLAUDE.mdの違い CLAUDE.md側の書き方は CLAUDE.mdの書き方ガイド で扱っている。 .claude/skills/ の下にスキル名のフォルダを作り、中に SKILL.md を置く。テンプレート・出力例・スクリプトを同じフォルダに置けば、スキルが自己完結した知識パッケージになる。 | 観点 | CLAUDE.md | スキル(SKILL.md) | |------|-----------|-----------------| | ロードタイミング | セッション開始時・常時 | 呼び出されたときだけ | | トークンコスト | 毎セッション消費 | 呼び出し時のみ消費 | | 用途 | 常に必要なルール・設定 | 繰り返すワークフロー・専門手順 | | ファイル数 | 1ファイル(@importで分割可) | 複数ファイルをフォルダに同梱可 |

LOAD FLOWロードされる順

本文は呼び出された瞬間に初めて読まれる

  1. セッション開始

    CLAUDE.md は全文ロード。スキルは description の一覧だけ読む

  2. 呼び出し判断

    ユーザーが /スキル名 と打つか、Claude が description を読んで判断する

  3. SKILL.md 本文をロード

    会話に1メッセージとして挿入され、セッション終了まで有効

  4. 圧縮時は再アタッチ

    最新の呼び出し分を最大5,000トークン、全スキル合計25,000トークンまで

出典: Claude Code 公式ドキュメント(Extend Claude with skills・2026-08-11 確認)
ロードされたSKILL.mdは会話に1メッセージとして挿入され、セッション終了まで有効だ。途中で再ロードはされない。コンテキスト圧縮が起きても、最新の呼び出し分は最大5,000トークン(全スキル合計25,000トークン)まで再アタッチされる。 ## SKILL.mdの書き方と呼び出し:Claude Skillsを3分で作る SKILL.mdは、--- で囲んだYAML frontmatterと、その下のMarkdown本文でできている。最重要フィールドは description で、Claudeはこれを読んで自動呼び出しするか判断する。 | フィールド | 説明 | |-----------|------| | name | スラッシュコマンド名。英数字・ハイフンのみ・64文字以内。省略するとフォルダ名 | | description | 何をするか・いつ使うか。自動判断に使われる(250文字以内) | | argument-hint | 補完時に出す引数のヒント | | disable-model-invocation | trueでClaudeの自動呼び出しを禁止し手動専用にする | | user-invocable | falseでスラッシュメニューから隠す(Claude専用) | | allowed-tools | 実行中に確認なしで許可するツール | | context / agent | forkで独立したサブエージェントとして実行し、種別を指定する | | paths | 自動発火をGlobパターンのファイルに限定する | 本文では $ARGUMENTS(引数全体)、$0(最初の引数)、${CLAUDE_SKILL_DIR}(スキルのディレクトリ)が使える。さらに ` !コマンド ` と書くと、ロード前にシェルがコマンドを実行し、出力が本文に埋め込まれる。Claudeが実行するのではなく、事前に注入される点が要点だ。 最短で動かすなら、コミットメッセージ用のスキルを作る。 ```bash mkdir -p .claude/skills/commit-msg cat > .claude/skills/commit-msg/SKILL.md <<'EOF' --- name: commit-msg description: ステージ済みの変更からConventional Commits形式のメッセージ案を作る。"commit", "コミットメッセージ"の依頼に使う allowed-tools: Bash(git diff *) --- - ステージ済み差分: !git diff --cached --stat 上の差分を読み、Conventional Commits形式で1行サマリー(50字以内)を提案する。 EOF ``` 作成後、Claude Codeで /commit-msg と打つか「コミットメッセージ考えて」と頼めばよい。ロード時にステージ差分が埋め込まれるので、毎回そのコミットに即した提案が返る。 ## スコープの優先順位と2026年8月時点の仕様変更 スキルは4つのスコープに置ける。同名のスキルが複数あるときは、enterprise → personal → project の順で上位が勝つ。どの階層のスキルも、同名のバンドル済みスキル(/code-review など)を上書きする。プラグインのスキルは plugin-name:skill-name の名前空間を持つので衝突しない。

SCOPE PRIORITY同名スキルの優先順位

同名なら enterprise → personal → project の順で上書き

  1. Enterprise

    組織が managed settings で配布。最優先

  2. Personal

    ~/.claude/skills/ 配下。自分の全プロジェクト

  3. Project

    .claude/skills/ 配下。そのリポジトリだけ

  4. Plugin

    plugin-name:skill-name の名前空間で衝突しない

出典: Claude Code 公式ドキュメント(Extend Claude with skills・2026-08-11 確認)
初出(2026年4月)以降の変更で、記事の前提に関わるものを挙げる。 ・カスタムコマンドとスキルは統合された。.claude/commands/deploy.md と .claude/skills/deploy/SKILL.md はどちらも /deploy になる。既存のcommandsは移行不要だが、同名ならスキルが優先される。補助ファイル・呼び出し主体の制御・自動読み込みが要るならスキル形式にする
・ネストしたスキルは遅延ロードされる。作業ディレクトリより下の .claude/skills/ は、そこのファイルを読むか編集した時点で有効になる。モノレポで認識されないときは、対象ディレクトリのファイルを1つ開いてみる
・編集は再起動なしで反映される。ただしセッション開始時に存在しなかったトップレベルのスキルディレクトリを新設した場合は再起動が必要
・disallowed-tools が追加された。スキルが有効な間、特定のツールをClaudeから外せる

配布先によって使えるfrontmatterが違う

claude.aiへのアップロードやSkills API経由では、受け付けるフィールドは name / description / license / compatibility / metadata / allowed-tools に限られる。argument-hint などClaude Code専用のフィールドを残すと Unexpected key(s) in SKILL.md frontmatter で弾かれる。またCoworkやクラウドセッションは、手元の ~/.claude/skills/ を読まない。共有したいスキルはリポジトリの .claude/skills/ にコミットする。

### 呼び出し方と「発火しない」ときの直し方 呼び出しは3パターンある。デフォルトはユーザーもClaudeも呼べる。disable-model-invocation: true を付けると手動専用になり、user-invocable: false を付けるとClaude専用の隠しスキルになる。デプロイや削除のように誤実行が重い処理には、必ず手動専用を付ける。 | 症状 | 主な原因 | 対処 | |------|---------|------| | 自動で呼ばれない | description が抽象的でトリガー語がない | 「いつ使うか」を具体的な語で書く | | 勝手に発火する | トリガー語が広すぎる、副作用のある処理を自動許可 | disable-model-invocation: true にする | | 手動でも見つからない | name がフォルダ名と食い違う、英数字以外を含む | 英数字・ハイフンのみ・64字以内にする | Claudeは本文を読む前に、全スキルの description だけで開くかどうかを決める。だから「何をするか」に「どんな入力のときに使うか」を1文添えるだけで、発火の精度が変わる。悪い例は Deploy the application、良い例は Deploy the application to production. Use when the user says "deploy", "ship", or "release". だ。 !コマンド構文は、Project・Personal・Pluginのスキルに適用され、Enterpriseスキルでは無効だ。settings.json の "disableSkillShellExecution": true で全体を止めることもできる。 ## 活用パターンとスキルの探し方 動画では、スキルの使い道が3系統に整理された。 ・基盤スキル:Officeドキュメントの作成や、Cadenceの科学研究スキル(電子カルテ解析・バイオインフォマティクス)のように新しい能力を足す
・パートナースキル:Browserbaseの Stagehand 向け、Notionのワークスペース横断リサーチなど、自社製品とClaudeをつなぐ
・エンタープライズスキル:大企業がコードスタイルや社内ソフトの使い方を教える。財務・法務・採用の担当者が自分の業務フローをSKILL.mdにする例も出ている MCPとの関係は補完だ。MCPは外部世界への接続、スキルはそのデータをどう使うかの専門知識を担う。複数のMCPツールを使う手順をスキルに束ねる使い方が増えている。見た目のルールを教える側面では awesome-design-md の58ブランド対応DESIGN.md集 が近い発想だ。 | 場面 | スキルなし | スキルあり | |------|-----------|-----------| | コードレビュー | 毎回レビュー基準を説明する | /review 一言で基準が適用される | | デプロイ | Claudeが推測で手順を実行しうる | 手動専用にして誤実行を防ぐ | | 新メンバーの参加 | 規約をClaudeが知らない | プロジェクトスキルが規約を供給する | 探す順番は、公式バンドル(code-review・security-review・PDF/PPTX作成など)、OSSのキュレーションリポジトリ、Plugin Marketplace(/plugin から追加)、自作の順が現実的だ。毎週繰り返している作業に対応するものから試し、効くものだけ残すほうがコンテキストを汚さない。公式スキルは anthropics/skills にある。 ## まとめ:フォルダを1つ作るところから 要点は6つだ。構造は `.claude/skills/<名前>/SKILL.md に任意の参考ファイル。description が最重要で「いつ使うか」を書く。スコープは4段階で enterprise が最優先。呼び出しは /スキル名 か自動判断で、副作用ありは手動専用にする。!` コマンドでGit状態などを動的に注入できる。CLAUDE.mdは常時、スキルはオンデマンドだ。 動画は、継続学習にも触れていた。Claude自身が学んだことをSKILL.mdに書き留める方向で、「skill creator skill」(スキルを作るスキル)が公開されている。まずは繰り返している作業を1つ選び、フォルダを作ってみてほしい。 ## 参照ソース - Extend Claude with skills — Claude Code公式ドキュメント(2026-08-11 再確認:カスタムコマンドのスキルへの統合、スコープ優先順位、ネストしたスキルの遅延ロード、frontmatterの現行仕様、配布時に許可されるフィールドの制限) - How Claude remembers your project — Claude Code メモリドキュメント - Claude Code overview - anthropics/skills — GitHub公式スキルリポジトリ - Kirill (@kirillk_web3) の元ツイート