Claude Code skills

Claude Code はスキルの発祥の地であり、今でもスキルを最も活用できる環境です。Claude Code のスキルでは、フルネットワークアクセスでスクリプトを実行でき、引数を受け取り、独自のサブエージェントで動作し、すでにお持ちのカスタムスラッシュコマンドを置き換えることもできます。このガイドでは Claude Code 側に特化して説明します。フォーマット全般とスキルの入手元については、Claude skills and agent skills を参照してください。

Claude Code のドキュメントとコマンドリファレンスは 2026年11月14日に確認しました。このガイドの上部にある一覧は、HostedMCP のカタログに収録されているすべてのスキルと、Claude Code にインストールするためのコマンドです。

Claude Code が参照する場所

スコープ	フォルダー	利用できる範囲
個人	~/.claude/skills/<name>/SKILL.md	すべてのプロジェクトで自分自身
プロジェクト	.claude/skills/<name>/SKILL.md	リポジトリを clone した全員
ネスト	<subfolder>/.claude/skills/<name>/SKILL.md	モノレポのその部分での作業
プラグイン	<plugin>/skills/<name>/SKILL.md	プラグインを導入している全員が /plugin:name として利用
組織	管理設定フォルダー	そのポリシー配下の全員

同じ名前のスキルが複数ある場合、組織のスキルが自分のスキルより優先され、自分のスキルがプロジェクトのスキルより優先されます。claude.ai で有効にしたスキルは ~/.claude/skills/synced/ に同期されます。

1つ作成する

mkdir -p .claude/skills/release-notes

次に .claude/skills/release-notes/SKILL.md を書きます。

---
name: release-notes
description: Write release notes from merged pull requests. Use when the user asks for release notes, a changelog entry or a summary of what shipped.
---

1. List pull requests merged since the last tag with `gh pr list --state merged`.
2. Group them under Added, Changed and Fixed.
3. Write one plain sentence per change, for users rather than developers.

これで動作するスキルになります。Claude Code は再起動なしでこれを認識します。リリースノートを依頼すればこのスキルが使われますし、/release-notes と入力してもかまいません。

SKILL.md は500行以内に収め、長い内容は指示から参照する同じディレクトリ内のファイルに移してください。Anthropic の skill-creator プラグイン（/plugin install skill-creator@claude-plugins-official）を使うと、スキルを読み込んだ状態と読み込んでいない状態でテストし、その description を調整できます。

呼び出し方

Frontmatter	/name を入力できる	Claude が自動で使う	コンテキスト内の説明
デフォルト	はい	はい	常に表示
disable-model-invocation: true	はい	いいえ	いいえ
user-invocable: false	いいえ	はい	常に表示

/name はメッセージの先頭でのみ機能し、最大6つまで連鎖できます。スキルは引数を受け取れます。本文中の $ARGUMENTS には名前の後に入力した内容が入り、argument-hint はメニューにヒントを表示します。

Claude Code が標準に追加するフィールドには、トリガー説明を別途指定する when_to_use、スキルを別のモデルやエフォートレベルで実行する model と effort、allowed-tools と disallowed-tools、そしてスキルをサブエージェントで実行してその作業がメインの会話を埋めないようにする context: fork があります。

カスタムスラッシュコマンドはスキルに統合されました。.claude/commands/deploy.md と .claude/skills/deploy/SKILL.md はどちらも /deploy を作成し、既存のコマンドファイルも引き続き動作します。

Claude Code に同梱されるスキル

Claude Code のコマンドリファレンスでは、20 個のコマンドがスキルとして扱われています。その中でもよく使うものは次のとおりです。

