Claude Code Skills 活用ガイド｜SKILL.md・npx skills・Agent Skills徹底解説【2026年最新】

Claude Code Skillsとは、.claude/skills/<スキル名>/SKILL.md を置くだけで動く「再利用可能な命令パッケージ」です。CLAUDE.mdが「常時ロードされるルール集」なのに対し、Skillsは必要なときだけ呼び出されるオンデマンドの業務プレイブックとして機能し、コンテキストを節約しながら大規模なノウハウをチームに展開できます。

本記事では、公式ドキュメント（Extend Claude with skills）と Anthropic Engineering Blog をベースに、Skillsの全構造・SKILL.mdフロントマター15フィールド・npx skills CLIによるインストール・2026年最新バンドルスキル・セキュリティまでを一気通貫で整理します。

この記事でわかること

Claude Code Skills（Agent Skills）の正体とCLAUDE.mdとの使い分け判断基準
SKILL.md のYAMLフロントマター全フィールドと呼び出し制御の仕組み
~/.claude/skills/ と .claude/skills/、Enterprise配布の優先順位
npx skills CLIで公式リポジトリからインストールする手順
2026年最新バンドルスキル（/run・/verify・/run-skill-generator）の使い方
agentskills.io オープン標準とクロスエージェント互換性
Anthropic公式が繰り返し警告するセキュリティリスクと対処法

こんな方に向いています

Claude Codeで毎回同じ指示を貼り付けるのに疲れた開発者
チーム全員に同じ手順・規約を強制したいリードエンジニア
CLAUDE.mdが肥大化してコンテキストを圧迫しているプロジェクト
業務プレイブックをLLMに任せたいプロジェクトマネージャー
他社AIツール（Cursor・Copilot）ともSkillsを共有したい人

Claude Code Skillsとは何か

出典: Anthropic Engineering Blog 公式

Claude Code Skillsは、「いつ呼び出すか」を書いたメタデータと、「何をすべきか」を書いた指示書（SKILL.md）、そして任意のスクリプト・参照ファイルをディレクトリにまとめたパッケージです。Anthropicが2025年10月に公式発表した機能で、Claude Code・Claude API・Claude.aiの3サーフェスに対応しています。

公式が掲げる中心的な設計思想は Progressive Disclosure（段階的開示） です。Claudeは起動時にすべてのSkillの「name」と「description」だけを常時ロードし、SKILL.md本体は必要になった時点で初めて読み込みます。これにより、数十〜数百のSkillをコンテキストに「待機」させながら、実コストを最小に抑えられます。

Claude Code上での位置付けとしては、既存の .claude/commands/ の上位互換にあたります。従来のスラッシュコマンドはそのまま動作しますが、Skillsはサポートファイルの同梱・フロントマター制御・Claude自身による自動呼び出しに対応しており、公式ドキュメントには「カスタムコマンドはSkillsにマージされた」と明記されています。

Progressive Disclosureの3層構造

Skillsの設計の肝は、Claudeが情報を「3段階で必要なときだけ読む」点にあります。

レベル	読み込みタイミング	トークンコスト目安	内容
Level 1（メタデータ）	起動時・常時	1Skillあたり約100トークン	YAMLフロントマターの `name` / `description`
Level 2（指示）	トリガー時	5,000トークン未満を推奨	SKILL.md本文
Level 3+（リソース）	参照された時	実質無制限（未使用時は0）	追加Markdown・参照データ・スクリプト

運用上の重要な挙動として、SKILL.mdは一度呼び出されるとセッション中の会話に1メッセージとして残り続け、後続ターンで再読み込みされません。タスク全体に効かせたいルールは「スタンディング指示」として書く必要があります。

また、自動コンパクション時には各Skillの最新呼び出しから先頭5,000トークン分が再アタッチされ、全Skillの合計予算は25,000トークンという上限があります。多数のSkillを使ったセッションでは、コンパクション後に古いSkillが落ちる可能性があるため、必要なら再度呼び出して復元する運用が必要です。

