Skip to main content
skill CX Codex

brand-voice · rampstackco — Claude Code skill: what it does, how to install

Builds a complete brand voice and tone guide with personality traits, contextual shifts, vocabulary rules, and before-and-after copy pairs.

MIT 367 installs ★ 1,107 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rampstackco/claude-skills --skill brand-voice -a claude-code
Open on GitHub

What brand-voice does

The skill documents a company's written identity across four structured tiers. It defines core traits using contrast pairings such as "confident, not arrogant", maps how tone shifts across situations like 404 pages or support queues, establishes grammar standards, and compiles a library of 15 to 25 paired examples.

To generate the guide, the agent expects brand positioning, target audience details, 5 to 10 existing copy samples, and 3 to 5 reference brands. Checking individual drafts against an established voice is outside this skill's scope; auditing pre-publish copy belongs to editorial-qa.

What it helps with

  • document a voice and tone system for writers and AI assistants
  • map contextual tone shifts from marketing headlines to error states
  • build a library of paired good and bad copy examples
  • set clear vocabulary preferences alongside grammar defaults

Example prompts for the agent

  • Build a voice and tone document using our brand brief and these 5 copy samples
  • Map our tone shifts across onboarding, 404 pages, and cancellation flows
  • Define our core voice attributes with failure-mode guardrails

How to install brand-voice

1Skills CLI (Vercel)

npx skills add rampstackco/claude-skills --skill brand-voice -a claude-code

2Manually: put the files in place

~/.claude/skills/brand-voice/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/brand-voice/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about brand-voice

How to install brand-voice in Claude Code?

Run npx skills add rampstackco/claude-skills --skill brand-voice -a claude-code. Alternatively, place the file in ~/.claude/skills/brand-voice/SKILL.md.

What does brand-voice do?

It structures brand voice into core attributes, contextual tone shifts, vocabulary constraints, and paired good-versus-bad writing examples.

How does brand-voice differ from editorial-qa?

This skill establishes and documents the voice system itself. Routine verification of drafts against an existing voice guide is handled by editorial-qa.

Source text

SKILL.md · MIT
---
name: brand-voice
description: "Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples. Use this skill whenever the user wants to define how a brand sounds, write a voice and tone document, audit existing copy for voice consistency, train a team or AI assistant on brand voice, or refine the personality of brand writing. Triggers on brand voice, voice and tone, tone of voice, writing voice, brand personality, copy voice, voice document, voice guidelines, how should we write, voice training, voice audit. Also triggers when the user has copy that 'feels off' and the underlying issue is voice, even if not stated explicitly. On a voice consistency check, this skill owns defining and documenting the voice system; use `editorial-qa` when a specific draft needs checking against an existing system before it publishes."
category: brand
catalog_summary: "Voice attributes, tone shifts, vocabulary, paired-example library"
display_order: 4
---

# Brand Voice

Define how a brand sounds in writing. Document it in a way that anyone (writer, designer, founder, AI assistant) can apply it consistently.

This skill produces a standalone voice document that can either live in the brand style guide or feed into it.

---

## When to use

- Defining brand voice for the first time
- Auditing existing copy for voice consistency
- Training a team, freelancer, or AI assistant on the brand voice
- Refining a voice that exists but is inconsistent across applications
- Adapting voice when a brand evolves (new audience, new positioning)

## When NOT to use

- Writing specific copy (use `content-and-copy`)
- Brand visual identity work (use `brand-identity`)
- Documenting a complete brand system (use `brand-style-guide`, which incorporates voice)
- Initial brand exploration (use `brand-ideation`)

---

## Required inputs

- The brand and its positioning
- The audience and what they need to hear
- 5 to 10 examples of existing brand writing (if any)
- 3 to 5 reference brands whose voice resonates with where this brand should go
- Any voice attributes already specified in the brief

---

## The framework: 4 layers

Voice has four layers, stacked. Each layer constrains the one below it.

### Layer 1: Voice attributes

The constants. The personality traits that define how the brand sounds across every context.

Pick 3 to 5 attributes. Pair each with what it is NOT (the failure mode if overdone).

Common attribute pairings (NOT a menu - generate your own):

- Confident, not arrogant
- Direct, not blunt
- Warm, not saccharine
- Witty, not sarcastic
- Smart, not academic
- Honest, not harsh
- Playful, not silly
- Practical, not boring
- Bold, not loud
- Curious, not unfocused

The "not" half is what saves writers from overshooting. "Confident" alone produces swagger. "Confident, not arrogant" tells writers where the line is.

### Layer 2: Tone shifts

Voice is constant. Tone adapts to context.