スキル	内容
/code-review	差分、ブランチ、プルリクエストを指定した強度でレビューしてバグを探し、修正やコメントも行います
/simplify	4 つのレビューエージェントが再利用、簡素化、効率、抽象化の問題を探し、修正を適用します
/batch	大きな変更を 5〜30 個の単位に分割し、単位ごとにバックグラウンドエージェントを 1 つ実行します
/debug	セッションのデバッグログを有効にしてログを読みます
/loop	プロンプトを一定間隔で再実行するか、ペースを自動調整します
/run と /verify	アプリを起動し、変更が実際に機能するか確認します
/doctor	インストール、設定、拡張機能、CLAUDE.md をチェックします
/fewer-permission-prompts	よく承認する読み取り専用コマンドを許可リストにまとめます
/update-config	平易な説明から settings.json を編集します
/claude-api	最新の Claude API と SDK のリファレンスを読み込みます
/dataviz	パレットバリデータ付きのチャートとダッシュボードのガイダンス

新しいプロジェクト用に CLAUDE.md を書き出す /init はスキルではなく組み込みコマンドで、/review は /code-review のエイリアスです。Claude Code には Word、PDF、PowerPoint、Excel 向けの Anthropic のドキュメントスキルは同梱されていません。これらは anthropics/skills リポジトリからインストールしてください。

スキルにかかるコスト

Claude が自律的に呼び出せるスキルは、その説明文が毎ターンコンテキストに含まれます。Claude Code はこれを 2 つの方法で制限しています。

• 一覧では、各説明文は when_to_use と合わせて 1,536 文字で切り詰められます。
• すべての説明文は合わせて、モデルのコンテキストウィンドウの約 1% の予算を共有します。それを超えると、Claude Code は使用頻度の低いスキルから順に説明文を削除し、名前だけを残します。

一度使用されたスキルの内容は会話内に残ります。自動コンパクションの後、各スキルの直近の使用内容が再び付加されます。上限はスキルごとに 5,000 トークン、合計で 25,000 トークンです。

/skills はスキルの一覧を表示し、トークンコスト順に並べ替えられます。/skill-doctor は各スキルのコンテキストコストと使用頻度を報告します。手動でしか呼び出さないスキルには disable-model-invocation: true を設定してください。これにより、その説明文はコンテキストから完全に除外されます。

スキル、フック、サブエージェント、MCP、プラグインのどれを使うか

やりたいこと	使うもの	理由
Claude が毎セッション必要とする事実	CLAUDE.md	毎回読み込まれる。200 行以内に収める
一部のタスクに必要なノウハウ	スキル	関連するときだけ読み込まれる
毎回必ず実行したい処理	フック	決定的に動作し、コンテキストを消費しない。「ガードレールはフックに置く」
重い作業をコンテキストから切り離す	サブエージェント	別コンテキストで作業し、要約を返す
別システムのツールやデータ	MCP server	スキルで Claude に使い方を教えられる
上記すべてをチーム向けに	プラグイン	ひとつのインストールとしてまとめる

Anthropic が最も多くドキュメント化している組み合わせは、スキルと MCP server です。server がツールを提供し、スキルがいつどのように使うかの判断を提供します。

安全性

Claude Code のスキルは、ユーザーの権限と完全なネットワークアクセスで任意のスクリプトを実行できます。自分で作成していないスキルについては、そのスクリプトを必ず確認してください。allowed-tools を使うと、スキルは確認なしでツールを利用できるようになり、制限は一切かかりません。プロジェクトでは、プルリクエスト時に .claude/skills/ をコードをレビューするのと同じようにレビューしてください。組織では、管理設定によってこれを制限でき、承認済みのプラグインマーケットプレイスからのスキルのみを許可するといった設定も可能です。

動作しない場合

表示される内容	原因	対処
Claude がスキルを無視する	description が実際の言い回しと一致していない	description を書き直す。when_to_use を追加する
/name が見つからない	フォルダ名と name が異なる、または新規のトップレベルフォルダである	両者を一致させる。/reload-skills を実行する
プラグインのスキル名が異なる	プラグインのスキルには名前空間が付く	/plugin:name と入力する
一部のスキルの description が失われる	一覧の上限を超えている	未使用のスキルを削除する、または disable-model-invocation: true を設定する
自分のスキルが隠れる	同じ名前の組織スキルまたは個人スキルが存在する	自分のスキル名を変更する