
Brand Voice Guidelines
- 67 installs
- 93 repo stars
- Updated May 14, 2026
- thatrebeccarae/claude-marketing
Helps with ai & agent building tasks.
About
brand-voice-guidelines is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.
- brand-voice-guidelines
- AI & Agent Building
- AI-coding skill
Brand Voice Guidelines by the numbers
- 67 all-time installs (skills.sh)
- +8 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #5,935 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/thatrebeccarae/claude-marketing --skill brand-voice-guidelinesAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 67 |
|---|---|
| repo stars | ★ 93 |
| Last updated | May 14, 2026 |
| Repository | thatrebeccarae/claude-marketing ↗ |
What it does
Helps with ai & agent building tasks.
Files
Brand Voice & Guidelines
Develop, document, and maintain consistent brand voice across all channels.
Install
git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/brand-voice-guidelines ~/.claude/skills/Voice vs Tone
Voice = who you are (consistent). Tone = how you adapt to context (variable).
- Voice is your brand personality — it does not change
- Tone shifts based on situation: celebration vs crisis, social vs support, blog vs legal
Voice Development Process
Step 1: Audit Existing Content
Analyze 10-20 pieces of existing content across channels:
- What adjectives describe the writing?
- What is consistent? What is inconsistent?
- How does your audience describe you?
Step 2: Define Voice Attributes
Choose 3-5 attributes that define your brand voice. Each attribute sits on a spectrum:
| Attribute | We Are | We Are NOT |
|---|---|---|
| Confident | Bold, direct, opinionated | Arrogant, dismissive, preachy |
| Approachable | Warm, conversational, human | Unprofessional, sloppy, too casual |
| Expert | Knowledgeable, precise, credible | Jargon-heavy, condescending, academic |
| Playful | Witty, creative, surprising | Silly, forced, distracting |
Step 3: Brand Personality Archetypes
| Archetype | Voice | Brands |
|---|---|---|
| The Sage | Knowledgeable, thoughtful, guiding | Google, TED, McKinsey |
| The Creator | Innovative, expressive, visionary | Apple, Adobe, Figma |
| The Hero | Bold, confident, empowering | Nike, Patagonia, Slack |
| The Jester | Playful, irreverent, entertaining | Old Spice, Mailchimp, Duolingo |
| The Caregiver | Warm, supportive, trustworthy | Dove, TOMS, Headspace |
| The Rebel | Provocative, disruptive, direct | Harley-Davidson, Basecamp, Cards Against Humanity |
| The Explorer | Adventurous, curious, independent | Airbnb, North Face, REI |
| The Ruler | Authoritative, premium, exclusive | Rolex, Mercedes, Bloomberg |
| The Everyperson | Relatable, honest, grounded | IKEA, Target, Slack |
Step 4: Create Tone Matrix
Define how voice adapts across contexts:
| Context | Confidence Level | Formality | Humor | Empathy |
|---|---|---|---|---|
| Marketing website | High | Low-medium | Light | Medium |
| Blog post | High | Low | Medium | Medium |
| Social media | Medium-high | Low | High | Medium |
| Customer support | Medium | Medium | None | Very high |
| Error messages | Low (humble) | Low | Light if appropriate | High |
| Legal/compliance | Medium | High | None | Low |
| Crisis comms | High | High | None | Very high |
| Sales emails | High | Medium | Light | High |
Step 5: Messaging Framework
## Brand Promise
[One sentence: what you promise your customers]
## Value Propositions (3-5)
1. [VP 1]: [Proof point]
2. [VP 2]: [Proof point]
3. [VP 3]: [Proof point]
## Tagline Options
- [Tagline 1]
- [Tagline 2]
- [Tagline 3]
## Elevator Pitch (30 seconds)
[2-3 sentences that explain what you do, who you serve, and why it matters]
## Boilerplate (for press/about)
[Standard paragraph used in press releases, about pages, speaker bios]Writing Style Guide
Grammar & Mechanics
| Decision | Our Standard | Why |
|---|---|---|
| Oxford comma | Yes | Clarity |
| Contractions | Yes (we are → we're) | Conversational |
| Exclamation marks | Max 1 per page | Not shouty |
| Emoji | [Platform-specific rules] | Context-dependent |
| Capitalization | Sentence case for headings | Modern, approachable |
| Numbers | Spell out 1-9, numerals 10+ | Standard convention |
| Pronouns | We (company), you (customer) | Direct and personal |
Vocabulary
| Instead Of | Use | Why |
|---|---|---|
| Utilize | Use | Simpler |
| Leverage | Use, apply | Less jargon |
| Synergy | Collaboration, combined | Real words |
| Best-in-class | Leading, top-performing | Less cliche |
| Disruptive | [describe what actually changed] | Show, do not label |
| Solution | [name the actual thing] | Be specific |
Voice Consistency Audit
Audit Checklist
- [ ] Sample 3 pages per channel (website, email, social, support)
- [ ] Score each on voice attributes (1-5 per attribute)
- [ ] Identify outliers (pages that do not sound like the brand)
- [ ] Check for forbidden vocabulary
- [ ] Verify tone matches context (support should not sound like marketing)
- [ ] Test with the "read it aloud" check — does it sound like one person?
Deliverable: Brand Voice Document
Document Structure
# [Brand] Voice Guide
## Who We Are (1 paragraph)
## Our Voice Attributes (3-5 with Do/Don't examples)
## Tone Matrix (context-specific adjustments)
## Messaging Framework (promise, VPs, tagline, elevator pitch)
## Writing Style Guide (grammar, vocabulary, formatting)
## Channel-Specific Guidelines (website, email, social, support)
## Examples (before/after rewrites for each voice attribute)Integration with Other Skills
- content-creator — Brand voice analyzer script validates consistency
- seo-content-writer — Apply voice guidelines while optimizing for SEO
- copywriting-frameworks — Use frameworks within your established voice
- social-media-strategy — Platform-specific tone adaptations
- email-composer — Maintain voice in professional communications
Brand Voice & Guidelines — Examples
Example 1: Develop Voice from Scratch
Prompt
Develop brand voice guidelines for our fintech startup. We help small businesses manage cash flow. Our audience is non-technical small business owners who are frustrated with complex financial tools.
What the skill does
1. Recommends archetype blend: Caregiver (supportive) + Sage (knowledgeable) with Everyperson (relatable) 2. Defines 4 voice attributes: Approachable (not corporate), Confident (not arrogant), Clear (not oversimplified), Empathetic (not patronizing) 3. Creates tone matrix for 6 contexts (marketing, support, onboarding, error messages, social, email) 4. Builds messaging framework: brand promise, 3 value propositions with proof points, elevator pitch, tagline options 5. Writes vocabulary guide: forbidden jargon list, preferred alternatives 6. Produces complete Brand Voice Document with before/after examples
---
Example 2: Voice Consistency Audit
Prompt
Audit our brand voice across website, email, and social. Our blog sounds casual and fun, but our product pages sound corporate. Help us fix the inconsistency.
What the skill does
1. Samples 3 pages per channel, scores on 4 voice attributes (1-5 each) 2. Identifies gap: blog averages 4.5/5 on "Approachable" but product pages average 2/5 3. Finds root cause: product pages were written by a different team using formal templates 4. Rewrites 3 product page sections to match the blog voice 5. Creates a voice checklist for the product team to self-audit future pages
---
Example 3: Tone Adaptation for Crisis
Prompt
We had a data breach. Help us write communications in our brand voice but adapted for crisis — we usually sound playful and casual.
What the skill does
1. References tone matrix: Crisis context = high confidence, high formality, zero humor, very high empathy 2. Shows how to keep brand voice (honest, direct) while shifting tone (serious, accountable) 3. Writes 3 communications: customer email, social post, press statement 4. Each maintains brand identity (still sounds like the brand) while being appropriately serious 5. Provides anti-examples: what NOT to say in a crisis with their brand voice
MIT License
Copyright (c) 2026 Rebecca Rae Barton
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Brand Voice Guidelines Reference
Reference data, benchmarks, and platform-specific details for the Brand Voice Guidelines skill.
<!-- TODO: Add platform API schemas, benchmark data, and domain-specific reference tables -->