starlight-handbook-kit

The key words MUST, MUST NOT, SHOULD, SHOULD NOT and MAY in this skill are to be interpreted as described in BCP 14 (RFC 2119, RFC 8174) when, and only when, they appear in all capitals.

Build and grow a decision-oriented engineering handbook: an Astro + Starlight static site where every topic is shaped identically (a fixed nine-section skeleton), diagrams and interactive widgets render usefully without JavaScript, and nine dependency-free CI gates fail the build the moment a page drifts from the contract. The gates are what make it safe to let an agent author content — a dropped page, an undated topic, a fenced-mermaid mistake, or a broken link all fail loudly instead of shipping.

Locating this skill's helpers (do this first). The steps below run bundled scripts. You execute from the target repo, not from this skill's directory, so a path written relative to this skill will not resolve. Resolve the base directory once and use it everywhere — including in any subagent prompt, which MUST receive the literal absolute path: