What it is
A skill that turns notes or a rough idea into a deployed Starlight docs site you review, then hand to a coding agent to build from — the docs are the spec.
Docs-Spec
Write a product's docs before it exists, deploy them as a real site, and build from them. Then measure whether the doc tweaks actually help.
How it works Read the eval findings
What we learned
For a capable agent, baseline docs already transmit intent well; build fidelity is ceiling-bound. The one tweak that measurably improves the docs is a Motivation page. Bundling every tweak made it worse.
Start here
Section titled “Start here” How it works The five-phase workflow, end to end.
Motivation Why docs-as-spec — the forcing function and the lineage.
Eval findings The 3-axis results and the keep/cut verdicts.
Roadmap What's shipped and what's next.