mcpField
B
brand-voice-guidelines

brand-voice-guidelines

github.com/thatrebeccaraeMarketing & growth187112 installsUpdated 24w ago
Repository

About brand-voice-guidelines

brand-voice-guidelines helps teams define, document, and maintain a consistent brand voice across channels. It turns brand attributes into practical guidance through tone matrices, messaging frameworks, and writing rules.

Key features

  1. 01Audit existing content
  2. 02Define brand voice attributes
  3. 03Set context-specific tone matrices
  4. 04Create messaging and writing rules
  5. 05Check consistency across channels

Use cases

  1. 01Develop a brand voice guide
  2. 02Adapt tone for marketing and support
  3. 03Review content against brand standards

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/thatrebeccarae/claude-marketing --skill brand-voice-guidelines

After installing, type/brand-voice-guidelinesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

EXAMPLES.md
LICENSE
REFERENCE.md

Details

From the project README

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:

AttributeWe AreWe Are NOT
ConfidentBold, direct, opinionatedArrogant, dismissive, preachy
ApproachableWarm, conversational, humanUnprofessional, sloppy, too casual
ExpertKnowledgeable, precise, credibleJargon-heavy, condescending, academic
PlayfulWitty, creative, surprisingSilly, forced, distracting
Step 3: Brand Personality Archetypes
ArchetypeVoiceBrands
The SageKnowledgeable, thoughtful, guidingGoogle, TED, McKinsey
The CreatorInnovative, expressive, visionaryApple, Adobe, Figma
The HeroBold, confident, empoweringNike, Patagonia, Slack
The JesterPlayful, irreverent, entertainingOld Spice, Mailchimp, Duolingo
The CaregiverWarm, supportive, trustworthyDove, TOMS, Headspace
The RebelProvocative, disruptive, directHarley-Davidson, Basecamp, Cards Against Humanity
The ExplorerAdventurous, curious, independentAirbnb, North Face, REI
The RulerAuthoritative, premium, exclusiveRolex, Mercedes, Bloomberg
The EverypersonRelatable, honest, groundedIKEA, Target, Slack
Step 4: Create Tone Matrix

Define how voice adapts across contexts:

ContextConfidence LevelFormalityHumorEmpathy
Marketing websiteHighLow-mediumLightMedium
Blog postHighLowMediumMedium
Social mediaMedium-highLowHighMedium
Customer supportMediumMediumNoneVery high
Error messagesLow (humble)LowLight if appropriateHigh
Legal/complianceMediumHighNoneLow
Crisis commsHighHighNoneVery high
Sales emailsHighMediumLightHigh
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
DecisionOur StandardWhy
Oxford commaYesClarity
ContractionsYes (we are → we're)Conversational
Exclamation marksMax 1 per pageNot shouty
Emoji[Platform-specific rules]Context-dependent
CapitalizationSentence case for headingsModern, approachable
NumbersSpell out 1-9, numerals 10+Standard convention
PronounsWe (company), you (customer)Direct and personal
Vocabulary
Instead OfUseWhy
UtilizeUseSimpler
LeverageUse, applyLess jargon
SynergyCollaboration, combinedReal words
Best-in-classLeading, top-performingLess 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

Comments

Markdown supported