結論から
Skill は、中に SKILL.md ファイルが入ったフォルダです。ファイルの冒頭には name と description を含む短いヘッダーがあり、その後に指示が続きます。エージェントは依頼が一致するまで name と description だけを覚えておき、一致したときに残りを読み込みます。同じフォルダが Claude Code、Codex、Cursor で使えます。
Skill が生まれた理由
こんな経験はありませんか
ランディングページ用に 40 行のプロンプトを持っているとします。レイアウト、セクション構成、スマートフォン幅でのチェック項目まで書き込んであります。毎回それを貼り付けていたのに、一度 1 行抜け落ちただけで、ページの仕上がりが変わってしまいました。そしてチームメイトに「あのプロンプト」を頼まれて、先月の古いコピーを送ってしまうのです。
Skill は、そのプロンプトをエージェントが自分で見つけられるフォルダに変えます。たとえば Meridian Marketing Landing をインストールすれば、エージェントは方眼紙風の Hero、機能グリッド、料金の切り替えを最初から知っています。あなたが用意するのは、プロダクトの情報だけです。
Claude Skills の例の多くは、同じパターンに従っています。1 種類の成果物を作るための決まった手順です。Notion Style OG Image は 16:9 のシェア画像を作り、Skillry にあるほかの Skill はスライド、履歴書サイト、ショート動画などを作ります。
| 貼り付けるプロンプト | Skill | |
|---|---|---|
| 説明すること | レイアウト、セクション、スタイル、チェック項目を毎回 | コンテンツだけ |
| 実行ごとの違い | 毎回少しずつぶれる | 同じ手順に従う |
| 共有 | チャット履歴から掘り出す | 同じフォルダをインストールする |
SKILL.md ファイルの中身は？
Skill に必要なファイルは SKILL.md の 1 つだけで、参考資料、スクリプト、テンプレート用のフォルダを任意で追加できます。ファイルは 2 つの部分からなります。--- 行で囲まれた短いヘッダーと、その後に続くエージェント向けの平易な指示です。
launch-page/
├── SKILL.md required
├── references/ optional: docs read when needed
├── scripts/ optional: code the agent can run
└── assets/ optional: templates and files---
name: launch-page
description: Build a product launch page with a hero, a feature
grid, and a pricing toggle. Use when asked for a launch page.
---
1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.name
64 文字以内で、小文字、数字、ハイフンを使います。フォルダ名と一致させる必要があります。
description
1,024 文字以内。Skill が何をするのか、そしていつ使うのかを書きます。エージェントは後半部分を頼りに Skill を選びます。
任意
license、compatibility、metadata、allowed-tools
これらの制限はオープンな Agent Skills 仕様に基づきます。Claude Code はより緩やかで、name を省略するとフォルダ名が使われます。
エージェントはどうやって使う Skill を決めるのか？
あなたの依頼と、各 Skill の description を照らし合わせます。その負荷を抑えるため、すべての Skill を 3 段階で読み込みます：
- 1起動時には、インストール済みのすべての Skill の name と description だけを読み込みます。
- 2依頼が description に一致したとき、または Skill を名前で呼び出したときに、
SKILL.md全体を読み込みます。 - 3作業中は、指示に書かれているときだけ
references/のファイルを開いたりscripts/を実行したりします。
だからこそ、数十個の Skill をインストールしてもエージェントは遅くなりません。必要になるまで、Skill が占めるコンテキストはおよそ 1 文分です。
| エージェント | Skill を名前で呼び出す |
|---|---|
| Claude Code | /skill-name |
| Codex | $skill-name、または /skills から選択 |
| Cursor | /skill-name、または @skill-name で添付 |
自動選択の精度は description の書き方しだいです。選ばれる description の書き方はトリガーの仕組みで解説しています。それまでは、名前で呼び出せば必ず動きます。
Skill を使えるエージェントは？
名前を聞いたことのあるエージェントの大半が対応しています。Anthropic が Claude 向けにこの形式を作り、2025 年 12 月 18 日にオープンスタンダードとして公開しました。現在 agentskills.io には、Claude Code、ChatGPT と Codex、Cursor、VS Code、GitHub Copilot、Gemini CLI など、この形式を読み込める数十のツールが掲載されています。
| エージェント | 個人用フォルダ |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/（旧来の ~/.codex/skills/ も読み込みます） |
| Cursor | ~/.cursor/skills/ または ~/.agents/skills/ |
個人用フォルダにある Skill は、そのコンピューター上のすべてのプロジェクトで使えます。プロジェクト用フォルダや、エージェントが参照するほかの場所は、Skill の保存場所にまとめています。
Skill とプロンプト、どちらを使うべき？
繰り返し行うタスクで、毎回同じ品質がほしいなら Skill にしましょう。一度きりなら、プロンプトで十分です。
また同じことをする
- 例、スクリプト、チェックリストが必要
- 毎回同じ結果がほしい
- ほかの人も使う
一度きりの作業
- 数文で説明できる
- まだ何がほしいのか模索している
- 再利用する価値のある部分がない
たいていは両方を使います。プロンプトで今日やりたいことを伝え、Skill でそれを上手にこなす方法を伝えるのです。詳しくは Skill とプロンプトの違いをご覧ください。
Skill をインストールする前に確認すること
Skill はあなたのコンピューターでスクリプトを実行できるため、新しい Skill は必ず先にざっと目を通しましょう。
5 分でできるチェック
SKILL.mdを読み、何を変更できるのかを把握する。scripts/の中身をすべて読む。これらのスクリプトはあなたのマシンで実行されます。- Skill ページの 依存関係 と 外部コスト を確認する。
- パスワードや API key を Skill のファイルやチャットに入れない。
よくある質問
Claude Skills とは何ですか？
Claude や Claude Code で Agent Skills を使うときに、多くの人が呼んでいる名前です。形式は同じで、SKILL.md ファイルを含むフォルダです。同じフォルダは Codex や Cursor でも動きます。
Claude はどうやって使う Skill を判断しているのですか？
あなたの依頼を各 Skill の description と照らし合わせ、合うものを読み込みます。/skill-name と入力すれば、推測を挟まずに呼び出せます。
Claude Skills は無料で使えますか？
Skill は単なるファイルなので、無料の Skill ならコストはかかりません。ただし、Claude Code、Codex、Cursor など Skill に対応したエージェントが必要で、その製品が求めるプランに加入している必要があります。Skillry にも Dot Avatar Maker のような無料の Skill があります。
Skill と MCP サーバーは同じものですか？
違います。Skill はエージェントにやり方を教え、MCP サーバーはエージェントを外部のデータやツールにつなぎます。両者を組み合わせて使うこともよくあります。Skill と MCP の違いをご覧ください。
出典
このガイドは役に立ちましたか？