Skip to content

BrianRWagner/ai-marketing-claude-code-skills / brand-voice-extractor

brand-voice-extractor

Verified

Extract or build a distinct brand voice profile that AI agents can use to produce on-brand content every time. Two modes: Extract (analyze content you're proud of) or Build (construct a voice from scratch). Outputs a complete voice profile with personality traits, tone spectrum, vocabulary guide, rhythm patterns, and example phrases. Use this before any content creation skill for consistent, human-sounding output.

FileKindSize
README.mdmarkdown2.8 KB
SKILL.mdskill md11.7 KB
references/examples.mdmarkdown7.6 KB
sample-output.mdmarkdown5.4 KB
scripts/analyze-voice.mjsscript6.6 KB

references/examples.md

View on GitHub
# Brand Voice Extractor β€” Illustrative Before/After Examples

> Composite examples for illustration, not client data.

## Example 1: B2B SaaS Founder (From Generic to Distinctive)

### Sample Input (3 Pieces of Content)
1. **Homepage copy:** "Our platform helps teams collaborate more effectively"
2. **Blog post:** "5 Tips for Remote Team Productivity"
3. **Email to customers:** "Here's why you should upgrade your plan"

### Analysis Result
**Voice Traits Identified:**
- Formal (70% formal language)
- Passive tone (uses "teams" instead of "you")
- No personality markers
- Reads like every other SaaS website

### Diagnosis
The voice is **invisible.** No reader would remember the tone or feel they know the founder.

### Extraction & Rebuild
New guidelines built from intent (not from existing generic content):
- **Personality:** Skeptical, irreverent, smart
- **Tone:** Direct (uses "you" and "I" frequently)
- **Vocabulary:** No jargon. "Build" not "leverage." "Money" not "revenue optimization."
- **Rhythm:** Short sentences. Exclamation marks when genuinely excited. Questions to engage readers.
- **Phrases to use:** "Here's the thing...", "Don't do X, do Y instead", "That's broken and here's why"
- **Phrases to avoid:** "best-in-class", "synergies", "we're committed to excellence"

### After Voice Profile Applied
**Same topic, new voice:**
"You don't need better collaboration tools. You need fewer meetings. Here's what we actually did to cut meetings by 60% and ship 2x faster. (And yeah, it's counterintuitive.)"

### Result
- Blog traffic: 2x increase (readers connected with perspective, not generic tips)
- Email open rates: 34% β†’ 51% (voice felt like real person, not marketing)
- Brand recall: "That's the skeptical founder who actually gives a damn" (vs anonymous SaaS)

---

## Example 2: Luxury Brand CEO (From Stiff to Warm)

### Sample Input (3 Pieces of Content)
1. **About page:** Biography-style, third-person
2. **Instagram captions:** Professional product descriptions
3. **Email newsletter:** Corporate announcements

### Analysis Result
**Voice Traits:**
- Formal, third-person perspective
- No personality
- No apparent opinions
- Reads like a PR machine

### Diagnosis
The voice is **distanced.** Customers don't feel connected to the founder.

### Voice Profile Built
- **Personality:** Approachable, opinionated, warm
- **Tone:** First-person. Conversational while maintaining sophistication.
- **Vocabulary:** No corporate-speak. Simple, elegant. "Beautiful" not "luxury aesthetic."
- **Rhythm:** Longer, flowing sentences mixed with short punchy ones.
- **Phrases to use:** "I noticed...", "Here's why I chose...", "Let me be honest"
- **Phrases to avoid:** "We're thrilled to announce", "State-of-the-art", "Sophisticated clientele"

### Before/After Comparison
**Before:** "The collection features meticulously curated artisanal materials sourced from heritage suppliers."

**After:** "I spent 6 months finding the right stone. Why? Because I'm obsessive about materials. You'll feel the difference when you touch it."

### Result
- Newsletter engagement: 22% β†’ 41%
- DM inquiries: Increased (people felt they could actually reach the founder)
- Brand positioning: Shifted from "luxury brand" to "founder with taste + integrity"

---

## Example 3: Tech CEO (From Trying to Be Funny to Authentically Witty)

### Sample Input (3 Pieces of Content)
1. **Twitter feed:** Attempts at humor, misses mostly
2. **Blog posts:** Technical but dry
3. **Recorded video intro:** Scripted, wooden

### Analysis Result
**Voice Traits:**
- Forced humor (puns, jokes that don't land)
- Shifts between formal and casual inconsistently
- Trying to be relatable but landing as inauthentic
- Zero personality consistency

### Diagnosis
The voice is **trying too hard.** Audience sees through it.

### Voice Profile Built
- **Personality:** Smart, dry, observant (not "jokey")
- **Tone:** Honest about problems. Willing to admit what's hard.
- **Vocabulary:** Technical depth where it matters; simple English everywhere else
- **Rhythm:** Varying lengths. Occasional longer explanation followed by sharp, short take.
- **Phrases to use:** "This is harder than it looks", "Nobody talks about X but it's the real bottleneck", "Here's what actually happened"
- **Phrases to avoid:** "LOL", forced punchlines, "haha get it?"

### Before/After Comparison
**Before:** "Our new API is so fast it makes light speed jealous πŸ˜‚"

**After:** "Our API is 40% faster than last quarter. Here's what we actually optimized (and what we couldn't)."

### Result
- Audience trust: Increased (honest about tradeoffs, not overselling)
- Engagement quality: Followers discuss the technical points, not the humor
- Speaking invitations: Increased (organizers saw competence, not forced personality)

---

## Voice Profile Template (What the Output Looks Like)

```markdown
# Voice Profile: [Name/Brand]

## Summary
Direct, skeptical, and helpful. Like a founder who's been through 3 startups and isn't afraid to tell you what doesn't work.

## Core Traits
- **Opinionated:** Will take stands on how things should be done
- **Helpful:** Shares learnings freely, no gatekeeping
- **Irreverent:** Questions industry norms without being contrarian for clicks
- **Honest:** Admits failures and hard problems

## Tone Spectrum

| Dimension | Range |
|-----------|-------|
| Formal ← β†’ Casual | 30% formal / 70% conversational |
| Reserved ← β†’ Enthusiastic | 40% reserved / 60% enthusiastic (when earned) |
| Dense ← β†’ Simple | 25% technical depth / 75% accessible |
| Detached ← β†’ Personal | 10% corporate / 90% personal perspective |
| Safe ← β†’ Provocative | 20% conventional / 80% challenges status quo |

## Vocabulary Guide

### Words to Use
- "Here's the thing..."
- "Actually..."
- "This is harder than it looks"
- "What nobody talks about is..."
- "That's broken and here's why"

### Words/Phrases to Kill
- "Synergies", "leverage", "best-in-class"
- "We're thrilled to announce"
- "Sophisticated"
- Forced humor, puns, LOLs
- Third-person perspective

## Rhythm & Structure
- **Sentence variation:** Mix short (3-5 words) with longer (20+ word) explanations
- **Paragraph length:** 2-3 sentences usually; occasional longer dive
- **Opening moves:** Questions, observations, "here's the thing"
- **Closing moves:** Call to action or thought to sit with (not always both)

## Example Phrases
- Opening: "I've noticed [observation]..."
- Transition: "But here's what actually works..."
- Honest: "I was wrong about [thing]..."
- Evidence: "We measured this and [specific data]..."

## Do's and Don'ts

### βœ… Do This
- Name specific problems and solutions
- Use first-person ("I", "we")
- Admit what's hard or unsolved
- Share data and examples
- Ask rhetorical questions

### ❌ Don't Do This
- Use corporate jargon
- Hide behind "the team"
- Oversell or overpromise
- Make jokes that don't land
- Pretend certainty when it's messy

---

This profile is ready for:
- **Content teams** to reference when writing
- **AI writing assistants** to ingest as a constraint
- **Ghostwriters** to nail the tone before drafting
- **Company handbook** for keeping voice consistent at scale
```

---

## Key Insight: Authenticity Beats Perfection

The best voice profiles don't create a persona. They **clarify the authentic voice that's already there**β€”and remove the noise that's obscuring it.

- Founder #1: Already skeptical; we just gave permission to be skeptical in public
- Founder #2: Already warm; we just shifted from third-person corporate to first-person connection
- CEO #3: Already smart; we just replaced forced humor with authentic observation

**The extraction isn't about becoming someone else. It's about being unmistakably yourself.**
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β€” repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β€” or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β€” your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall