Skip to main content

スキル仕様

最低限 SKILL.md が必要です。その他のファイルはタスクに応じて追加します。
my-skill/
├─ SKILL.md
├─ references/
│  └─ review-rules.md
├─ scripts/
│  └─ check_input.py
└─ assets/
   └─ report-template.md

SKILL.md

YAML frontmatter と Markdown 本文を使います。メタデータに名前と用途、本文に入力、手順、判断、出力、失敗時の処理を記述します。

references/

長い仕様、用語、例、業務規則を保存します。いつ読むかを説明し、毎回すべて読み込ませないようにします。

scripts/

検証、変換、計算処理を保存します。環境、依存関係、入力、出力、失敗時の説明を書きます。手順のみのスキルにスクリプトは不要です。

assets/

成果物に使うテンプレートや画像を保存し、同梱ファイルと相対パスを一致させます。

指示と互換性

名前と利用条件を明確にし、認可の回避や外部資料の指示としての実行を求めないでください。外部ツールの接続と権限を説明し、認証情報を同梱しないでください。対応クライアントとバージョンは実際の検証に基づいて記載します。 起動、手順完了、資料読み取り、結果の検証を確認します。次へ:スキルを作成。