CLAUDE.md vs Skills vs Slash Commands — 使い分け判断基準

Claude Codeには似たような機能が複数あり、混乱しやすいポイントです。「いつ・どう発動するか」と「コンテキストへの影響」で使い分けるのが分かりやすい整理です。

用途	推奨	理由
プロジェクトの常時ルール・スタック情報（規約・環境）	CLAUDE.md	全セッションで常時参照。1ファイルで一覧性が高い
手動で明示的にトリガーしたいコマンド・マクロ	Slash Command または `disable-model-invocation: true` のSkill	誤発動を避けたい定型処理に適する
Claudeに状況応じて自動発動させたい業務プレイブック	Skill（デフォルト挙動）	descriptionを見て必要時のみロード。コンテキスト節約
長時間・並列・重い探索をメインから切り離したい	Subagent または `context: fork` のSkill	メイン会話のコンテキストを汚さない
外部ツール・API・データベースへの接続	MCP（Model Context Protocol）	プロトコル経由でClaudeに新しい能力を追加

「全タスクに常時効かせたいか」がCLAUDE.mdとSkillsの分かれ目です。CLAUDE.mdは毎回コンテキストに入るため濃くなりがちですが、Skillsは必要時のみロードされるので、頻度の低い専門手順を大量に抱えるのに向きます。

Claude Code全体の使い方については Claude Codeとは？特徴・料金・使い方を完全解説も参考にしてください。

`.claude/skills/` と `SKILL.md` の構造

Claude Code Skillsの実体は、.claude/skills/<skill-name>/SKILL.md というディレクトリ＋Markdownファイルのセットです。

my-skill/
├── SKILL.md           # 必須：メイン指示（YAMLフロントマター＋本文）
├── template.md        # 任意：Claudeが埋めるテンプレート
├── examples/
│   └── sample.md      # 任意：期待形式の出力例
└── scripts/
    └── validate.sh    # 任意：Claudeが実行するスクリプト

ここで重要なのは、SKILL.mdを1階層深く置くと動かない点です。my-skill/another-folder/SKILL.md のような配置はClaude Codeが認識しません。トップレベルの <skill-name>/ 直下に必ずSKILL.mdを置く必要があります。

サポートファイルは「Level 3+」のリソースとして扱われ、SKILL.md内から参照（@template.md・!bash scripts/validate.sh など）された時点で初めてClaudeに読み込まれます。500行を超えるような大きなノウハウは、SKILL.md本体を薄く保ち、参照ファイルに分割するのが公式推奨パターンです。

SKILL.mdのYAMLフロントマター — 全フィールド解説

Claude Code公式ドキュメント「Extend Claude with skills」ページ

出典: Claude Code 公式ドキュメント

SKILL.mdは「YAMLフロントマター」＋「Markdown本文」のシンプルな構造です。最低限の例は以下のとおりです。

---
name: my-skill
description: PRをレビューするときに自動で使う。差分・テスト・規約違反の3観点で評価する
---

## PR Review Skill

PRをレビューするときは以下の手順で評価する...

フロントマター全フィールド一覧

フィールド	概要
`name`	表示名。省略時はディレクトリ名。小文字・数字・ハイフンのみ、最大64文字
`description`	何をするか・いつ使うか。自動呼び出し判定に使用。`description`+`when_to_use` 合算1,536文字でトランケート（`name` は別途最大64文字制限）
`when_to_use`	トリガー条件の補足。descriptionだけでは伝えにくい発動条件を書く
`argument-hint`	オートコンプリートで表示される引数ヒント
`arguments`	名前付き位置引数（`$name` 置換用）
`disable-model-invocation`	`true` でClaude自動呼び出しを禁止（手動 `/skill-name` のみ）
`user-invocable`	`false` で `/` メニューから非表示にし、Claude専用知識として扱う
`allowed-tools`	Skillアクティブ時に都度承認なしで使えるツール
`model`	このSkill実行時にモデルを上書き（例: `claude-opus-4`）
`effort`	推論努力レベル（`low` / `medium` / `high` / `xhigh` / `max`）
`context`	`fork` を指定するとサブエージェントで分離実行
`agent`	`context: fork` 時に使うサブエージェントタイプ（例: `Explore`・`Plan`）
`hooks`	Skillライフサイクルにスコープされたフック
`paths`	このSkillを自動発動させるファイルglob（例: `"*/.tsx"`）
`shell`	`!コマンド` 構文に使うシェル（`bash` / `powershell`）

特に description は 「いつ・なぜ呼ばれるべきか」を明確に書くのが最重要です。Anthropic Engineering Blogでも、descriptionが曖昧なSkillは自動呼び出しが効かず「死蔵される」と指摘されています。「PRレビュー時に呼ばれる」「Excel変換タスクで使う」のように具体的なトリガー条件を含めましょう。

文字列置換変数

SKILL.md本文内で使える変数は以下のとおりです。

変数	説明
`$ARGUMENTS`	スキル呼び出し時に渡された全引数
`$ARGUMENTS[N]`	N番目の引数（0始まり）
`$N`	`$ARGUMENTS[N]` の短縮形
`$name`	`arguments` フロントマターで定義した名前付き引数
`${CLAUDE_SESSION_ID}`	現在のセッションID
`${CLAUDE_EFFORT}`	現在の推論レベル
`${CLAUDE_SKILL_DIR}`	スキルの SKILL.md があるディレクトリのパス

呼び出し制御マトリクス

disable-model-invocation と user-invocable の組み合わせで、Skillの呼び出し可否を細かく制御できます。

フロントマター設定	ユーザー呼び出し	Claude自動呼び出し	descriptionの常時ロード
（デフォルト）	○	○	ロードする
`disable-model-invocation: true`	○	×	ロードしない
`user-invocable: false`	×	○	ロードする

「重要な手順だが誤発動されると困る（例：本番デプロイ）」場合は disable-model-invocation: true、「Claudeに状況判断させたい背景知識」を渡したい場合は user-invocable: false がそれぞれ適しています。

4つの保存場所と優先順位

Claude Code公式ドキュメントが定める保存階層は以下の4つです。

場所	パス	適用範囲
Enterprise	管理設定経由（IT管理者が配布）	組織内の全ユーザー
Personal	`~/.claude/skills/<skill-name>/SKILL.md`	自分の全プロジェクト
Project	`.claude/skills/<skill-name>/SKILL.md`	そのプロジェクトのみ
Plugin	`<plugin>/skills/<skill-name>/SKILL.md`	プラグインが有効な場所

優先順位は Enterprise > Personal > Project で、同名のSkillが複数階層にある場合は上位が勝ちます。プラグインSkillは plugin-name:skill-name のネームスペースを持つため、他と衝突しません。

ユースケース	推奨配置
自分専用のショートカット（個人的なリファクタリング癖など）	Personal（`~/.claude/skills/`）
チームで共有したいプロジェクト固有の規約	Project（`.claude/skills/` をgit管理）
複数プロジェクト・組織横断で配布したい資産	Plugin
全社で強制したいセキュリティルール・コーディング規約	Enterprise（管理設定）

チーム展開を狙うなら .claude/skills/ をリポジトリにコミットするのが基本です。新しくジョインしたメンバーがリポジトリを git clone した瞬間にSkillsが利用できる状態になります。

ライブ変更検出: Claude Codeは既存のskillsディレクトリ下で追加・編集・削除したSkillを再起動なしで即反映します。ただし、セッション開始時に存在しなかったトップレベルのskillsディレクトリを新規作成した場合は、Claude Codeの再起動が必要です。

モノレポ対応: packages/frontend/ 配下のファイルを操作していれば packages/frontend/.claude/skills/ も自動で読み込まれるネストディレクトリ検出もサポートされています。

バンドルスキル（Claude Code 組み込みスキル）

