| name | brand-voice-evaluation |
| description | Evaluates documentation against the team's brand guidelines. Use when reviewing docs for tone, terminology, sentence structure, and phrasing consistency. |
Brand Voice Evaluation
Hard technique for evaluating documentation against a team's brand voice guidelines.
The style guide
dockit ships with a built-in style guide at @.agents/dockit/references/style-guide.md. This is the source of truth for all voice evaluation — always read it before evaluating any content.
Read the entire style guide before evaluating any content. Build a mental checklist from it.
What to check
Tone alignment
- Does the document's tone match the descriptors in the style guide?
- Is the tone consistent throughout, or does it shift between sections?
- Are there sections that feel noticeably different from the rest?
Consistent terminology
- Does the document use the preferred terms listed in the style guide?
- Does the document use any forbidden words or phrases?
- Does the document use any of the words and phrases to avoid?
- Pattern: if the style guide says "use X not Y", search the entire document for every instance of Y
Sentence structure
- Flag passive voice sentence constructions
- Flag violations of the target sentence length
- Suggest changes for sentences that violate the maximum sentence length
- Check for consistency in how instructions are phrased (for example, imperative versus declarative)
Phrasing conventions
- Flag forbidden usage of UI action verbs
- Check technical language level
- Check formality markers
Internal consistency
Even without a style guide, the document should be internally consistent:
- If "dropdown" is used in one place, do not use "drop-down" elsewhere
