Skill Authoring Template

YAML frontmatter (MUST)

SKILL.md は必ず YAML フロントマターから始める。

最低限:

• name
• description（「何をする」＋「いつ使う」+「キーワード」）

禁止: description: | のようなマルチライン構文は使用しないこと。

Required sections (MUST)

• Inputs
• Outputs
• Forbidden
• Verification
• Evidence (which files/dirs informed this)

Naming (MUST)

• 小文字/数字/ハイフンのみ、64文字以内
• 予約語や紛らわしい語を避ける（例: anthropic / claude を含めない）
• 推奨: 一貫した命名パターン（公式は gerund: 動名詞形 “verb-ing” を推奨）

例（gerund）:

• testing-code
• writing-documentation
• managing-migrations

Guidance

• 手順は「誰がやっても同じ」粒度で具体的に
• 検証コマンドは repo に実在するものだけを書く