Claude Codeにはデフォルトで以下のバンドルスキルが搭載されています。

スキル名	用途
`/simplify`	複雑なプロンプトを整理・再構成
`/batch`	並列ワークツリーでの一括作業
`/debug`	デバッグ支援
`/loop`	繰り返しプロンプトの実行
`/claude-api`	Claude API参照・SDKドキュメント（8言語対応）
`/run`	アプリを起動して変更を確認（v2.1.145以上必須）
`/verify`	コード変更がテスト/型チェックなしで動作確認（v2.1.145以上必須）
`/run-skill-generator`	run/verifyの起動レシピを記録・自動保存

`/run-skill-generator` の活用

/run-skill-generator は特に実用性が高いバンドルスキルです。クリーン環境からアプリを起動し、成功したレシピを .claude/skills/run-<name>/ に自動保存します。一度実行すればリポジトリ内の全エージェントが同じレシピを使用できるようになります。

/run-skill-generator を呼び出す
Claude がインタラクティブにアプリ起動コマンドを確認する
成功したレシピが .claude/skills/run-<name>/SKILL.md として自動保存される
以降は /run を呼ぶだけで同じ手順が再現される

npx skills CLI でスキルをインストールする

出典: anthropics/skills GitHub 公式

agentskills.io オープン標準に準拠した公式スキルリポジトリからのインストールは、Vercel Labsが開発した npx skills CLIで行えます。

主なインストールコマンド

# Anthropic公式スキルリポジトリからすべてインストール
npx skills add anthropics/skills

# 特定スキルだけインストール
npx skills add anthropics/skills --skill claude-api

# Vercel Labs公式スキルをインストール
npx skills add vercel-labs/agent-skills

# グローバルインストール（個人スキルとして全プロジェクトで使用）
npx skills add vercel-labs/agent-skills -g

# 特定エージェント向けにインストール
npx skills add <owner/repo> --agent claude-code

npx skills の主要コマンド一覧

コマンド	機能
`skills add <owner/repo>`	スキルをインストール
`skills list`	インストール済みスキル表示
`skills find`	スキルを検索
`skills remove`	スキルを削除
`skills update`	スキルを更新
`skills init`	新規スキルのテンプレート作成

Anthropic公式スキルリポジトリのカテゴリ

github.com/anthropics/skills では以下のカテゴリのスキルが公開されています。

Creative & Design — クリエイティブ系タスク
Development & Technical — 開発・技術系
Enterprise & Communication — 企業コミュニケーション系
Document Skills — docx/pdf/pptx/xlsx（API/claude.ai向け）

agentskills.io オープン標準とクロスエージェント互換性

Claude Code Skillsは、agentskills.io が定めるオープン標準に準拠しています。これにより、同一のSKILL.mdファイルが複数のAIコーディングツールで使い回せます。

対応エージェント（主要）
Claude Code
Cursor
GitHub Copilot
Codex
Cline
OpenHands
Continue
Goose
Windsurf

現時点（2026年5月）で55以上のエージェントが npx skills CLIに対応しています。

Claude Code独自の拡張機能（標準には含まれない）:

呼び出し制御（disable-model-invocation / user-invocable）
サブエージェント実行（context: fork）
動的コンテキスト注入（!コマンド 構文）
paths によるファイルベースのトリガー

これらはClaude Code専用の拡張フィールドで、他ツールでは無視される形で設計されているため、同一ファイルを他ツールに持ち込んでも基本機能は動作します。

3つのサーフェスの違い（Claude Code・Claude API・Claude.ai）

Agent SkillsはClaude Code・Claude API・Claude.aiの3サーフェスで動きますが、それぞれ提供形態と制約が大きく異なります。

