skill-builder

スキルビルダー

エージェントスキルを作成、検証、改善します。

クイックスタート

1. 機能、トリガー、必要なドメイン知識を集めます。
2. シンプルな単一ファイルのスキルにするか、参照ファイルを含む複数ファイルのスキルにするかを選びます。
3. 簡潔で、トリガーに焦点を当てた指示を記述して SKILL.md を作成します。
4. SKILL.md が冗長になる場合に限り、詳細を記載した参照ファイルを追加します。
5. YAML フロントマター、ファイル構成、命名を検証します。
6. ユーザーが使いそうな自然言語でスキルをテストします。

ワークフロー

• 要件とスコープ管理から始めます。
• コンテンツを書く前に構成を設計します。
• 説明は三人称で記述し、トリガーとなるキーワードを含めます。
• 長い例、テンプレート、検証の詳細には段階的開示を用います。

ゲート

順番に従ってください。合格とは、内部的な「完了した」という感覚ではなく、具体的な成果物（記述した箇条書き、パス、行数、解析済み YAML など）で満たせるチェックを指します。

1. 要件 — 合格： 機能、トリガー、必要なドメイン知識（または「なし」と明記）が記録されているか、ユーザーに確認済みです。
2. 構成 — 合格： 単一ファイルにするか、SKILL.md + references/ にするかを選択済みです。詳細な内容は SKILL.md に直接記載せず、参照ファイルにあります。
3. ドラフト — 合格： フロントマターは name と description を含む有効な YAML です。SKILL.md は 500 行以下です。SKILL.md 内の相対リンクはすべて、このスキルディレクトリ内に存在するパスを参照しています。allowed-tools がある場合、各エントリには妥当な理由があります。
4. トリガーチェック — 合格： description に合致する可能性のある自然言語のユーザーフレーズを少なくとも 1 つ特定し、簡易呼び出しテストに使います。

検証

• SKILL.md は 500 行未満にします。
• 参照リンクは 1 階層までを推奨します。
• 時間の経過で古くなる指針は避けます。
• フロントマターが有効な YAML であることを確認します。
• allowed-tools の各エントリが必要かつ適切であることを確認します。

高度なリファレンス

ワークフロー全体、テンプレート、例、検証チェックリストについては、references/skill-builder-guide.md を参照してください。