Map the major contexts the brand writes in. For each, document how voice expresses differently.

Common contexts:

| Context | Tone shift |
|---|---|
| Onboarding | Warmer, more enthusiastic, slightly slower pace |
| Hero / marketing | Confident, signature voice fully on |
| Product copy / UX | Direct, helpful, brief |
| Error messages | Calm, matter-of-fact, no apology theater |
| Success states | Brief celebration, redirect to next action |
| Empty states | Helpful, slightly playful, suggest action |
| 404 / not found | Self-aware, light, points the way home |
| Account deletion / cancellation | Quiet, respectful, no jokes |
| Pricing | Direct, transparent, confidence-inspiring |
| Legal / TOS | Plain language version sits next to the legal version |
| Support / help center | Patient, thorough, no condescension |
| Crisis communication | Calm, factual, accountable |
| Product announcements | Excited but not breathless |
| Email subject lines | Specific, never click-bait |

Voice stays consistent across all of these. Tone is what shifts.

### Layer 3: Vocabulary and grammar

The granular dial settings.

**Vocabulary preferences:**

- Words and phrases the brand uses
- Words and phrases the brand avoids
- Words the brand has redefined (if any) - e.g., a SaaS product calling its features "huddles" instead of "meetings"
- Industry jargon: keep it (signals expertise) or strip it (signals approachability)
- Sentence-opening preferences (some brands lean on imperatives, some on questions, some on statements)

**Grammar and style:**

- Contractions (use them = casual, avoid them = formal)
- Sentence length default (short = punchy, medium = considered, long = literary)
- Punctuation marks favored or avoided (em dash is famously polarizing)
- Pronouns ("we" / "you" / "I")
- Capitalization style (title case, sentence case, all-lowercase deliberate)
- Number formatting (spell out under ten, or always digits)
- Oxford comma (use or skip)
- Active vs passive voice (most brands prefer active)

### Layer 4: Examples and patterns

Voice is taught through examples, not rules. Build a library.

For each major content type, show:

- Bad example (off-voice)
- Good example (on-voice)
- Brief note on what changed

Cover the content types listed in the paired examples library of [`references/voice-document-template.md`](references/voice-document-template.md). The template owns that list, so there is one list to maintain rather than two that drift apart.

The floor is 15 paired examples. One pair per type in the template clears it. Past 25 the library gets harder to scan than to use, so treat 25 as the practical ceiling, not a hard cap. This is the most-used part of the voice doc in practice.

---

## Workflow

1. **Pick the entry point.** [`references/voice-frameworks.md`](references/voice-frameworks.md) has a "Choosing a framework" section that decides this. A brand starting from zero begins with archetypes there, then dimensions, then attributes, and rejoins this workflow at step 2. Everything below assumes copy exists to audit.
2. **Audit existing copy** if it exists. Identify what is on-brand, what is off, what patterns recur.
3. **Layer 1: Voice attributes.** Generate 5 to 8 candidates with "we are X, not Y" framing. Pick 3 to 5.
4. **Layer 2: Tone shifts.** List 8 to 15 contexts the brand writes in. Note the tone shift for each.
5. **Layer 3: Vocabulary and grammar.** Define preferences. Skip default rules unless they actually distinguish the brand.
6. **Layer 4: Examples.** Build the paired-example library against the template's content-type list, to the floor stated in the Layer 4 section above.
7. **Stress-test.** Pick a fresh writing brief and apply the voice doc. Score the result with the stress test in [`references/voice-frameworks.md`](references/voice-frameworks.md): 1 to 5 against each attribute, and anything scoring below 3 on any attribute is off-voice. Below 3 means the doc is incomplete, not that the copy needs another pass.
8. **Document.** Use the template in [`references/voice-document-template.md`](references/voice-document-template.md).
9. **Distribute.** Voice docs only work if they get used. Make the doc easy to reference inline (link to it from CMS templates, brief templates, AI assistant prompts).

---

## Failure patterns

- **Generic attributes ("friendly, professional, approachable").** Every brand says this. Means nothing. Pick attributes that genuinely distinguish.
- **No "we are NOT" pairings.** Without the rejection, attributes drift toward extremes.
- **Voice doc with no examples.** Rules without examples cannot be applied.
- **Examples that are obviously bad and obviously good.** Real voice work shows nuanced shifts, not cartoonish before/after.
- **Skipping tone shifts.** Treating voice as one-size-fits-all leads to a brand that sounds wrong in error states or legal contexts.
- **Documenting aspirational voice.** If the brand does not actually sound this way today and has no plan to shift, the doc is fiction.
- **Voice without distribution.** A perfect doc that no one references is worth nothing.

