initlisted

Bootstrap docaudit for a repo that has no .claude/doc-audit.json yet. Use when the user asks to set up docaudit, initialize the doc-audit harness, or run docaudit on a repo that lacks /check-docs / /review-docs / doc-lint. Inventories the repo, proposes a doc-audit.json config for approval, writes it, and points to the first audit. Generative (creates new config only); never edits existing docs.
akira993/doc-audit-harness · ★ 2 · Data & Documents · score 78

Install: claude install-skill akira993/doc-audit-harness

# docaudit:init — bootstrap a repo's doc-audit adapter Creates `${CLAUDE_PROJECT_DIR}/.claude/doc-audit.json` for a repo that has none. Generative but additive: you may CREATE new config/state files; you must NOT edit or rewrite any existing doc. Always propose the draft and get explicit user approval before writing. `SD="${CLAUDE_SKILL_DIR%/init}/audit"` (the audit skill dir holding the shared scripts). If `.claude/doc-audit.json` already exists, stop and tell the user (offer `/docaudit:audit` instead) — do not overwrite it. ## Step 1 — inventory (deterministic) Run: `python3 "$SD/scripts/inventory.py" --repo-root "$CLAUDE_PROJECT_DIR"`. Parse the JSON: docDirs, docGlobs, frontMatter, suggestedFrontMatterFields, codeDirs, suggestedDiffGlobs, existingDocTools, boundaryCommandGuess, indexFiles, mentions. (Optional enrichment: if `markdown-query`/CocoIndex/Serena are available you may use them to refine the impactMap couplings — they are NOT required; inventory.py alone suffices. CocoIndex needs `sentence_transformers`; skip it if unavailable.) Also run `command -v mdq`: if present, this repo can use conditional-force indexing — propose an `indexing` block in Step 2. ## Step 2 — draft the config Build a `doc-audit.json` draft from the inventory: - `anchorPath`: `.claude/state/last-doc-audit.json`. `diffGlobs`: `suggestedDiffGlobs`. `docGlobs`: inventory `docGlobs`. `indexFiles`: inventory `indexFiles`. - `frontMatterFields`: include `suggestedFrontMatterFields` ONLY if th