Skip to content

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 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.

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.