---

## Output format

Default output is a markdown document at `voice.md` in the brand folder. Sections:

1. Voice attributes (with we-are-not pairings)
2. Tone shifts by context
3. Vocabulary preferences
4. Grammar and style rules
5. Paired examples library (the most-used section)
6. Anti-patterns (specific phrases or constructions to avoid)
7. References (the brands and writers we are inspired by)

This doc can stand alone or feed into `brand-style-guide`.

---

## Reference files

- [`references/voice-document-template.md`](references/voice-document-template.md) - Fillable template.
- [`references/voice-frameworks.md`](references/voice-frameworks.md) - Detailed walkthrough of the Nielsen Norman 4 dimensions, Jung archetypes, and the "we are X not Y" approach.

© rampstackco · MIT · rampstackco/claude-skills

Similar skills

All skills for Marketing and content →

brand-voice by other authors comes first.

brand-voice affaan-m brand-voice extracts an author's writing style from real publications and turns it into a reusable profile for drafts and outreach. Useful when you need consistent tone without typical AI cliches. CX Codex +1 6,800installs brand-voice arnabbagxd Generates a brand voice guide with tone dimensions, vocabulary lists, and channel rules. Helpful when onboarding writers or standardizing copy. CX Codex +1 2,200installs brand-voice luongnv89 The skill checks text against brand voice rules: tone, vocabulary, phrasing patterns. Useful for marketing, docs and customer comms. CX Codex +1 ★ 47,494repo stars brand-voice luongnv89 brand-voice — a skill that holds marketing copy, customer emails and public pages to one tone of voice. Handy when several people write for the same brand. CX Codex +1 ★ 47,494repo stars brand-voice James Dickerson (@boringmarketer) brand-voice is a Claude Code skill that extracts or builds a brand voice profile from real content. It can also audit recent posts against a saved profile. CX Codex +1 ★ 778repo stars copywriting-tone-of-voice-creator samber copywriting-tone-of-voice-creator generates a structured TONE.md brand voice guide or adapts an existing one to new channels. Built for content pipelines and agent-driven writing. CX Codex +1 5,800installs Brand Guidelines Generator claude-office-skills Brand Guidelines Generator generates brand style guides, typography rules, and color palettes. Helpful when you need to document visual identity and communication standards. CX Codex +1 4,900installs brand-voice-enforcement official anthropics The brand-voice-enforcement skill automatically applies your brand guidelines to any content: emails, posts, proposals. It loads your rules, adapts tone to the audience, and explains how each brand choice works. CX Codex +1 3,900installs brand-review official anthropics brand-review — a skill that reviews marketing copy, copywriting, and content against your brand guide, voice, and messaging standards. Flags deviations by severity and suggests concrete fixes. CX Codex +1 3,400installs brand-messaging arnabbagxd A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that builds a full brand messaging architecture — core message, value proposition, tagline options, and proof points per audience segment. CX Codex +1 2,000installs brand-voice-analyzer OneWave-AI brand-voice-analyzer extracts tone, vocabulary, and structure from company copy to build a style guide and audit drafts against it. CX Codex +1 281installs

From the same set102

The whole set →
brand-ideation brand-ideation — a skill for the early brand phase: it generates positioning territories, name candidates, mood directions and narratives, then helps you converge on one. CX Codex +1 388installs seo-aeo-geo seo-aeo-geo — a skill for tuning content and site structure for AI search: citations in model answers, llms.txt, extraction-friendly markup. CX Codex +1 381installs email-deliverability A skill for email deliverability: sets up SPF, DKIM and DMARC, tracks sender reputation, and helps you work out why messages land in spam. CX Codex +1 372installs design-system Builds or audits a design system: tokens, component library, naming conventions, contribution model and docs. Useful when products drift apart visually. CX Codex +1 369installs brand-discovery brand-discovery is a Claude Code skill that researches audiences, competitors, and category dynamics before a brand or website project. It helps explore positioning options before a creative brief. CX Codex +1 366installs accessibility-audit accessibility-audit audits web interfaces against WCAG 2.1 AA standards and builds a prioritized remediation plan. Helps prepare sites for ADA, Section 508, or routine health checks. CX Codex +1 364installs information-architecture The information-architecture skill plans website or product structure: sitemaps, navigation, URLs, content types, and taxonomies. Use it for new IA work or a restructure. CX Codex +1 354installs creative-brief creative-brief turns a vague idea into a concrete brief that a designer or developer can pick up and run with. Use it to lock down scope, audience, and success metrics before the first line of code. CX Codex +1 354installs

Project sponsors

Companies that keep this analytics open