docs-reviewlisted
Install: claude install-skill jamie8johnson/cqs
# Docs Review
Check all project documentation for staleness and fix what's drifted.
## Process
1. **Scope the review**:
- Run `git log vLAST_TAG..HEAD --stat` to see what changed since last release
- Focus on docs affected by those changes
- If no tag exists, review everything
2. **Check each item**:
| File | What to check |
|------|---------------|
| `src/lib.rs` doc comment | Language count, feature list, API examples compile, Quick Start accuracy |
| `Cargo.toml` | `description` (crates.io one-liner), `keywords`, `categories` |
| `README.md` | Hardcoded versions (schema, install), feature list, usage examples, badge URLs |
| `CONTRIBUTING.md` | Architecture Overview matches current file layout — any files added/moved/renamed? |
| `SECURITY.md` | Threat model current, dependency notes, any new attack surfaces? |
| `PRIVACY.md` | Data handling claims still accurate? |
| `CLAUDE.md` | Quick Reference (version, schema, test count, language count) |
| GitHub repo | Description and topics — `gh repo view`, update with `gh repo edit` if needed |
3. **Fix and report**:
- Fix stale docs directly
- Report what was updated and what was already current
- If unsure about a claim, flag it rather than guessing
## When to run
- Before releases (`/release` references this)
- After significant feature PRs
- Before audits
- When you suspect drift
## Rules
- Don't rewrite docs for style — only fix factual staleness
- Don't add content