| name | iii-doc-authoring |
| title | iii-doc-authoring |
| description | Skill bundle index for authoring Mintlify-shaped docs that iii-skill-check validates. |
| type | reference |
iii-doc-authoring
How to write Mintlify-shaped .md / .mdx docs that iii-skill-check validates and renders into per-doc skill artifacts (<source>.skill.md siblings).
Read individual topics directly via skillkit read iii-doc-authoring/<topic>.
Topics
quickstart: minimum viable docs project: .skill-check.yaml, frontmatter, the verify command.frontmatter: required and optional fields; how type: drives voice rules.types: short summary of which Vale and AI rules each Diataxis category enables.markers: <!-- skill:... --> HTML-comment markers for opting docs in/out and including/excluding sections.voice: pointer to project-rules/voice.md plus per-type call-outs.llm-only-blocks: when to wrap content visible only to AI consumers.check: running iii-skill-check verify locally on a docs root.
Authoring guides per Diataxis quadrant
These five files are skillkit-shape skills (their frontmatter uses name: + description: instead of the Mintlify shape the validator looks for, and they're excluded from the docs-mode pipeline). Load doc_workflow once for any docs work, plus the quadrant-specific file that matches the page you're writing.
The runtime Vale config is generated per-run from each doc's frontmatter type:. Diataxis rules apply to the right artifacts without depending on directory layout.
This bundle is not itself a worker. There is no iii.worker.yaml, no rendering step. The markdown files in this directory are the source of truth.
