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 最適化スクリプトが用意されています。

実例

# 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 最適化テクニック。

その他の拡張