サーフェス	対応Skill	配布形式	主な制約
Claude Code	カスタムSkillsのみ	ファイルシステム（`~/.claude/skills/` または `.claude/skills/`）	プリビルトSkills非対応
Claude API	プリビルト＋カスタム	`/v1/skills` エンドポイントへアップロード	ネットワークアクセス不可・ランタイムでのパッケージインストール不可
Claude.ai	プリビルト＋カスタム	有料プランのUIからzipアップロード	ユーザー個別アップロードのみ・組織一元管理なし

公式提供のプリビルトSkillsは、現時点で pptx（PowerPoint）／xlsx（Excel）／docx（Word）／pdf の4種類です。これらはClaude APIとClaude.aiで即利用できますが、Claude Codeでは利用できない点を誤解しないようにしましょう。

カスタムSkillsはサーフェス間で自動同期しません。Claude.aiにアップロードしたものをClaude Codeに反映させるには、別々に管理する必要があります。

Claude API経由でSkillsを使うときの追加要件

Claude APIでSkillsを呼び出すには、Code Execution Toolと併用し、以下の3つのベータヘッダを送信する必要があります。

anthropic-beta: code-execution-2025-08-25,skills-2025-10-02,files-api-2025-04-14

Skills機能自体に追加課金はありませんが、Code Execution Toolの実行時間とコンテナストレージは標準課金が発生します。

最初のSkillを作る5ステップ（ハンズオン）

最小構成のSkillを作って、自動呼び出しの感触を掴みましょう。コードレビュー支援用の pr-review Skillを例にします。

ステップ1: ディレクトリを作る

mkdir -p .claude/skills/pr-review

ステップ2: SKILL.mdを書く

---
name: pr-review
description: GitHub PRをレビューするときに自動で使う。差分・テスト追加・規約違反の3観点で評価する
when_to_use: ユーザーがPRレビュー、差分確認、コードレビューを依頼したとき
allowed-tools: Bash(gh pr diff *) Bash(gh pr view *)
---

# PR Review Skill

## Step 1: 差分の取得
!`gh pr diff`

## Step 2: 評価観点
1. **差分の意図**：コミットメッセージとPR本文と一致しているか
2. **テスト**：新しいロジックに対するテストが追加されているか
3. **規約違反**：CLAUDE.mdに記載のコーディング規約に反していないか

## Step 3: 出力形式
- 各観点ごとに「OK / 要修正 / 確認希望」をマークする
- 要修正がある場合は具体的な修正案を提示する

ステップ3: 動作確認

Claude Codeを起動し、/skills でSkill一覧に pr-review が出ることを確認します。次に「PR #42 をレビューして」のように依頼すると、descriptionに基づいてClaudeが自動で pr-review を呼び出します。明示的に呼び出したい場合は /pr-review をタイプします。

ステップ4: 動作検証

!`gh pr diff` の動的注入が走り、Claudeが差分を見た上で評価する流れになっているか確認します。期待通りでなければdescription・when_to_use・本文の手順を調整します。

ステップ5: チームに展開

問題なければ .claude/skills/pr-review/ をリポジトリにコミットします。これでチーム全員が git pull した瞬間からSkillが使えるようになります。

よく使う4つの応用パターン

1. 動的コンテキスト注入（`!` バックティック構文）

SKILL.md本文に !`コマンド` と書くと、Claudeが本文を見る前にシェルコマンドを実行し、結果がプロンプトに差し込まれます。PR差分・git log・現在の環境情報など、毎回最新を取りたい情報を自動で同梱できます。

## 現在のブランチ状況
!`git status --short`

## 最近のコミット
!`git log --oneline -10`

2. サブエージェント分離実行（`context: fork`）

巨大な探索や複数ファイルの読み込みが必要なSkillは、メインコンテキストを汚さないようサブエージェントに分離するのが有効です。

---
name: dependency-audit
description: package.jsonの依存関係を全件監査する
context: fork
agent: Explore
---

メイン会話には結論だけが返り、途中の探索ログでメインコンテキストを潰さずに済みます。context: fork の詳しい活用法は Claude Code サブエージェント活用ガイドを参照してください。

3. ツール事前承認（`allowed-tools`）

定型的なBashコマンドを毎回承認するのは煩雑です。allowed-tools に指定しておけば、Skillアクティブ時のみ承認を省略できます。

allowed-tools: Bash(git add *) Bash(git commit *) Bash(git push *)

ただし広すぎる権限はセキュリティリスクになります。Bash(*) のような全許可ではなく、必要なサブコマンドだけを列挙しましょう。

4. ファイルパスベースの自動発動（`paths`）

特定のファイルglob配下を編集しているときだけ自動発動させたいSkillには paths が便利です。

---
name: react-component-style
description: Reactコンポーネントのスタイル規約を適用する
paths:
  - "src/components/**/*.tsx"
---

「TSXファイルを編集する場面だけスタイル規約Skillを呼ぶ」のように、コンテキストに応じた自動発動が可能になります。

ハマりやすいポイントとアンチパターン

公式ドキュメントとAnthropic Engineering Blogが繰り返し指摘している、初学者が陥りがちな失敗を整理します。

症状	原因	対策
Skillが自動発動しない	descriptionが曖昧・短すぎる	「いつ・何のために呼ぶか」を具体的に書き直す
SKILL.mdが認識されない	`<skill-name>/another-folder/SKILL.md` のように1階層深い	トップレベルの `<skill-name>/` 直下に配置
ファイル更新が反映されない	セッション開始後に新規skillsディレクトリを作成	Claude Codeを再起動する
長いSkillでコンテキスト枯渇	SKILL.md本文に全情報を詰めている	5,000トークン未満に圧縮し、詳細はLevel 3+のサポートファイルへ
コンパクション後にSkillが効かない	全Skill合算25,000トークン上限を超過	必要なSkillを再度明示呼び出しして復元
Time-sensitive情報がズレる	料金・モデル名などをSKILL.mdに直書き	動的注入（`!`）で都度取得するか、CLAUDE.mdに分離
プリビルトSkillsをClaude Codeで使おうとして使えない	Claude CodeはカスタムSkillsのみ	API／Claude.aiで利用するか、Claude Code向けに自作

特に 「descriptionが弱くて発動しない」 は最頻出の失敗です。description: This skill is for code review のような無味乾燥な記述では、Claudeが「今このSkillを呼ぶべきか」を判断できません。「PRレビュー、差分確認、コードレビュー依頼を受けたとき」のようにトリガーフレーズを並べるのが効きます。

セキュリティ：Anthropic公式が警告するリスクと対処法

Skillsは強力ですが、コード実行能力を持つ仕組みです。Anthropic公式ドキュメントは「ソフトウェアをインストールするのと同じ感覚で扱え」と繰り返し警告しています。

主なリスク

データ窃取：悪意あるSkillが認証情報・ソースコード・環境変数を外部送信する
未承認のシステムアクセス：allowed-tools の広すぎる指定で、想定外のコマンドが承認なしで実行される
ツール悪用：MCPサーバや他のツールを組み合わせた連鎖攻撃
外部フェッチの改ざん：外部URLから追加コンテンツを取得するSkillは、フェッチ先が後から書き換えられる可能性がある

セキュリティチェックリスト

チェック項目	対処
✅ 信頼できるソースからのみ導入	自作 or Anthropic公式のみを原則とする
✅ 全ファイルを導入前に監査	SKILL.md本文・スクリプト・参照ファイルを必ず確認
✅ `allowed-tools` は必要最小限	`Bash(*)` のような全許可は避け、必要なサブコマンドだけを列挙
✅ シェル実行を全面禁止したい場合	`"disableSkillShellExecution": true` を有効化
✅ 機密環境ではEnterprise配布に限定	ユーザー側のpersonal skillsを禁止するポリシーを検討
✅ ZDR対象外を理解して運用	Agent SkillsはZero Data Retention対象外。機密データの扱いはAnthropicの標準データ保持ポリシーに従う

「便利だから動かす」ではなく、他社のスクリプトをサーバに入れるのと同じ警戒度で扱うのが正しい姿勢です。

