Skills トリガーメカニズム
Skills はユーザーが「呼び出す」ものではなく、Claude が自主的に「使用するかどうか」を決定するものです。
このトリガーメカニズムを理解すると、より正確にトリガーされやすい Skill を書くのに役立ちます。
トリガーメカニズムの動作原理
Claude の起動時、利用可能なすべての Skill のnameとdescriptionをコンテキストに読み込みます。
ユーザーがメッセージを送信すると、Claude は「このタスクには、何らかの Skill を参照する必要があるか?」と判断します。
判断の根拠はただ一つ:Skill の description フィールド。
SKILL.md の本文(body)はトリガー判定に関与しません。Claude は特定の Skill の使用を決定した後にのみ、本文を読み取ります。
トリガープロセスの概略図

どのようなタスクが Skill をトリガーするのか
description にマッチするすべてのリクエストが Skill をトリガーするわけではありません。
Claude には内部的な判断があります:このタスクは、専用の指示を参照する必要があるほど複雑ですか?
| リクエストタイプ | 例 | Skill をトリガーするか | 理由 |
|---|---|---|---|
| シンプルな単一ステップタスク | 「この PDF を読み取って」 | 通常はトリガーしない | Claude が直接処理する方が効率的だから |
| 複雑な複数ステップタスク | 「PDF 内のテーブルを抽出して Excel に変換」 | トリガーする | 専用のワークフローが必要だから |
| 専門領域の操作 | 「3つの PDF を結合してウォーターマークを追加」 | トリガーする | 特定のツールチェーンが関わるから |
| 出力に明確な形式要件がある | 「当社のテンプレートに準拠した Word レポートを生成」 | トリガーする | 特定のフォーマット仕様が必要だから |
Skill がめったにトリガーされない場合、通常はタスクの説明が単純すぎるか、description の記述が十分に正確でないことが原因です。テストする際は、複雑で具体的なユーザーリクエストを使用してください。
Description のトリガー戦略
description はトリガーの唯一の根拠であり、その書き方がトリガー精度を直接決定します。
戦略1:具体的なシナリオを列挙する
「この Skill が何をするのか」だけでなく、「どのような場合にそれを使うべきか」も書きましょう。
# 不推荐:只描述功能 description: 处理 Excel 文件。 # 推荐:描述功能 + 触发场景 description: > 处理 Excel 和 CSV 文件,包括:读取数据、清洗格式、生成图表、 计算统计指标、合并多个表格。当用户提到 Excel、xlsx、CSV、 表格数据、数据清洗、财务报表时,应优先使用此 Skill。
戦略2:「促進的な」言語を使用する
Skills システムは本質的に「あまりトリガーしない」傾向があります。description に促進的な言語を加えることで、トリガー率を向上させることができます。
description: > 生成专业的 PowerPoint 演示文稿。当用户需要制作幻灯片、PPT、演讲稿、 汇报材料时,必须使用此 Skill,即使用户没有明确说"用 pptx 格式"。 只要涉及演示文稿的创建或修改,都应触发此 Skill。
戦略3:キーワードを列挙する
description の末尾にトリガーキーワードのリストを添付することは、シンプルで効果的な補助手段です。
description: > 代码审查助手,分析代码质量、发现潜在 Bug、给出改进建议。 关键词:code review、代码审查、代码分析、bug 检查、 重构建议、代码质量、静态分析。
トリガー競合:複数の Skill が同時にマッチする
ユーザーのリクエストが複数の Skill にマッチする可能性がある場合、Claude はマッチ度に基づいて最も関連性の高いものを選択します。
競合を避けるためには、異なる Skill の description に明確な境界を持たせる必要があります。
| 競合シナリオ | 解決策 |
|---|---|
| 2つの Skill が両方とも PDF を処理する | description で具体的な操作を区別する。「PDF 作成」と「PDF 読み取り」のように |
| 汎用 Skill と専用 Skill が重なる | 専用 Skill の description に、汎用 Skill とは区別されるシナリオを明確に記述する |
| 機能が類似した2つの Skill | 1つの Skill への統合を検討し、内部の分岐で異なるケースを処理する |
Skill の description は、単に「何ができるか」を記述するだけでなく、「排他的に」自身の適用シナリオを記述すべきです。できること ≠ いつ使うべきか、です。
Description 最適化ツールを使用してトリガーをテストする
skill-creator Skill には、トリガー精度を自動評価できる description 最適化スクリプトが用意されています。
実例
# --eval-set:テストケースファイルのパス
# --skill-path:最適化対象の Skill パス
# --max-iterations:最大反復回数
python -m scripts.run_loop \
--eval-set evals/trigger-eval.json \
--skill-path my-skill/ \
--model claude-sonnet-4-20250514 \
--max-iterations 5 \
--verbose
スクリプトはテストを自動実行し、スコアを評価し、description を修正して、最適な結果を出力します。
詳細な description 最適化方法は第24編を参照してください:Skills description 最適化テクニック。
その他の拡張