skill-authoring

• 構成と frontmatter は https://agentskills.io/specification に従う
• 文章は writing に従う
• ユーザーの読み方と考え方は humanity-and-humanness に従う
• 読み手の model 向けの書き方は https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices と、そこから辿れるガイドに従う

この skill が必要な理由と達成したい状態

この skill が必要な理由は、skill を書く AI がユーザーの判断を持っていないことにある。書く AI は足りない部分を自分の知識や一般的な文書の型で埋め、埋めた記述はユーザーの判断と同じ顔で skill に残る。読んだ AI は、それをユーザーの判断として実行する。

この skill で達成したい状態は、skill がユーザーの判断だけでできていることである。

必要な理由と達成したい状態のセクション

規則が当てはまらない場面で、モデルはこのセクションから判断する。だから本文に 1 つ置き、手順や規則と分ける。