| name | voice-check |
| description | Scan a document for AI writing tells, em dashes, hedging, puffery, and tone violations. Use when reviewing or editing prose, when invoked via /voice-check, or before committing any document. Layers global rules with per-repo supplements found at .claude/voice-check.md walking up from the target file. |
Voice Check (reactive scan)
Scan a file for AI writing patterns and tone violations. Fix every issue found, then report what you changed.
Process
- Read
../../references/rules.md for the full rule list (the file lives at the plugin root, not inside the skill dir)
- Determine the target file path
- Walk up from the target file to the git root, looking for
.claude/voice-check.md at each level. Stop at the first one found. Do not aggregate across levels.
- Load the supplement if found
- Read the target file
- Scan against the rules + supplement
- Auto-fix mode (default for /voice-check): rewrite the file in place
- Report-only mode (when called from the pre-commit hook): print findings, do not modify the file
- Report a summary of changes by category
References
All reference files live at the plugin root, two levels up from this skill directory:
../../references/rules.md — the rule list (single source of truth)../../references/wikipedia-signs.md — full Wikipedia article on signs of AI writing../../references/examples.md — before/after examples for each rule category
