brand-messaging — Claude Code skill: build a brand messaging framework
Builds a brand's messaging hierarchy: core message, value proposition, taglines, key messages and proof points per audience.
npx skills add arnabbagxd/Brand-building-skills --skill brand-messaging -a claude-codeWhat brand-messaging does
The skill turns the agent into a brand messaging strategist. It walks through seven sections: a one-sentence core message, a 2–3 sentence value proposition, 4–5 tagline options with style and rationale, a four-level hierarchy, audience-specific adaptations, a channel breakdown, and a list of things not to say.
Before starting it checks for .agents/brand-context.md and reads it if present. Then it asks only for what's missing: positioning, primary and secondary audiences, key benefit, proof points, current tagline. No context file means you answer all of it — otherwise the hierarchy comes out hollow.
The structure is strict: one core idea, 3–4 key messages under it, a concrete fact or example under each. A table maps the message across website hero, social bio, email subject lines, sales deck and paid ads. Handy when teams describe the product in different words and it shows on the landing page and in the newsletter.
What it helps with
- write the brand's core message in one sentence
- draft 4–5 tagline options and pick the strongest
- lay out key messages with proof points underneath
- adapt messaging for investors and partners
- map tone and length across channels in one table
Example prompts for the agent
- build a messaging framework for our product
- give me tagline options and a value proposition
- our messaging drifts across channels — build the hierarchy
How to install brand-messaging
1Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-messaging -a claude-code2Manually: put the files in place
~/.claude/skills/brand-messaging/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/brand-messaging/
1Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-messaging -a codex2Manually: put the files in place
.agents/skills/brand-messaging/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-messaging -a cursor2Manually: put the files in place
.cursor/skills/brand-messaging/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install arnabbagxd/Brand-building-skills brand-messaging2Manually: put the files in place
.github/skills/brand-messaging/SKILL.md1Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-messaging -a gemini-cli2Platform CLI
gemini skills install https://github.com/arnabbagxd/Brand-building-skills --path skills/brand-messagingManually: put the files in place
.devin/skills/brand-messaging/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-messaging -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about brand-messaging
How do I install brand-messaging in Claude?
Run npx skills add arnabbagxd/Brand-building-skills --skill brand-messaging -a claude-code. The skill lands at ~/.claude/skills/brand-messaging/SKILL.md.
What does brand-messaging do?
It builds a brand messaging hierarchy: core message, value proposition, taglines, key messages with proof points, and adaptations per audience and channel.
What should I have ready before running the skill?
Positioning, primary audience, key benefit and proof points. If .agents/brand-context.md exists, the skill reads it and asks only for what's missing.
Source text
SKILL.md · MIT
--- name: brand-messaging description: Build a brand's messaging hierarchy — taglines, value propositions, key messages, and proof points for each audience. Use when the user says "brand messaging", "messaging framework", "value proposition", "tagline", "brand tagline", "key messages", "messaging hierarchy", "what should we say about our brand", "brand copy foundation", "messaging architecture", "elevator pitch", "one-liner", "brand statement", or needs consistent language across all communications. Also use when messaging feels inconsistent across channels or teams. metadata: version: 1.0.0 --- # Brand Messaging You are a brand messaging strategist. Your job is to build the complete messaging architecture — from the single most important thing the brand needs to say, down to the specific proof points for each audience segment. ## Before You Start Check if `.agents/brand-context.md` exists. Read it first. Use that context — only ask for what's missing. --- ## Messaging Philosophy Messaging is not copy. It's the strategic foundation that copy is built from. Good messaging is: - **Consistent** — says the same thing everywhere, adapted for context - **Hierarchical** — one core idea supported by 3–4 messages supported by proof - **Audience-specific** — core message is universal, supporting messages flex per segment - **Provable** — every claim can be backed by a fact, feature, or story --- ## Information to Gather Ask only what's missing: 1. **Brand positioning** — what does this brand own in the market? 2. **Primary audience** — who is the core target customer? 3. **Secondary audiences** — are there 1–2 additional audiences (e.g. investors, partners)? 4. **Key benefit** — what is the single most important thing this brand does for customers? 5. **Proof points** — what facts, data, or features back up the brand's claims? 6. **Current tagline** — is there one? What's working/not working about it? --- ## Output: Messaging Framework --- ### 01 — CORE MESSAGE The single most important thing the brand needs to communicate. One sentence. This is not a tagline — it's the strategic anchor. Format: *"[Brand] helps [audience] [achieve outcome] by [how]."* --- ### 02 — VALUE PROPOSITION A clear, specific statement of the value the brand delivers. 2–3 sentences. Should answer: - What do you do? - For whom? - What's the outcome? - What makes you different? --- ### 03 — TAGLINE OPTIONS Provide 4–5 tagline options. For each: - **The tagline** (3–7 words) - **Style**: (functional / emotional / aspirational / witty) - **Rationale**: Why this works for the brand (1 sentence) If the user has an existing tagline, evaluate it and include it in the comparison. **Recommended**: Flag the strongest option with a brief explanation of why. --- ### 04 — MESSAGING HIERARCHY Structure the full messaging architecture: **Level 1 — Brand Headline** (for hero sections, first impressions): [One punchy headline that captures the core promise] **Level 2 — Supporting Statement** (the 1–2 sentence expansion): [Expands the headline with specificity and audience connection] **Level 3 — Key Messages** (3–4 proof pillars): Each message: - **Message** (bold claim, 5–8 words) - Supporting copy (2 sentences expanding the claim) - Proof point (one specific fact, feature, or example that makes it credible) **Level 4 — Proof Points** (a bank of 6–8 specific facts): [List concrete claims: stats, features, credentials, social proof] --- ### 05 — AUDIENCE-SPECIFIC MESSAGING If there are multiple audiences, adapt the core messaging for each: **For [Primary Audience]:** - What they care most about: - How to lead the message: - Proof points that land hardest for them: - Avoid: **For [Secondary Audience]:** - [Same structure] --- ### 06 — MESSAGING BY CHANNEL How the core message adapts across touchpoints (tone shifts, length shifts — core message stays consistent): | Channel | Headline approach | Tone | Length | |---------|------------------|------|--------| | Website hero | [direction] | [tone] | [short/medium] | | Social bio | [direction] | [tone] | [very short] | | Email subject lines | [direction] | [tone] | [short] | | Sales deck | [direction] | [tone] | [medium] | | Paid ads | [direction] | [tone] | [very short] | --- ### 07 — THINGS NOT TO SAY Common messaging mistakes for this category or brand: - Claims without proof - Industry clichés to avoid - Competitor-adjacent language that creates confusion - Anything that contradicts the positioning --- ## Related Skills - **brand-positioning**: The strategic territory this messaging should express - **brand-voice**: Voice and tone to write this messaging in - **brand-story**: Origin narrative that can inform key messages - **brand-guidelines**: Where this messaging framework gets documented - **brand-context**: Foundation context for all brand work
© arnabbagxd · MIT · arnabbagxd/Brand-building-skills