doc-lint

# Documentation linting Lint and fix documentation issues in markdown and MDX files. This skill runs Vale for prose style and rumdl for markdown formatting, then applies fixes based on the output. ## Quick reference | Tool | Recipe | What it checks | | ------------ | -------------------- | -------------------------------------------- | | Both | `just lint-docs` | Run spelling, prose, and markdown linting together | | cspell | `just lint-spelling` | Spelling errors, typos, and misspellings. | | vale | `just lint-prose` | Prose style, AI vocabulary, hedging, clarity | | rumdl | `just lint-markdown` | Markdown formatting, structure | <!-- vale ai-tells-experimental.HeadingTitleCase = NO --> ## Core workflow ### Step 1: Run linters Run both linters on the target files. **For specific files:** ```bash just lint-docs path/to/file.md ``` **For all files:** ```bash just lint-docs ``` You can also run linters individually with `just lint-spelling`, `just lint-prose`, or `just lint-markdown`. ### Step 2: Interpret output Categorize issues by type: 1. **Auto-fixable markdown issues** - Fix directly: heading levels, list formatting, spacing 2. **Prose style issues** - Require judgment: rewrite sentences, simplify language 3. **Spelling issues** - Decide: add to accept.txt or cspell.json or rewrite 4. **Vocabulary issues** - Decide: add to accept.txt and/or cspell.json or...