本文へスキップ
Kitbay

Claude Skillsとは?

Kitbay編集部 ·

Claudeのスキル(Claude Skills)とは、SKILL.mdというファイルを中心にした指示のフォルダで、特定の種類のタスクのやり方をClaudeに教えるものです。Claudeが普段把握しているのは各スキルの名前と説明だけで、リクエストに必要になったときに、指示の全文、スクリプト、参照ファイルを開きます。

スキルの用途

スキルは、本来ならチャットのたびに繰り返し説明することになる手順を、文章にまとめたものだと考えてください。チームのレポートの書式、リリース前のチェックリスト、PDFフォームの記入手順、社内データベースへのクエリのルールなどです。Anthropicのドキュメントでは、スキルを新しい同僚向けのオンボーディングガイドにたとえています。ノウハウをまとめておけば、該当する作業が発生したときにClaudeがそれを参照して進めてくれます。

Claude Codeのドキュメントでは、実用的な目安が示されています。同じ指示を何度も会話に貼り付けているなら、そのテキストはスキルにする候補です。常に読み込まれるプロジェクトのメモとは違い、スキルの本文は使われるときにだけ会話に入ります。

スキルは、agentskills.ioで公開されているオープンなAgent Skills形式に従います。Anthropicはこの形式を2025年12月にオープン標準としてリリースしました。そのため、同じフォルダをClaude以外でも使えます。各ツールのドキュメントによると、Codexは.agents/skillsフォルダから、Gemini CLIは.gemini/skillsまたは.agents/skillsからスキルを読み込みます。

スキルの中身

スキルはディレクトリです。必須なのはSKILL.mdだけで、それ以外はすべて任意です。

pdf-forms/
├── SKILL.md        required: front matter + instructions
├── scripts/        code the agent can run
├── references/     extra documents read on demand
└── assets/         templates, images, data files

SKILL.mdとフロントマター

SKILL.mdは、2行の---で囲まれたYAMLフロントマターで始まり、その後にMarkdownで書いた指示が続きます。Agent Skillsの仕様では、次のフィールドが定義されています。

フィールド 必須 仕様の内容
name はい 64文字以内。使えるのは英小文字、数字、ハイフン。先頭と末尾のハイフン、ハイフンの連続は不可。フォルダ名と一致させる必要がある
description はい 1,024文字以内。スキルが何をするか、いつ使うかを書く
license いいえ ライセンス名、または同梱のライセンスファイルへの参照
compatibility いいえ 必要なパッケージやネットワークアクセスなど、環境の要件(500文字以内)
metadata いいえ 自由形式の文字列のキーと値
allowed-tools いいえ 事前承認するツール。実験的機能とされており、対応状況はエージェントによって異なる

AnthropicのAPIには独自の制限が2つあります。名前に予約語の「anthropic」や「claude」は使えず、どちらのフィールドにもXMLタグを含めることはできません。

特に重要なのは説明文です。Claudeはスキルを開くかどうかを判断するときに、このテキストとリクエストを照らし合わせます。そのため、どんな仕事をするのかと、どんな状況で使うべきかの両方を書いておく必要があります。

Claude Codeでは、disable-model-invocation(スキルを起動できるのはユーザーだけ)やcontext: fork(サブエージェントで実行)など、追加のフロントマターフィールドも使えます。ただしドキュメントでは、Claude Code以外(たとえばclaude.aiへのアップロード時)では標準のフィールドしか受け付けず、不明なキーがあるとエラーになると注意しています。

指示

Markdownの本文に決まった書式はありません。手順を追った指示、入力と出力の例、エッジケースについての注意を書くのが一般的です。Anthropicと仕様のどちらも、メインのファイルは500行未満に抑え、長い内容は別のファイルに分けることを勧めています。

スクリプト

scripts/内のファイルは、エージェントが実行するプログラムです。Python、Bash、JavaScriptで書かれることが多いです。Claudeがスクリプトを実行しても、コード自体は会話に入らず、出力だけが追加されます。Anthropicはこれを、フォームの検証のような決まった処理を、毎回モデルにコードを書き直させるのではなく、同じ結果が得られる形で実行する方法として紹介しています。

参照ファイルとアセット

references/には、APIリファレンスやデータベーススキーマなど、手順で必要になったときにだけエージェントが読むドキュメントを入れます。assets/にはテンプレート、画像、データファイルを入れます。仕様では、これらのファイルにはSKILL.mdから直接リンクし、ファイルからさらに別のファイルへとたどらせる構成は避けるよう勧めています。

