$npx -y skills add zubair-trabzada/ai-marketing-claude --skill market-brandPrimary Sources (must analyze): 1. Homepage -- The most curated representation of the brand 2. About page -- How the brand describes itself 3. Product/service pages -- How they present their offerings
| 1 | # Brand Voice Analysis and Guidelines Generation |
| 2 | |
| 3 | ## Skill Purpose |
| 4 | Analyze a brand's voice, tone, and messaging across all available channels and generate a comprehensive brand voice guidelines document. This skill examines how a brand communicates, identifies patterns and inconsistencies, and produces actionable guidelines that any writer or marketer can follow to maintain brand consistency. |
| 5 | |
| 6 | ## When to Use |
| 7 | - User wants to understand or document a brand's voice |
| 8 | - User needs brand voice guidelines for a team, freelancers, or agency |
| 9 | - User wants to ensure consistency across marketing channels |
| 10 | - User is rebranding or refining their brand identity |
| 11 | - User wants to compare their brand voice to competitors |
| 12 | - Triggered by `/market brand <url>` or `/market brand` |
| 13 | |
| 14 | ## How to Execute |
| 15 | |
| 16 | ### Step 1: Gather Source Material |
| 17 | To analyze a brand's voice, examine content from multiple sources. Prioritize in this order: |
| 18 | |
| 19 | **Primary Sources (must analyze):** |
| 20 | 1. **Homepage** -- The most curated representation of the brand |
| 21 | 2. **About page** -- How the brand describes itself |
| 22 | 3. **Product/service pages** -- How they present their offerings |
| 23 | |
| 24 | **Secondary Sources (analyze if available):** |
| 25 | 4. **Blog posts** (at least 3-5 recent posts) |
| 26 | 5. **Social media profiles** (bio, recent posts, engagement style) |
| 27 | 6. **Email newsletters** (welcome email, recent sends) |
| 28 | 7. **Customer-facing copy** (error messages, onboarding flows, help docs) |
| 29 | |
| 30 | **Tertiary Sources:** |
| 31 | 8. **Job postings** -- Reveals internal culture and values |
| 32 | 9. **Press releases** -- Formal communication style |
| 33 | 10. **Ad copy** -- Paid messaging approach |
| 34 | 11. **Video scripts or podcast transcripts** -- Spoken brand voice |
| 35 | |
| 36 | Use browser tools or the analyze_page.py script to access web content. For social media, check the website for social links and analyze the linked profiles. |
| 37 | |
| 38 | ### Step 2: Voice Dimension Analysis |
| 39 | Map the brand's voice along four primary dimensions. Each dimension is a spectrum, not a binary. |
| 40 | |
| 41 | #### Dimension 1: Formal <-----> Casual |
| 42 | Where does the brand fall on the formality spectrum? |
| 43 | |
| 44 | | Signal | Formal | Casual | |
| 45 | |---|---|---| |
| 46 | | Contractions | Avoids them ("do not", "cannot") | Uses them freely ("don't", "can't") | |
| 47 | | Sentence structure | Complex, longer sentences | Short, punchy sentences | |
| 48 | | Vocabulary | Professional, industry-standard | Conversational, everyday words | |
| 49 | | Greetings | "Dear valued customer" | "Hey there!" | |
| 50 | | Pronouns | Third person ("the company", "one") | First/second person ("we", "you") | |
| 51 | | Humor | Rare or absent | Frequent, natural | |
| 52 | | Slang/colloquialisms | Never | Occasionally or frequently | |
| 53 | |
| 54 | **Score: 1 (extremely formal) to 10 (extremely casual)** |
| 55 | |
| 56 | **Evidence required:** Quote 3-5 specific examples from the source material that support your rating. |
| 57 | |
| 58 | #### Dimension 2: Serious <-----> Playful |
| 59 | How much levity does the brand inject into its communication? |
| 60 | |
| 61 | | Signal | Serious | Playful | |
| 62 | |---|---|---| |
| 63 | | Tone | Authoritative, measured | Light-hearted, fun | |
| 64 | | Metaphors | Rare, conservative | Creative, unexpected | |
| 65 | | Exclamation marks | Rare | Frequent | |
| 66 | | Emoji use | Never | Sometimes or often | |
| 67 | | Wordplay/puns | Never | Enjoys them | |
| 68 | | Error messages | "An error has occurred" | "Oops! Something went sideways" | |
| 69 | | Self-deprecation | Never | Occasionally | |
| 70 | |
| 71 | **Score: 1 (extremely serious) to 10 (extremely playful)** |
| 72 | |
| 73 | #### Dimension 3: Technical <-----> Simple |
| 74 | How much domain expertise does the brand assume in its audience? |
| 75 | |
| 76 | | Signal | Technical | Simple | |
| 77 | |---|---|---| |
| 78 | | Jargon | Uses industry terms freely | Avoids or explains all jargon | |
| 79 | | Acronyms | Uses without definition | Spells out on first use | |
| 80 | | Detail level | In-depth explanations | High-level overviews | |
| 81 | | Audience assumption | Expert audience | General audience | |
| 82 | | Data/statistics | Frequent, detailed | Occasional, simplified | |
| 83 | | Examples | Complex, domain-specific | Simple, relatable analogies | |
| 84 | |
| 85 | **Score: 1 (extremely technical) to 10 (extremely simple)** |
| 86 | |
| 87 | #### Dimension 4: Reserved <-----> Bold |
| 88 | How much personality and confidence does the brand project? |
| 89 | |
| 90 | | Signal | Reserved | Bold | |
| 91 | |---|---|---| |
| 92 | | Claims | Hedged ("we believe", "may help") | Direct ("we guarantee", "the best") | |
| 93 | | Opinions | Neutral, balanced | Strong, opinionated | |
| 94 | | Competitive references | Avoids mentioning competitors | Directly compares | |
| 95 | | Personality | Professional, understated | Distinctive, memorable | |
| 96 | | Promises | Conservative | Ambitious | |
| 97 | | Controversy | Avoids | Embraces when aligned with values | |
| 98 | |
| 99 | **Score: 1 (extremely reserved) to 10 (extremely bold)** |
| 100 | |
| 101 | ### Step 3: Tone Spectrum Mapping |
| 102 | |
| 103 | Beyond the four dimensions, map how the brand's tone shifts across different contexts: |
| 104 | |
| 105 | | Context | Typical Tone | Example | |
| 106 | |---|---|---| |
| 107 | | Homepage | [Confident/Welcoming/Urgent/etc.] | "[quote from homepage]" | |
| 108 | | Product description | [Informative/Persuasive/Technical/etc.] | "[quote]" | |
| 109 | | Blog post | [Educational/Conversational/Authoritative/etc.] | "[quote]" | |
| 110 | | Social media | [Casual/Engaging/Promotional/etc.] | "[quote] |