skills/market-brand/SKILL.md
# Brand Voice Analysis and Guidelines Generation ## Skill Purpose 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. ## When to Use - User wants to understand or document a brand's voice - User needs brand voice guidelin
npx skillsauth add zubair-trabzada/ai-marketing-claude skills/market-brandInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
/market brand <url> or /market brandTo analyze a brand's voice, examine content from multiple sources. Prioritize in this order:
Primary Sources (must analyze):
Secondary Sources (analyze if available): 4. Blog posts (at least 3-5 recent posts) 5. Social media profiles (bio, recent posts, engagement style) 6. Email newsletters (welcome email, recent sends) 7. Customer-facing copy (error messages, onboarding flows, help docs)
Tertiary Sources: 8. Job postings -- Reveals internal culture and values 9. Press releases -- Formal communication style 10. Ad copy -- Paid messaging approach 11. Video scripts or podcast transcripts -- Spoken brand voice
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.
Map the brand's voice along four primary dimensions. Each dimension is a spectrum, not a binary.
Where does the brand fall on the formality spectrum?
| Signal | Formal | Casual | |---|---|---| | Contractions | Avoids them ("do not", "cannot") | Uses them freely ("don't", "can't") | | Sentence structure | Complex, longer sentences | Short, punchy sentences | | Vocabulary | Professional, industry-standard | Conversational, everyday words | | Greetings | "Dear valued customer" | "Hey there!" | | Pronouns | Third person ("the company", "one") | First/second person ("we", "you") | | Humor | Rare or absent | Frequent, natural | | Slang/colloquialisms | Never | Occasionally or frequently |
Score: 1 (extremely formal) to 10 (extremely casual)
Evidence required: Quote 3-5 specific examples from the source material that support your rating.
How much levity does the brand inject into its communication?
| Signal | Serious | Playful | |---|---|---| | Tone | Authoritative, measured | Light-hearted, fun | | Metaphors | Rare, conservative | Creative, unexpected | | Exclamation marks | Rare | Frequent | | Emoji use | Never | Sometimes or often | | Wordplay/puns | Never | Enjoys them | | Error messages | "An error has occurred" | "Oops! Something went sideways" | | Self-deprecation | Never | Occasionally |
Score: 1 (extremely serious) to 10 (extremely playful)
How much domain expertise does the brand assume in its audience?
| Signal | Technical | Simple | |---|---|---| | Jargon | Uses industry terms freely | Avoids or explains all jargon | | Acronyms | Uses without definition | Spells out on first use | | Detail level | In-depth explanations | High-level overviews | | Audience assumption | Expert audience | General audience | | Data/statistics | Frequent, detailed | Occasional, simplified | | Examples | Complex, domain-specific | Simple, relatable analogies |
Score: 1 (extremely technical) to 10 (extremely simple)
How much personality and confidence does the brand project?
| Signal | Reserved | Bold | |---|---|---| | Claims | Hedged ("we believe", "may help") | Direct ("we guarantee", "the best") | | Opinions | Neutral, balanced | Strong, opinionated | | Competitive references | Avoids mentioning competitors | Directly compares | | Personality | Professional, understated | Distinctive, memorable | | Promises | Conservative | Ambitious | | Controversy | Avoids | Embraces when aligned with values |
Score: 1 (extremely reserved) to 10 (extremely bold)
Beyond the four dimensions, map how the brand's tone shifts across different contexts:
| Context | Typical Tone | Example | |---|---|---| | Homepage | [Confident/Welcoming/Urgent/etc.] | "[quote from homepage]" | | Product description | [Informative/Persuasive/Technical/etc.] | "[quote]" | | Blog post | [Educational/Conversational/Authoritative/etc.] | "[quote]" | | Social media | [Casual/Engaging/Promotional/etc.] | "[quote]" | | Error/404 page | [Apologetic/Humorous/Helpful/etc.] | "[quote]" | | Email subject lines | [Direct/Curious/Urgent/etc.] | "[quote]" | | CTA buttons | [Action-oriented/Benefit-driven/Urgent/etc.] | "[quote]" | | Customer support | [Empathetic/Professional/Friendly/etc.] | "[quote]" |
Map the brand to one of five core personality archetypes (brands may blend 1-2):
1. The Authority
2. The Innovator
3. The Friend
4. The Rebel
5. The Guide
Assessment:
Identify patterns in the brand's word choices:
Analyze all source material and identify the 15-20 most characteristic words or phrases. Organize by category:
Action words: (verbs they favor)
Descriptive words: (adjectives they use)
Value words: (words that reflect their values)
Industry-specific terms:
Identify words that are notably absent or that would feel out of character:
Does the brand have any recurring phrases, taglines, or linguistic patterns?
Compare the brand's voice to 2-3 key competitors:
Voice Comparison Matrix: | Dimension | [Brand] | Competitor 1 | Competitor 2 | Competitor 3 | |---|---|---|---|---| | Formal <> Casual | X/10 | X/10 | X/10 | X/10 | | Serious <> Playful | X/10 | X/10 | X/10 | X/10 | | Technical <> Simple | X/10 | X/10 | X/10 | X/10 | | Reserved <> Bold | X/10 | X/10 | X/10 | X/10 | | Primary Archetype | [type] | [type] | [type] | [type] |
Differentiation Assessment:
Assess voice consistency across all analyzed channels:
| Channel | Voice Consistency | Notes | |---|---|---| | Homepage | Consistent/Mostly/Inconsistent | [specific observations] | | About page | Consistent/Mostly/Inconsistent | [notes] | | Blog | Consistent/Mostly/Inconsistent | [notes] | | Social media | Consistent/Mostly/Inconsistent | [notes] | | Email | Consistent/Mostly/Inconsistent | [notes] | | Product pages | Consistent/Mostly/Inconsistent | [notes] |
Common Consistency Issues:
Overall Consistency Score: X/10
Document the brand's messaging from most distilled to most expanded:
The most compressed form of the brand message.
3-5 core value propositions that support the brand promise.
A conversational explanation of what the brand does and why it matters. "[Draft elevator pitch based on analyzed content]"
The standard "about us" paragraph used in press releases, email signatures, and speaker bios. "[Draft boilerplate based on analyzed content]"
The complete narrative of who the brand is, what they stand for, and why they exist.
Create the comprehensive Do's and Don'ts guide:
OUR VOICE IS: OUR VOICE IS NOT:
--------------------------------------------------
[Characteristic 1] [Anti-characteristic 1]
e.g., "Confident" e.g., "Arrogant"
[Characteristic 2] [Anti-characteristic 2]
e.g., "Helpful" e.g., "Condescending"
[Characteristic 3] [Anti-characteristic 3]
e.g., "Clear" e.g., "Dumbed down"
[Characteristic 4] [Anti-characteristic 4]
e.g., "Bold" e.g., "Aggressive"
DO:
DON'T:
Provide 5-8 sample copy pieces written in the identified brand voice so the team has concrete examples to reference:
1. Homepage Headline: "[Sample headline in the brand voice]"
2. Product Description Paragraph: "[Sample product description in the brand voice]"
3. Blog Post Opening: "[Sample blog intro in the brand voice]"
4. Social Media Post: "[Sample social post in the brand voice]"
5. Email Subject Line: "[Sample subject line in the brand voice]"
6. CTA Button Text: "[Sample CTA text in the brand voice]"
7. Error Message: "[Sample error message in the brand voice]"
8. Customer Thank You Message: "[Sample thank you message in the brand voice]"
Generate a file called BRAND-VOICE.md with:
# Brand Voice Guidelines
## [Brand Name]
### Analysis Date: [Date]
---
## Voice Summary
[2-3 sentence summary of the brand voice, personality, and key characteristics]
---
## Voice Dimensions
### Formal <-----> Casual: [X/10]
[Evidence and explanation]
### Serious <-----> Playful: [X/10]
[Evidence and explanation]
### Technical <-----> Simple: [X/10]
[Evidence and explanation]
### Reserved <-----> Bold: [X/10]
[Evidence and explanation]
### Visual Voice Map
Formal Casual |----[X]----------------------------------| Serious Playful |--------[X]------------------------------| Technical Simple |------------------[X]--------------------| Reserved Bold |------------[X]--------------------------|
---
## Brand Personality
- Primary Archetype: [Archetype]
- Secondary Archetype: [Archetype]
- [Explanation and evidence]
---
## Tone by Context
| Context | Tone | Example |
|---|---|---|
| [context] | [tone] | "[example]" |
---
## Vocabulary
### Words We Use
[Organized word lists]
### Words We Avoid
[Words that don't fit the brand]
### Signature Phrases
[Recurring patterns and phrases]
---
## Voice Chart
| Our Voice IS | Our Voice IS NOT |
|---|---|
| [trait] | [anti-trait] |
---
## Writing Guidelines
### Do's
- [specific guidelines]
### Don'ts
- [specific anti-patterns]
---
## Brand Messaging Hierarchy
### Tagline
[tagline]
### Value Propositions
1. [value prop]
### Elevator Pitch
[pitch]
### Boilerplate
[boilerplate]
---
## Copy Samples
[8 examples of copy in the brand voice]
---
## Competitor Voice Comparison
[Comparison matrix and differentiation analysis]
---
## Consistency Audit
[Channel-by-channel assessment]
- Overall Consistency Score: [X/10]
---
## Recommendations
### Immediate Actions
1. [recommendation]
### Voice Evolution Opportunities
1. [recommendation]
### Consistency Improvements
1. [recommendation]
/market competitors previously, use that data for the competitor voice comparison section.testing
# Social Media Content Calendar & Generation You are the social media engine for `/market social <topic/url>`. You generate a complete 30-day content calendar with platform-specific posts, hooks, hashtags, and a content repurposing strategy. Every post is ready to publish or hand to a social media manager. ## When This Skill Is Invoked The user runs `/market social <topic/url>`. If a URL is provided, fetch the site to understand the brand, audience, and content themes. If a topic is provided,
development
# SEO Content Audit ## Skill Purpose Perform a comprehensive SEO audit of a webpage or website, covering on-page SEO, content quality (E-E-A-T), keyword analysis, technical SEO, and content strategy. This skill combines automated analysis via `scripts/analyze_page.py` with expert-level manual review to produce an actionable SEO audit document. ## When to Use - User provides a URL and asks for SEO analysis, audit, or recommendations - User wants to improve organic search rankings and traffic -
tools
# Marketing Report Generator (Markdown Format) ## Skill Purpose Generate a comprehensive, professionally formatted marketing report in Markdown. This skill compiles data from all previous audit and analysis results into a single, client-ready document with scores, findings, recommendations, and a prioritized action plan with revenue impact estimates. ## When to Use - User wants a full marketing report for a client or their own business - User has completed one or more audit skills and wants a
development
# PDF Marketing Report Generator ## Skill Purpose Generate a professional, visually polished PDF marketing report using the Python script `scripts/generate_pdf_report.py`. This skill collects all available audit and analysis data, structures it into the expected JSON format, invokes the script, and produces a branded PDF with score gauges, bar charts, comparison tables, findings, and a prioritized action plan. ## When to Use - User wants a PDF version of the marketing report (not just Markdown