User documentation
Use this skill for public documentation in user-docs/, not for internal
architecture records, ADRs, or implementation plans.
Workflow
- Read
user-docs/_README.md. It is the repository-owned authoring and information-architecture contract. - Decide whether the change belongs in
user-docs/, then find the existing page that answers the reader's question. Extend that page before adding a new one. - Verify every behavioral claim against the shipped code and public configuration.
Read the relevant
docs/architecture/anddocs/adr/material named by the contract, then verify the deployed surface.docs/usage/contains historical compatibility pointers and is not a source. A port or constructor does not establish availability. - Follow the contract for placement, front matter, links, prose, and deployment
boundaries. If the shared
tech-writerskill is available, it can provide additional editorial guidance, but it is not required. - Run
task site:buildfrom the repository root. Report any claim that could not be verified instead of guessing.
For Docusaurus infrastructure and commands, consult
website/AGENTS.md. Keep this skill short: the
authoring contract is its single source of repository-specific rules.