BrianRWagner/ai-marketing-claude-code-skills / brand-voice-extractor
brand-voice-extractor
VerifiedExtract 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.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 2.8 KB |
| SKILL.md | skill md | 11.7 KB |
| references/examples.md | markdown | 7.6 KB |
| sample-output.md | markdown | 5.4 KB |
| scripts/analyze-voice.mjs | script | 6.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.**
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |