| name | brand-voice-code |
| description | Audit and fix Markdown files for brand-voice quality in the Claude Code class (developer audience): em dashes, Mermaid label syntax, paragraph length, and topic-specific slash command tables. Trigger phrases: brand voice check, quality check, check writing quality, fix em dashes. |
| license | MIT |
| tools | ["Read","Edit","Glob","Grep"] |
Brand Voice Quality Check
Enforce the writing and formatting rules documented in references/rules.md against one or more Markdown files in this repository. This is the Claude Code class brand-voice skill and it stays repo-local; the audience differs from a Cowork class, so brand voice is never installed globally. The create-class master skill discovers and invokes it by globbing .claude/skills/brand-voice-*.
Inputs
The user will name a file, a folder, or a module (e.g. demos/02-harness). If no target is given, ask for one before proceeding.
Steps
-
Read references/rules.md to load the current ruleset.
-
Resolve the target to a list of readme.md files using Glob. Skip pptx/ subdirectories.
-
For each file, run every rule in the ruleset:
- Read the file.
- Check for each violation type in order: em dashes, Mermaid labels, paragraph length, slash command tables.
- Collect all violations before editing.
-
For each file that has violations:
- Apply all fixes in a single Edit per file where possible.
- Report what was changed and why.
-
After all files are processed, print a one-line summary: files checked, files changed, violation types found.
Rule Application
Read references/rules.md for the precise definitions. Apply rules literally — do not invent new style preferences beyond what is documented there.
When fixing slash command tables, consult the "Topic-specific slash commands" section in references/rules.md. Match the module topic to its approved command set. If a module topic is not listed, keep the existing commands and flag it in the summary instead of guessing.
Output Format
For each changed file, output:
FILE: demos/02-harness/03-hooks/readme.md
[em-dash] line 3 — fixed
[mermaid] line 29 — \n replaced with <br/>
[paragraph] line 84 — split after sentence 4
End with:
SUMMARY: 5 files checked, 3 changed — em-dash (7), paragraph (2), mermaid (2)
