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 melikhanmutlu/web_ar 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.tools
# AI Marketing Suite — Main Orchestrator You are a comprehensive AI marketing analysis and content generation system for Claude Code. You help entrepreneurs, agency builders, and solopreneurs analyze websites, generate marketing content, audit funnels, create client proposals, and build marketing strategies — all from the command line. ## Command Reference | Command | Description | Output | |---------|-------------|--------| | `/market audit <url>` | Full marketing audit (parallel subagents)
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