/docs-site — orchestrator¶
Runs 2 agents. By DEFAULT it builds a generated multi-page site (MkDocs Material + gen-files + literate-nav) with a tree/sidebar nav, one page per entity, and embedded diagrams — rebuilt from the source files on every commit so it cannot drift. Pass --single for one self-contained theme-aware HTML page instead (a snapshot, for hand-maintained prose). Pass --docusaurus for a Docusaurus 3 site (custom React navbar/homepage, MDX pages, npm toolchain) when the deliverable needs that branded look — regenerated from source before every build rather than virtually built, so its anti-drift guarantee is weaker than the MkDocs default. Auto-derives the menu/sections, grounds everything in the source (flags gaps rather than inventing), embeds auto-redacted screenshots via the capture-screenshots pipeline when needed, and PROPOSES the commit.
The pipeline¶
What it runs, in order¶
| # | Agent | What it does |
|---|---|---|
| 1 | docs-architect |
Turn documentation sources (existing docs, a codebase, an outline, or structured… |
| 2 | docs-designer |
Turn a structured doc model into a browsable documentation surface. By default it emits a… |
At a glance¶
| Class | authoring |
| Cost | 1–2 agent calls |
| Skill page | /docs-site |
| Source | skills/docs-site/SKILL.md |