| name | voice-and-tone |
| description | Use when establishing or applying brand voice — defining voice attributes, tone adaptation across contexts, vocabulary lists, writing examples, and ensuring consistent personality across the interface |
Voice and Tone
Voice is who you are. Tone is how you say it right now. Voice stays constant. Tone adapts to context. This skill defines both so every word sounds like the same person wrote it.
When to Use
- At the start of a project, during or after
design-strategy
- When the content-writer agent needs voice guardrails
- When interface copy sounds inconsistent across screens
Step 1: Define Voice Attributes
Choose 3-5. For each, define "this, not that":
| Attribute | This | Not that |
|---|
| Warm | Friendly, approachable | Sycophantic, emoji-heavy |
| Knowledgeable | Confident, precise | Academic, condescending |
| Direct | Clear, action-oriented | Blunt, cold, robotic |
| Encouraging | Celebrates effort | Patronising, fake-cheerful |
The "not that" column prevents drift.
Step 2: Define Tone by Context
| Context | Feel | Example |
|---|
| Success | Celebration, warmth | "Your monstera is happy. Next water Thursday." |
| Error | Calm, helpful, no blame | "We couldn't save that. Check your connection and try again." |
| Onboarding | Welcoming, confidence-building | "Let's get to know your plants. About 30 seconds." |
| Empty state | Inviting, action-oriented | "Your windowsill is empty. Add your first plant." |
| Loading | Reassuring, brief | "Checking your plants..." |
| Destructive | Clear, calm, reversible | "Remove this plant? You can undo this." |
Step 3: Build the Vocabulary
| Always use | Never use |
|---|
| water | irrigate |
| happy | optimal |
| check it out | investigate |
| you | the user |
The content-writer agent uses this as a constraint.
Step 4: Set Reading Level
| Audience | Target |
|---|
| General consumer | Grade 6-8 |
| Professional tool | Grade 8-10 |
| Technical docs | Grade 10-12 |
Voice Audit Checklist
What You Deliver
- Voice attributes table (3-5, with "this not that")
- Tone guide by context with examples
- Vocabulary list
- Reading level target
- 3-5 before/after examples
Integration
- Informed by:
design-strategy, design-discovery
- Feeds into:
content-writer agent, accessible-content, design-critic
