SKILL.md の description を書き間違えると、スキルは永遠に呼ばれない
この記事で分かること
SKILL.mdのdescriptionを正しく記述しないと、スキルが永遠に呼び出されなくなるという落とし穴が分かる。スキル定義ファイルにおけるdescriptionの役割と、記述ミスが引き起こす影響が具体的に示されている。正しいdescriptionの書き方や、スキルが呼び出されない場合のトラブルシューティングの手順が実践的なポイントとなる。
詳細要約
SKILL.mdのdescriptionが実際の機能とズレていると、AIがそのスキルを適切な場面で呼び出せなくなる。記述内容は、スキルが発動する条件を決めるため、正確かつ具体的に書く必要がある。例えば「天気を取得する」ではなく「指定された都市の現在の天気と気温を、JSON形式で返す」のように、入力と出力を明確に定義する。また、descriptionは短く抽象的にせず、他のスキルと重複しないユニークな役割を一文で示すことが重要。