Install
openclaw skills install brand-voice-guideDefine and document a consistent brand voice with tone guidelines, vocabulary lists, do/don't examples, and channel-specific adaptations so every touchpoint sounds unmistakably like the brand — whether written by founders, freelancers, or AI.
openclaw skills install brand-voice-guideThis skill produces a concrete, example-driven brand voice document that any writer — internal, freelance, or AI — can follow to match the brand's sound on the first try, without needing brand-team sign-off for every sentence. It covers voice attributes, tone spectrum, vocabulary rules, do/don't examples across channels, and a self-audit checklist.
| Decision | Strong | Acceptable | Weak |
|---|---|---|---|
| Voice attributes | 3-4 defined with spectrum scales, each with do/don't examples | 3-4 attributes listed with brief descriptions | Vague terms like "professional" with no examples |
| Vocabulary list | 50+ terms with approved/banned alternatives and context notes | 20-30 approved/banned terms | No vocabulary guidance or just a few random words |
| Tone spectrum | 5+ scenarios mapped on a casual-to-formal scale with examples | General guidance on when to be formal vs. casual | Single tone for all contexts |
| Channel adaptation | Separate guidelines per channel (email, social, ads, CX, product) with examples | General channel notes without examples | One voice doc applied identically everywhere |
| Do/don't examples | 10+ paired examples per channel showing exact rewrites | 5-10 generic do/don't pairs | Abstract rules with no concrete examples |
| Audience awareness | Voice adjusted by segment (new vs. loyal, B2B vs. B2C) | Single audience definition | No audience consideration |
| Testing method | Before/after audit of real brand copy with scoring rubric | Informal review by brand team | No validation process |
| AI prompt integration | Voice attributes formatted as system prompt instructions | General AI usage notes | No AI guidance |
Collect and analyze the brand's current voice across channels:
Deliverable: Voice audit summary with ranked copy samples and pattern analysis.
Establish 3-4 core voice attributes that define the brand's personality:
Structure for each attribute:
Attribute selection principles:
Deliverable: Voice attribute cards with spectrum scales, definitions, and example pairs.
Create approved and banned word lists organized by category:
Categories to cover:
Format for each entry:
Deliverable: Vocabulary reference with 50+ entries across all categories.
Define how voice tone shifts across different contexts while maintaining the same underlying personality:
| Context | Tone Shift | Example |
|---|---|---|
| Product launch announcement | Peak excitement, confident | |
| Error message / outage notification | Calm, direct, empathetic | |
| Customer complaint response | Warm, accountable, solution-focused | |
| Sales email | Enthusiastic but not pushy | |
| Legal / compliance | Clear, formal, still human | |
| Social media comment reply | Casual, quick, personality-forward | |
| Onboarding sequence | Encouraging, helpful, patient | |
| Win-back / re-engagement | Personal, low-pressure, value-focused |
For each context, provide a before (wrong tone) and after (right tone) rewrite of a realistic example.
Deliverable: Tone spectrum matrix with scenario-specific guidelines and example rewrites.
Create detailed voice adaptations for each brand channel:
For each channel, document:
Channels to cover:
Deliverable: Channel guideline cards with examples, templates, and formatting rules.
Translate voice attributes into structured instructions for AI writing tools:
Deliverable: AI prompt template library with system prompts and few-shot examples.
Create a scoring system to evaluate whether content matches brand voice:
Deliverable: Voice scoring rubric with minimum thresholds and self-audit checklist.
Input: "We're a wellness brand selling supplements and self-care products DTC. Our founder writes all the copy and it sounds great, but we're hiring two freelancers and need to hand off the voice. We want to sound like a knowledgeable friend, not a clinical brand."
Voice attributes defined:
Vocabulary excerpt:
| Approved | Banned | Context |
|---|---|---|
| "ritual" | "routine" | Elevates daily habits |
| "your body" | "the body" | Personal, not clinical |
| "ingredients you recognize" | "clean ingredients" | Specific over buzzwords |
| "community" | "customers" | Relationship over transaction |
Tone spectrum applied:
Input: "We sell project management software to mid-market teams. Our voice has drifted — marketing sounds like a startup, sales decks sound corporate, and support sounds robotic. We need one voice that works across all three."
Voice attributes defined:
AI prompt template created:
You are writing as [Brand]. Follow these voice rules:
- Be direct: lead with the answer, then explain. No throat-clearing.
- Be specific: use numbers, timeframes, and concrete outcomes.
- Sound human: use contractions, occasional dry humor, and conversational tone.
- Never use: leverage, synergy, best-in-class, cutting-edge, seamless.
- Always use: you/your (not "users"), we (not "the platform").
- Sentence length: average 12-18 words. Max 25.
Choosing aspirational over accurate attributes — Picking voice attributes the brand wants to have rather than ones that match its current best copy. Start from what already works and refine, don't invent a new personality.
Too many voice attributes — More than 4 attributes dilute focus. Writers can't hold 7 attributes in mind while writing a tweet. Choose 3-4 that matter most and let the rest emerge naturally.
Generic do/don't examples — Writing abstract examples like "Be friendly, not formal" instead of showing actual sentences. Every rule needs a before/after pair using realistic brand copy.
Ignoring channel differences — A voice guide that treats Instagram captions and legal disclaimers the same way. The underlying personality stays constant, but tone and format must adapt to channel norms.
No vocabulary enforcement — Defining voice attributes without a word list. Writers will interpret "confident" differently; a vocabulary list makes it concrete and auditable.
Forgetting AI writers — Modern voice guides must include prompt-ready instructions, since a growing percentage of first drafts come from AI tools that need explicit voice constraints.
One-time document, never updated — Voice guides that get created during a rebrand and never touched again. Schedule quarterly reviews as the brand, audience, and channels evolve.
No scoring rubric — Without a way to measure voice compliance, feedback becomes subjective ("this doesn't feel right") rather than actionable ("this scores 2/5 on directness — here's why").
Skipping the audit step — Jumping straight to defining attributes without analyzing what the brand already sounds like. The audit reveals the voice that customers already recognize.
Making the guide too long to use — A 50-page brand bible that nobody reads. The best voice guides have a 1-page quick reference that writers pin to their wall, backed by deeper reference docs they consult when needed.