What problem does it solve? Standing up a documentation site that stays consistent as it grows is hard: pages drift from the intended structure, diagrams silently render as code, links break under a deploy base path, and stale recommendations ship unnoticed. This Skill scaffolds a decision-oriented Astro + Starlight handbook where every topic follows a fixed nine-section skeleton and nine dependency-free CI gates fail the build the moment content drifts from the contract, making agent-authored documentation safe to ship. ## Core Features & Use Cases - Mode A — Scaffold a new site: Copy a complete, gate-passing Astro + Starlight site from the bundled template, substitute five placeholders (package name, site title, description, deploy base, GitHub Pages host), then install and verify. - Mode B — Author content: Add a single topic page from the canonical template or a whole cluster (directory with overview plus topics), wiring each into the sidebar and home page, then re-verify. - Nine CI gates: Template integrity, pages-built, frontmatter dates, section skeleton, accessibility/no-JS, artifact hygiene, internal links, mermaid usage, and content freshness — all dependency-free Node scripts. - Use Case: Ask the agent to stand up a new engineering handbook for your team; it copies the scaffold, fills in your site title and GitHub Pages host, and delivers a site that passes all nine gates out of the box with one example cluster. ## Quick Start Ask the agent to scaffold a new Astro Starlight handbook site named my-handbook with a title, description, and GitHub Pages host, then run npm install and npm run verify.