Claudeがスキルを読み込む仕組み

スキルは段階的に読み込まれます。Anthropicはこの設計をプログレッシブディスクロージャー(段階的な開示)と呼んでいます。

段階 タイミング おおよそのコスト
名前と説明 毎回のセッション開始時 スキル1つあたり約100トークン
SKILL.mdの本文 リクエストが説明と合致したとき 5,000トークン未満を推奨
スクリプト、参照ファイル、アセット 指示から参照されたときだけ 読むまではゼロ。スクリプトは出力の分だけ

典型的な流れを見てみましょう。PDFからテキストを抜き出すようClaudeに頼むと、ClaudeはPDFスキルの説明が合うと判断し、そのSKILL.mdを読んで指示に従います。フォーム記入用の参照ファイルは、このタスクには不要なので読み飛ばします。

Claude Codeでは、/に続けてスキル名を入力して(例:/summarize-changes)、自分でスキルを起動することもできます。一度読み込まれた指示は、その後のやり取りでも会話に残ります。

Claudeのスキルが使える場所

  • Claude Code: 個人用のスキルは~/.claude/skills/<name>/SKILL.mdに、プロジェクト用のスキルはリポジトリ内の.claude/skills/に置きます。プラグインでさらにスキルを同梱することもできます。
  • claude.ai: スキルをzipファイルとしてアップロードします。Anthropicによると、カスタムスキルはPro、Max、Ultra、Team、Enterpriseの各プランで、コード実行を有効にしている場合に使えます。
  • Claude API: スキルはコード実行コンテナの中で動作します。AnthropicはPowerPoint、Excel、Word、PDFファイル向けの既製スキルを提供しており、自作のスキルもアップロードできます。APIのスキルはネットワークにアクセスできません。

カスタムスキルはこれらの環境の間で同期されません。claude.aiで追加したスキルはAPIからは使えず、Claude Codeのスキルはそのどちらとも別です。

スキルとMCPサーバー

スキルは手順を教え、MCPサーバーはエージェントをほかのシステムにリアルタイムでつなぎます。両者は一緒に使われることがよくあります。たとえば、サーバーがプロジェクト管理ツールの内容を読み取り、スキルがチームでのチケットの書き方を示すといった具合です。違いについてはMCPサーバーとエージェントスキルの比較で詳しく説明しています。もう一方についてはMCPサーバーとはをご覧ください。

安全上の注意

スキルは、エージェントにコードを実行させたり、ファイルやアカウントに対してツールを使わせたりできます。Anthropicは、信頼できる提供元のスキルだけを使い、同梱のファイルをすべて事前に読んで、スキルの目的に合わないネットワーク通信やファイルアクセスがないか確認するよう勧めています。Claude Codeでは、スキルはコンピューター上のほかのプログラムと同じようにネットワークにアクセスできます。より詳しいチェックリストは、サーバーとスキルのセキュリティに関するチェックポイントにあります。

スキルを探す・作る

Kitbayに掲載しているエージェントスキルを見るか、ドキュメントを扱うスキルやライティング・編集のように用途から探してみてください。各掲載には、スクリプトが含まれているかどうかと、ソースへのリンクを表示しています。自分で書く場合は、スキルの作り方をご覧ください。

よくある質問

Claudeのスキルとは何ですか?
スキルとは、名前、説明、指示を書いたSKILL.mdファイルを含むフォルダです。Claudeは名前と説明を常に把握しており、リクエストが合致したときにだけ指示の全文を読みます。
スキルはClaudeでしか使えませんか?
いいえ。スキルはオープンなAgent Skills形式に従っていて、CodexやGemini CLIなどほかのエージェントも、SKILL.mdフォルダへの対応をドキュメントに明記しています。ただし、特定の製品に固有のフィールドは、ほかの環境では無視されたり、エラーになったりすることがあります。
スキルでコードを実行できますか?
はい。スキルにはエージェントが実行するスクリプトを含めることができ、会話に入るのはスクリプトの出力だけです。だからこそ、インストールする前にスキルのファイルを読んでおくべきです。
スキルはClaude Code、claude.ai、APIの間で同期されますか?
いいえ。Anthropicのドキュメントによると、カスタムスキルはこれらの環境の間で同期されないため、使う場所ごとに個別に追加する必要があります。

出典

ほかのガイド