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 つ置き、手順や規則と分ける。 - 「この skill が必要な理由は」で書き出す段落を 1…