← ClaudeAtlas

docs-consolidatelisted

Audit a repo's documentation for internal contradictions, stale claims, orphans and bloat after it has accumulated commits, then report findings for the user to disposition. Use when the docs-sync-guard nudge fires, or when the user asks to consolidate, audit, or spring-clean the docs. Triggers: "/docs-consolidate", "consolidate the docs", "docs audit", "have the docs drifted", "check the docs against each other". Do NOT use for updating one doc alongside a code change — that is the commit gate's job, and a single doc edit needs no audit.
jasonm4130/claude-skills · ★ 2 · Data & Documents · score 68
Install: claude install-skill jasonm4130/claude-skills
# Documentation consolidation An **audit**, not a rewrite. It reports; you decide; only then does anything change. Google's opendocs defines the audit archetype as inventory + analysis + recommendations, "explicitly excluding the writing or editing of docs based on those results". That separation is the point: LLM inconsistency detection is nowhere near reliable enough to edit unsupervised, and an autonomous rewrite would be confidently wrong at exactly the rate that matters. This never blocks anything. If the user is mid-task, say what you found and let them come back to it. ## `--init` Adopt the trigger in this repo. **`--init` starts the clock; it does not audit.** The `audited=` SHA it writes means "drift is measured from here", not "these docs were verified at this commit". Say that to the user when you run it, because the trigger will then stay silent for `threshold − 1` commits over docs nobody has checked. If the repo's docs are of unknown quality, offer to run a full pass immediately after adopting. 1. **Refuse if the record would be ignored.** `git check-ignore .docs-sync` matching means the file would never reach a teammate's clone — stop and say so rather than creating a record that silently does nothing. (This is what ruled out putting it under `.claude/`: transcoder gitignores that directory.) 2. Write `.docs-sync` at the repo root: ``` docs-sync: audited=<git rev-parse HEAD> Recorded: <ISO-8601 UTC> Run /docs-consolidate — do not ha