brand-voice
Define or extract a consistent brand voice that other skills can use. Three modes: Extract (analyze existing content), Build (interview-based), Auto-Scrape (from URL). Use when copy sounds generic, when starting any new project, when voice feels inconsistent across channels, when onboarding a new brand, or when any skill needs voice-profile.md but it doesn't exist yet. This is always the first skill to run for a new project. Make sure to use this skill whenever the user mentions tone of voice, brand personality, 'my copy all sounds the same', 'how should I sound', 'analyze my website voice', 'define my tone', or anything about making content sound more human or distinctive. Even if the user just says 'my marketing sounds generic' — that's a voice problem.
MoizIbnYousaf · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add MoizIbnYousaf/marketing-cli --skill brand-voiceAbout this skill
name: brand-voice description: "Define or extract a consistent brand voice that other skills can use. Three modes: Extract (analyze existing content), Build (interview-based), Auto-Scrape (from URL). Use when copy sounds generic, when starting any new project, when voice feels inconsistent across channels, when onboarding a new brand, or when any skill needs voice-profile.md but it doesn't exist yet. This is always the first skill to run for a new project. Make sure to use this skill whenever the user mentions tone of voice, brand personality, 'my copy all sounds the same', 'how should I sound', 'analyze my website voice', 'define my tone', or anything about making content sound more human or distinctive. Even if the user just says 'my marketing sounds generic' — that's a voice problem." category: foundation tier: must-have reads:
- brand/voice-profile.md
- brand/positioning.md
- brand/audience.md writes:
- brand/voice-profile.md
- brand/learnings.md triggers:
- what's my voice
- analyze my brand
- define my voice
- make this sound like me
- voice guide
- brand personality
- analyze my website
- brand voice
/brand-voice -- Brand Voice Engine
Generic copy converts worse than copy with a distinct voice. Not because the words are different -- because the reader feels like they're hearing from a PERSON, not a marketing team.
This skill defines that voice. Either by extracting it from existing content, building it strategically from scratch, or auto-scraping a URL to analyze a brand's public presence.
For output formatting, see /cmo rules/output-format.md.
On Activation
- Read
brand/context:- positioning.md — If available, use market angles to inform voice differentiation. A brand positioned as "the anti-course course" needs a different voice than one positioned as "enterprise-grade."
- audience.md — If available, tailor vocabulary and tone to the target reader. Technical builders get different language than busy executives.
- If neither exists, proceed with defaults. Ask the user about their market and audience during the question sequence.
- Check if
./brand/voice-profile.mdalready exists:- Exists → Update mode: show current profile summary, ask what to change.
- Does not exist → Proceed to Mode Selection below.
- Assess the user's request to determine which mode to use (Extract, Build, or Auto-Scrape).
Three Modes
Mode 1: Extract (analyze existing content)
User provides 3-5 pieces of existing content (blog posts, emails, social posts, about page, etc).
The analysis process:
- Read all provided content -- look for patterns, not individual word choices
- Identify the voice DNA:
- Sentence structure (short/punchy vs. flowing/complex)
- Vocabulary level (everyday vs. technical vs. academic)
- Emotional register (warm/friendly vs. authoritative vs. irreverent)
- Perspective (first-person storytelling vs. objective analysis)
- Rhythm (varies sentence length? staccato? musical?)
- Map the personality axes (see Voice DNA Framework below)
- Generate the voice profile
- Write to ./brand/voice-profile.md
Mode 2: Build (construct from scratch)
No existing content. Build voice strategically through guided questions.
The question sequence:
- "If your brand were a person at a dinner party, how would they talk?"
- "Who is your audience? Technical builders, creative professionals, busy executives, everyday consumers, or a mix?"
- "Name 2-3 brands whose tone you admire (not their product -- their VOICE)."
- "What words should NEVER appear in your marketing? What feels off-brand?"
- "Show me something you've written that felt 'right' -- even a Slack message or email."
Mode 3: Auto-Scrape (URL analysis)
User provides a URL. Skill uses Exa MCP to research the brand's public presence.
- Use Exa MCP to search for the brand's website content, social profiles, and public-facing copy
- Analyze homepage, about page, social bios, recent posts
- Extract voice patterns using the same DNA framework as Mode 1
- Present findings and ask user to confirm/adjust
- Generate voice profile
Mode Selection
Not sure which mode? Here's the decision tree:
- Have 3+ pieces of existing content (blog posts, emails, landing pages) → Mode 1: Extract
- Starting fresh with no content → Mode 2: Build via interview
- Have a live website URL → Mode 3: Auto-Scrape
If the brand has both a website AND existing content, prefer Mode 1 (Extract) — it captures the voice the brand already uses, which is more authentic than what a URL scan reveals.
Voice DNA Framework
Every voice maps across these axes:
Personality Spectrum
Rate each 1-10 with brief justification:
- Formal / Casual
- Reserved / Expressive
- Serious / Playful
- Traditional / Progressive
- Complex / Simple
- Cautious / Bold
Voice Markers
Sentence patterns: Average length, variation, structure (simple/compound/fragmented)
Vocabulary: Jargon level (none/light/technical), power words, forbidden words
Perspective: Person (I/we/you), distance (intimate/conversational/professional), authority (peer/mentor/expert/challenger)
The Do/Don't Table
Minimum 5 rows, maximum 10. Specific voice behaviors and example phrases.
Platform Adaptation Table
| Platform | Tone Shift | Length | Special Notes |
|---|---|---|---|
| More professional, authority-forward | Medium | Lead with insight | |
| Twitter/X | Punchier, more direct | Short | Fragment sentences OK |
| Warmer, more visual language | Short-Medium | Casual, aspirational | |
| Most personal, conversational | Medium-Long | First-person storytelling | |
| Blog/SEO | Most detailed, structured | Long | Can be more technical |
| TikTok | Most casual, spoken-word feel | Very short | Conversational, raw |
| Threads | Thoughtful, |