セキュリティ全般については Claude Code セキュリティ・安全な使い方ガイドも参考にしてください。

チーム・組織での運用ベストプラクティス

Skillを「育てる運用」（Claude A／Claude B分業）

Anthropic公式のbest-practices文書で推奨されているのは、1つのClaudeでSkillを設計し、別のClaudeで利用させて改善する分業サイクルです。

Claude A（設計役）：ヒアリングやサンプル出力からSKILL.mdの草案を作る
Claude B（利用役）：作ったSkillを実タスクで使ってみる
失敗・違和感をClaude AにフィードバックしてSKILL.mdを改善
これを繰り返してSkillを「育てる」

人間がゼロからSKILL.mdを書き上げるよりも、Claude自身に書かせて運用しながら磨くほうが、実態に合った発動条件・指示文に収束しやすくなります。

評価駆動開発（Evaluations-First）

公式が推奨するもう1つのパターンが、Skillの開発前に「合格基準（評価ケース）」を先に決めておくやり方です。

期待入力：「PR #42 をレビューして」
期待出力：「差分・テスト・規約の3観点で評価結果が返る」
失敗例：「規約違反を見落とす」「テスト不足を指摘しない」

評価ケースを先に書いておくと、SKILL.mdの調整が「テストを通す改善」として進められ、品質が安定します。

バージョン管理とドキュメント

.claude/skills/ 配下はgit管理し、変更時はPRレビューを通すのが基本です。各Skillに README.md を添えて「いつ・誰が・なぜ作ったか」を残しておくと、半年後のメンバーも意図を理解しやすくなります。

コスト最適化の観点から見たSkillsの活用については、Claude Code コスト最適化ガイドも参照してください。

Claude Code Skills の料金

Skills機能自体は、Claude Code・Claude API・Claude.aiのいずれでも追加課金なしで利用できます。

サーフェス	追加コスト
Claude Code	なし（Claude CodeのAPI課金 or Max/Pro/Teamプラン料金に従う）
Claude API	Code Execution Toolの実行時間・コンテナストレージ料金が発生
Claude.ai	Pro / Max / Team / Enterprise プランの月額に含まれる（無料プランではカスタムSkillsアップロード不可）

Claude本体の料金詳細については Claude料金プラン完全ガイドも参考にしてください。

こんな方におすすめ／おすすめしない方

Claude Code Skillsをおすすめする方

同じ指示を繰り返し貼り付けている開発者（Skill化で大幅短縮）
チーム全員に同じ手順・規約を強制したいリードエンジニア（.claude/skills/ をgit管理）
CLAUDE.mdが肥大化してコンテキストを圧迫しているプロジェクト
業務プレイブックをLLMに任せたいプロジェクトマネージャー
PDF/Excel処理など決定論的なスクリプト実行を任せたい人（バンドルスクリプトで再現性確保）
他社AIツールと同じSkillファイルを使い回したい人（agentskills.io標準対応）

よくある質問（FAQ）

Q1. SKILL.mdは何文字くらいまでに収めるべき？

A. SKILL.md本文（Level 2）は5,000トークン未満が公式推奨です。それ以上の情報は、サポートファイルとしてLevel 3+に分割し、SKILL.md本文には参照だけを書きます。

Q2. Skillが自動で呼ばれません。何が原因？

A. ほぼ全てのケースが description が曖昧または短すぎることに起因します。「いつ・なぜ・どのキーワードで呼ばれるべきか」を具体的に書き直すと改善します。それでも呼ばれない場合は when_to_use でトリガーフレーズを補強しましょう。

Q3. Claude.aiにアップロードしたSkillをClaude Codeでも使えますか？

A. 自動同期はされません。同じSkillを使いたい場合は、.claude/skills/<skill-name>/ にも同じ内容を配置するか、デプロイスクリプトで両方に反映する運用が必要です。

Q4. プリビルトSkillsはClaude Codeで使えますか？

A. 現時点でClaude Codeはプリビルトに非対応です。pptx・xlsx・docx・pdfのプリビルトSkillsはClaude APIとClaude.aiでのみ利用できます。

Q5. CLAUDE.mdとSkillsはどう使い分けるべき？

A. 「全タスクに常時効かせたいルール・事実」はCLAUDE.md、「特定条件で発動する手順・プレイブック」はSkillsが基本です。CLAUDE.mdが肥大化してきたら、頻度が低い節をSkillに切り出すとコンテキスト効率が上がります。

Q6. `.claude/commands/` の旧スラッシュコマンドはまだ使えますか？

A. 公式ドキュメントに「カスタムコマンドはSkillsにマージされた」と明記されており、既存の .claude/commands/ も動作は継続します。ただし、サポートファイル同梱・自動呼び出し・細かい制御が必要ならSkillsへ移行するのが推奨です。

Q7. Agent SkillsはClaude以外のAIツールでも使えますか？

A. agentskills.io オープン標準に準拠しているため、基本的なSKILL.mdフォーマットはCursor・GitHub Copilot・Codexなど55以上のエージェントで共有できます。ただし、Claude Code独自の拡張フィールド（context: fork・paths・!コマンド など）は各ツールの公式ドキュメントで対応状況を確認してください。

Q8. Skillsを使うと請求額は増えますか？

A. Skills機能自体に追加課金はありません。Claude APIで使う場合のみ、Code Execution Toolの実行時間・コンテナストレージの標準課金が発生します。Claude Code・Claude.aiでの追加コストはゼロです。

Q9. `/run`, `/verify` を使うにはバージョン条件がありますか？

A. はい。/run, /verify, /run-skill-generator の3つのバンドルスキルはClaude Code v2.1.145以上が必要です。それ以下のバージョンでは表示されません。

Q10. Agent SkillsはZero Data Retention（ZDR）の対象ですか？

A. 対象外です。Agent Skillsの定義と実行データはAnthropicの標準データ保持ポリシーに従い保持されます。機密データを含むSkillを運用する場合は、この点を踏まえたセキュリティポリシーを策定してください。

まとめ

Claude Code Skillsは、.claude/skills/<skill-name>/SKILL.md という単純な仕組みで、繰り返しのプロンプトをパッケージ化し、チーム全体に配布できる強力な仕組みです。CLAUDE.mdが「常時効くルール」だとすれば、Skillsは「必要なときだけ呼ばれる業務プレイブック」と位置付けると、運用設計が分かりやすくなります。

成功の鍵は3つ:

descriptionに「いつ・なぜ呼ばれるか」を具体的に書く（自動発動の精度を決める）
SKILL.md本文を5,000トークン未満に保ち、詳細はサポートファイルへ分割する
信頼できるSkillだけを導入し、allowed-tools は最小限に絞る

2026年時点の最新機能として、/run・/verify・/run-skill-generator のバンドルスキル（v2.1.145以上）と、npx skills CLIを使った公式リポジトリからのインストールを活用することで、開発ワークフローを大幅に効率化できます。

導入の最初の一歩は、CLAUDE.mdから頻度の低い節を切り出してSkill化することです。1個でも動けばProgressive Disclosureの威力を実感できるはずです。

Claude Codeとは？特徴・料金・使い方を完全解説 — Claude Codeの全体像
Claude Code 使い方ガイド — 基本操作からプロジェクト導入まで
Claude Code Hooks 使い方ガイド — フックでClaude Codeのライフサイクルを自動制御
Claude Code × MCP 連携ガイド — Skillsと並ぶ拡張機構MCPの活用
Claude Code エージェントチーム活用ガイド — context: fork のベースとなるSubagent機能
Claude Code コスト最適化ガイド — Skillsを活用したトークンコスト削減
Claude Code Auto Modeとは — 自律実行との連携
Awesome Claude Code ガイド — ツール・拡張機能の総まとめ

この記事のポイント