create-skill

スキルの作成

スキルは、能力のあるエージェントを適切な方向へ導くものです。手順書ではありません。エージェントの判断を信頼し、自力ではうまくできないことだけを書いてください。

Frontmatter

• name：小文字のケバブケースにし、ディレクトリ名と一致させます。
• description：ルーティングの情報はすべてここに記述します。本文は有効化されてから読み込まれるためです。書式は [何をするか]。次の場合にこのスキルを使用します：[トリガー]。次の場合は使用しません：[類似するが対象外のケース]。 とします。1024 文字未満にしてください。

本文

• 1 つのスキルにつき 1 つの役割にします。500 語を大きく下回る長さを目指してください。
• 重要なこととその理由を、平易な文または短い箇条書きで伝えます。エージェントが既定で行うことは省いてください。
• 破壊的な操作、セキュリティ上重要な操作、または壊れやすい操作など、間違いのコストが高い場合に限り、正確な手順を指示します。
• 形式のためだけにプロセスを追加しないでください。チェックリスト、中止条件、ラベルの仕組み、レポートファイル、レビューの反復、サブエージェントの使用指示は追加しないでください。
• ニッチなエッジケースは扱いません。すべてのルールについて、本当に起こりやすい間違いを防ぐものかどうかを問い、そうでなければ削除してください。
• references/、assets/、scripts/ を追加するのは、実際に大規模な資料や再利用可能な資料がある場合に限り、それぞれのファイルをいつ使うかも記載してください。
• 他のスキルには、その名前で言及し、ファイル内のパスでは言及しないでください。

仕上げ

• このリポジトリで node scripts/validate-skill-metadata.mjs <skill> と node scripts/validate-skill-links.mjs <skill> を実行します。
• 現実的なタスクでスキルを一度試し、実際に問題になった点を修正します。