メインコンテンツまでスキップ

スキル: オンデマンドの専門知識

上級
What you'll learn
  • スキルとは何か、そしてすべてを CLAUDE.md に詰め込むのと何が違うのかを定義する
  • SKILL.md（フロントマター＋指示）を読み書きし、なぜ description がトリガーなのかを理解する
  • 漸進的開示とは何か、なぜ多数のスキルがコンテキストを膨らませずにスケールできるのかを説明する
  • スキルが存在する 3 つの場所を知る：個人、プロジェクト、プラグインに同梱
  • スキル、スラッシュコマンド、サブエージェント、MCP のあいだで正しく選ぶ
  • スキルが起動しない原因となる、よくある 4 つの間違いを避ける

スキルは専門知識 — 指示に加え、任意のスクリプトとリソース — をパッケージ化し、Claude が関連するときだけ読み込むものです。すべてを CLAUDE.md に詰め込む代わりに、Claude が必要に応じて引き込む能力のライブラリを与えます。

構造​

スキルは SKILL.md を含むフォルダです：YAML フロントマター ＋ 指示。

---
name: pdf-forms
description: Use when the user needs to fill, read, or generate PDF forms.
---

# PDF Forms
Steps and rules for working with PDF forms…
(optionally reference scripts/ or resources/ in this folder)
Pro tip
  • description がトリガーです — Claude はそれを読んでスキルをいつ起動するかを決めます。「Use when…」の形で、適切なタイミングで読み込まれ、それ以外では読み込まれない程度に具体的に書きましょう。

漸進的開示（なぜスキルはスケールするのか）​

Claude はすべてのスキルの本体を最初から読み込むわけではありません。軽量な name ＋ description だけを見て、リクエストが一致したときにのみ完全な指示を引き込み（そしてスクリプトを実行）ます。これにより、多くのスキルをインストールしてもコンテキストはスリムに保たれます。

どこに置くか​

Guided walkthrough1 of 3
  1. ~/.claude/skills/<name>/SKILL.md — あなた専用のまま、すべてのプロジェクトで利用可能。

AILmanac には 7 つの既製スキルパックが同梱されています。1 つコピーして試してみましょう。

実例：自分自身を起動するスキル​

~/.claude/skills/release-notes/SKILL.md を作成します：

---
name: release-notes
description: Use when the user asks to write release notes or a changelog from git history.
---

# Release Notes
1. Run `git log <last-tag>..HEAD --oneline` to get the commits.
2. Group them into Features / Fixes / Breaking changes.
3. Write user-facing notes — what changed for *users*, not commit messages.
4. Output Markdown ready to paste into a GitHub release.

後で下のプロンプトを入力します。Claude はこれらのステップをコンテキストに持っていませんでしたが、リクエストが description に一致するので、完全な SKILL.md を引き込み、git log を実行し、グループ化されたノートを生成します。名前で何かを呼び出したわけではありません。description がルーティングをしたのです。同じフォルダに scripts/ ファイルを追加すれば、スキルはステップ 1 の一部としてそれを実行できます。

意図でスキルを起動する — 名前は不要

Draft release notes since v1.4.

スキル vs コマンド vs サブエージェント vs MCP​

ツールそれが何かあなた vs Claude のどちらが起動するか
スラッシュコマンド保存されたプロンプトあなたが呼び出す
スキルオンデマンドの専門知識 ＋ スクリプトClaude が関連するときに読み込む
サブエージェント独自のコンテキストを持つ委任されたエージェントClaude が委任する
MCP外部ツール/データへの接続呼び出すツールを提供する
Key takeaways
  • オンデマンドで自分で発火させたい → スラッシュコマンド。
  • Claude が手順を知っていて、関連するときに適用すべき → スキル。
  • 作業を別のコンテキストで行わせたい → サブエージェント。
  • 外部システムに到達する必要がある → MCP。

よくある間違い​

Watch out
  • 起動しない description。「PDF を扱うのに役立つ」は曖昧すぎます。「Use when the user needs to fill, read, or generate PDF forms」は、いつ読み込むべきかを Claude に正確に伝えます。description は起動メカニズムそのものです。人間向けではなくマッチング向けに書きましょう。
  • 代わりにすべてを CLAUDE.md に入れる。CLAUDE.md は毎セッション読み込まれ、常にコンテキストを消費します。スキルは関連するときだけ読み込まれます。状況依存の手順はスキルに移し、CLAUDE.md には常に真であるプロジェクトのルールだけを残しましょう。
  • 1 つの巨大なスキル。小さく、鋭く記述された多数のスキルのほうが、1 つの何でも屋よりうまくルーティングされます。漸進的開示は各 description が具体的なときにのみ役立ちます。
  • 共有できることを忘れる。.claude/skills/ にあり git にコミットされたプロジェクトスキルは、チーム全員にその能力を与えます。~/.claude/skills/ にある個人スキルはあなた専用のままです。

用語のおさらい​

Enter キーまたはスペースキーでカードを裏返します。左右の矢印キーでカードを移動できます。用語を表示しました。
1 / 6

理解度チェック​

理解度チェック

0/5
  1. SKILL.md において、Claude がいつスキルを起動するかを実際に決めるのは何ですか？
  2. 漸進的開示とは何ですか？
  3. **チーム全員**に git 経由で能力を届けたい。スキルをどこに置きますか？
  4. 自分で、オンデマンドで、名前で何かを発火させたい。どのツールが合いますか？
  5. 状況依存の手順を CLAUDE.md に入れるより、スキルを好むのはなぜですか？

次へ​