
brand-messaging-architecture
Use when building a messaging framework, writing a value proposition, defining brand pillars or key messages, or organizing a messaging hierarchy across audiences. Keywords - messaging house, message layers, value proposition canvas, positioning template, Peep Laja, Osterwalder, Geoffrey Moore, April Dunford, StoryBrand, Andy Raskin strategic narrative, MECLABS.
- Installs
- 71
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/mike-coulbourn/claude-vibes --skill brand-messaging-architecture- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads brand-messaging-architecture automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Brand messaging architecture framework
Quick reference for developing brand messaging, value propositions, and brand pillars using established methodologies.
"A brand is not what you say it is. It's what THEY say it is." — Marty Neumeier
Key distinction: positioning vs. messaging vs. value proposition
| Element | Definition | Answers | Audience |
|---|---|---|---|
| Positioning | Strategic foundation for perception | "Why choose us?" | Internal |
| Messaging | Content and narratives communicating positioning | "What do we say?" | External |
| Value Proposition | Promise of value delivered to customers | "What do I get?" | External |
How they work together:
- Positioning determines what makes you different
- Messaging translates that into what you say
- Value Proposition explains what customers gain
The Messaging House framework
The most popular visual framework for organizing messages hierarchically:
┌─────────────────────────────────────────┐
│ THE ROOF │
│ [Core Message / Value Proposition] │
│ The single most important thing you │
│ want audiences to remember │
└─────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ PILLAR 1│ │ PILLAR 2│ │ PILLAR 3│
│ [Theme] │ │ [Theme] │ │ [Theme] │
│ WHY to │ │ WHY to │ │ WHY to │
│ believe │ │ believe │ │ believe │
└────┬────┘ └────┬────┘ └────┬────┘
│ │ │
▼ ▼ ▼
[Proof Points] [Proof Points] [Proof Points]
Evidence Evidence Evidence
│
┌────────────────┴────────────────────┐
│ THE FOUNDATION │
│ [Purpose, Vision, Values] │
│ The deeper WHY behind │
│ everything │
└─────────────────────────────────────┘
Peep Laja's Message Layers framework
Based on thousands of B2B message tests. Each layer must be addressed in order:
| Layer | Question | What to Do | Example |
|---|---|---|---|
| 1. Clarity | "What is it?" | Lead with category; simple language | "Marketing automation software" NOT "Next-gen growth enablement platform" |
| 2. Relevance | "Is it for me?" | Address specific pain points | "For marketing teams drowning in manual campaign work" |
| 3. Value | "What do I get?" | Core benefits and outcomes | "Automate 80% of repetitive tasks and launch campaigns 3x faster" |
| 4. Differentiation | "Why you over alternatives?" | What makes you uniquely better | "The only platform built specifically for Shopify merchants" |
Key insight: You must clear each layer before the next one matters. Brilliant differentiation means nothing if prospects don't first understand what you are.
Value Proposition Canvas (Osterwalder)
The most widely used framework for developing value propositions:
┌─────────────────────────────────┐ ┌─────────────────────────────────┐
│ VALUE MAP │ │ CUSTOMER PROFILE │
│ (Your Offering) │ │ (Their Reality) │
│ │ │ │
│ ┌─────────────────────────┐ │ │ ┌─────────────────────────┐ │
│ │ Products & Services │ │◄───┼───│ JOBS │ │
│ │ (What you offer) │ │ │ │ (Tasks to accomplish) │ │
│ └─────────────────────────┘ │ │ └─────────────────────────┘ │
│ │ │ │
│ ┌─────────────────────────┐ │ │ ┌─────────────────────────┐ │
│ │ Pain Relievers │ │◄───┼───│ PAINS │ │
│ │ (How you help) │ │ │ │ (Frustrations) │ │
│ └─────────────────────────┘ │ │ └─────────────────────────┘ │
│ │ │ │
│ ┌─────────────────────────┐ │ │ ┌─────────────────────────┐ │
│ │ Gain Creators │ │◄───┼───│ GAINS │ │
│ │ (How you delight) │ │ │ │ (Desired outcomes) │ │
│ └─────────────────────────┘ │ │ └─────────────────────────┘ │
└─────────────────────────────────┘ └─────────────────────────────────┘
How to use it:
- Start with Customer Profile: deeply understand jobs, pains, gains
- Map your offering to show how you address each
- Identify where pain relievers and gain creators align most strongly
- This intersection is your value proposition
Jobs-to-be-Done (Clayton Christensen)
"Customers don't buy products. They 'hire' products to do a job for them."
| Job Type | What It Is | Example Question |
|---|---|---|
| Functional Job | The core task to accomplish | "What task are they trying to get done?" |
| Social Job | How they want to be perceived | "What does using this say about them?" |
| Emotional Job | How they want to feel | "What feeling are they seeking?" |
The Drill Example:
- People don't buy a drill because they want a drill
- They hire a drill to make a hole
- They want the hole to hang a picture
- They want the picture to feel at home
- The "job" cascades from functional → emotional
Geoffrey Moore positioning statement
The most widely used positioning template (from Crossing the Chasm):
For (target customer) who (statement of need or opportunity), the (product name) is a (product category) that (statement of key benefit). Unlike (primary competitive alternative), our product (statement of primary differentiation).
Example:
For growth-stage SaaS companies who struggle to understand customer churn, ChurnPredict is a customer analytics platform that identifies at-risk accounts before they leave. Unlike generic analytics tools, ChurnPredict uses AI trained specifically on subscription business patterns to predict churn with 94% accuracy.
April Dunford's five components of positioning
- Competitive Alternatives: What would customers use if your solution didn't exist?
- Unique Attributes: What features/capabilities do you have that alternatives lack?
- Value: What benefit do those unique attributes enable?
- Target Customer Characteristics: Who cares most about that value?
- Market Category: What context makes your unique value obvious?
Her 10-step method:
- Start with your best customers (those who bought quickly)
- Identify what they'd use if you didn't exist
- List your unique attributes vs. those alternatives
- Map each attribute to the value it enables
- Identify who cares most about that value
- Determine the market category that makes your value obvious
- Optionally, layer on a relevant market trend
- Create your positioning statement
- Share with team and get buy-in
- Translate into messaging
Andy Raskin's Strategic Narrative
Traditional approach ("The Arrogant Doctor"): "You have a problem. We have the solution. Let me tell you why ours is best." This is bragging, and prospects are skeptical.
Strategic Narrative approach ("The Humble Awakener"): "The world has changed in a way that creates both great opportunity and great risk. Let me show you how to navigate this new world." This is empathy, and prospects trust empathy.
The 5 elements:
- Name a Big, Relevant Change: Something prospects sense but haven't articulated
- Show There Will Be Winners and Losers: Urgency to act
- Tease the Promised Land: What success looks like for those who adapt
- Introduce Features as "Magic Gifts": Capabilities that help reach promised land
- Name the Enemy: An old mindset that has become a road to ruin
Donald Miller's StoryBrand framework (SB7)
The customer is the hero, not your brand. Your brand is the guide (like Yoda, not Luke).
The 7-part framework:
- A Character (the customer) has...
- A Problem (villain, external, internal, philosophical)...
- And Meets a Guide (your brand)...
- Who Gives Them a Plan...
- And Calls Them to Action...
- That Helps Them Avoid Failure...
- And Ends in Success
Why it works: Story is how humans communicate. When you structure messaging with the customer as the hero, they see themselves in it.
David Aaker's three types of benefits
| Benefit Type | What It Is | Example |
|---|---|---|
| Functional Benefit | What the product does | "Cleans clothes in 30 minutes" |
| Emotional Benefit | How it makes customers feel | "Feel confident and put-together" |
| Self-Expressive Benefit | What it says about the customer | "I'm someone who values my time" |
Combined value statement: Merge all three for a complete value proposition.
The 5 Ps brand pillar framework
The most widely accepted framework uses 5 brand pillars:
| Pillar | What It Defines | Key Questions |
|---|---|---|
| Purpose | Why your brand exists beyond making money | Why did you start? What would be lost? |
| Positioning | Where you stand in the market | Who do you serve? How are you different? |
| Personality | Your brand's voice, tone, character | If your brand were a person, how would they speak? |
| Perception | How you're viewed internally and externally | What do people say about you? |
| Promotion/Product | How you market and what you deliver | What experience do you create? |
Why 3-5 pillars?: Too many pillars dilute focus. If everything is a pillar, nothing is.
Pillar-to-messaging hierarchy
Brand Pillars (Strategic Foundation)
↓
Messaging Pillars (Communication Themes)
↓
Proof Points (Evidence)
For each messaging pillar, aim for 3+ proof points combining:
- Rational evidence: Data, statistics, certifications
- Emotional evidence: Customer stories, testimonials
- Visual evidence: Photos, videos, demonstrations
MECLABS value proposition quality tests
| Criterion | Question | How to Improve |
|---|---|---|
| Appeal | Is the benefit desirable to your target customer? | Ground in real customer research |
| Exclusivity | Can only you claim this, or could competitors say the same? | Find what makes you genuinely unique |
| Clarity | Can customers understand it quickly and easily? | Simplify language, remove jargon |
| Credibility | Is there evidence to support the claim? | Add proof points, testimonials, data |
Additional tests
The "So What?" Test: After each statement, ask "so what?" If you can't explain why customers should care, revise.
The "Only" Test (Marty Neumeier):
Our [offering] is the only [category] that [benefit].
If you can complete this statement credibly, you have strong differentiation.
The Clarity Test: Can someone understand what you do within 5 seconds of reading your homepage?
Common value proposition mistakes
| Mistake | Problem | Better Approach |
|---|---|---|
| Features over benefits | Describes what it does, not what customers gain | "Spend time on leads most likely to buy" > "AI-powered lead scoring" |
| Vague language | Jargon obscures meaning | If a stranger can't understand it, simplify |
| No differentiation | Competitors can say the same thing | Find what makes you genuinely unique |
| Unsubstantiated claims | "Best-in-class" means nothing without proof | Back every claim with evidence |
| Wrong audience | Doesn't match customer needs | Research before writing |
| One-size-fits-all | Ignores segment differences | Create segment-specific propositions |
| No validation | Untested messaging often fails | Test with real customers first |
Common messaging architecture mistakes
- Skipping the Clarity layer: Differentiation means nothing if they don't understand what you are
- Too many pillars: More than 5 dilutes focus
- Inconsistency across touchpoints: Erodes trust over time
- Making the brand the hero: Customers are the heroes; you're the guide
- Not testing with real customers: Internal love doesn't mean external resonance
- Static messaging: Never updating as market and customers evolve
Testing & validation methods
| Method | Best For | Key Considerations |
|---|---|---|
| Customer Interviews | Deep qualitative insight | Aim for 10-15 minimum |
| Landing Page Tests | Message performance | A/B test different value propositions |
| A/B Testing | Controlled experiments | Test one variable at a time |
| Fake Door Tests | Gauging interest | Present entry point, measure clicks |
| Surveys | Quantitative validation | Complement with qualitative data |
| Sales Team Feedback | Real-world objections | What questions do prospects ask? |
The say-do gap warning
What people say they'll pay and what they actually pay are often very different. Test willingness to pay through behavior, not stated intent.
Key statistics
- Consistency builds trust: 75% of shoppers expect consistency from brands regardless of channel
- Revenue impact: Consistent branding across platforms can increase revenue by up to 23%
- Efficiency gain: Teams spend less time debating when there's a shared framework
Expert wisdom
| Expert | Insight |
|---|---|
| Marty Neumeier | "A brand is not what you say it is. It's what THEY say it is." |
| April Dunford | "Positioning is a fundamental precursor to messaging. You can't write your homepage until you understand the value for whom." |
| Andy Raskin | "Differentiation is based on prospects seeing you make sense of their world—your empathy—and they trust you more." |
| Simon Sinek | "People don't buy what you do, they buy why you do it." |
| Peep Laja | "If you leave it to the visitor to figure out how one company is different, you're going to lose." |
| Donald Miller | "The customer is the hero, not your brand." |
Universal principles
- Customer-first: Great messaging starts with deep customer understanding
- Clarity before cleverness: Being understood is more important than being creative
- Consistency compounds: Every touchpoint reinforcing the same message builds trust
- Differentiation is essential: If competitors can say the same thing, it's not positioning
- Prove your claims: Unsubstantiated claims erode trust; evidence builds it
- Simplify ruthlessly: Complex messaging gets ignored; simple messaging gets remembered
- Test and iterate: Messaging is a hypothesis until validated with real customers
Templates
Read reference/templates.md when producing a deliverable the user will keep, such as a filled worksheet, a documented decision, or a final write-up. Skip it for conceptual questions and quick recommendations, which this file covers. It opens with a table of contents, so load only the template needed:
- Messaging framework document template
- Value proposition canvas template
- Messaging pillar template
- Message layers assessment template
- Messaging house visual template
- Quick reference card template
When to apply this knowledge
During value proposition development
- Use Value Proposition Canvas to map customer jobs/pains/gains
- Apply Jobs-to-be-Done for deeper customer understanding
- Write Geoffrey Moore positioning statement
- Complete the "Only" Test for differentiation
During messaging architecture
- Build the Messaging House structure
- Apply Peep Laja's Message Layers in order
- Define 3-5 messaging pillars with proof points
- Create messaging hierarchy (primary → secondary → tertiary)
During validation
- Run MECLABS quality tests
- Apply "So What?" and Clarity tests
- Test with real customers before committing
- Document in accessible framework
FAQ
What does the brand-messaging-architecture skill do?
Use when building a messaging framework, writing a value proposition, defining brand pillars or key messages, or organizing a messaging hierarchy across audiences. Keywords - messaging house, message layers, value proposition canvas, positioning template, Peep Laja, Osterwalder, Geoffrey Moore, April Dunford, StoryBrand, Andy Raskin strategic narrative, MECLABS.
How do I install brand-messaging-architecture?
Run npx skills add https://github.com/mike-coulbourn/claude-vibes --skill brand-messaging-architecture in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/brand-messaging-architecture/ (personal) or .claude/skills/brand-messaging-architecture/ (project).
Which AI agents can use brand-messaging-architecture?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is brand-messaging-architecture safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains brand-messaging-architecture?
It is published by mike-coulbourn in mike-coulbourn/claude-vibes. It has 71 recorded installs.
More from mike-coulbourn/claude-vibes
conversion-psychology
mike-coulbourn/claude-vibes
Use when optimizing sponsored or affiliate video scripts to convert, diagnosing why content is not driving action, or choosing which persuasion lever fits an offer. Keywords - buyer psychology, emotional triggers, social proof, scarcity, urgency, authority, reciprocity, loss aversion, why people buy.
brand-naming-strategies
mike-coulbourn/claude-vibes
Use when naming or renaming a company, product, or startup, generating or scoring name candidates, or checking domain and trademark availability for a name. Keywords - brand name, naming strategy, SMILE and SCRATCH test, descriptive vs invented vs abstract names, sound symbolism, naming matrix, domain availability, trademark screening.
ai-writing-detection
mike-coulbourn/claude-vibes
Comprehensive AI writing detection patterns and methodology. Provides vocabulary lists, structural patterns, model-specific fingerprints, and false positive prevention guidance. Use when analyzing text for AI authorship or understanding detection patterns.
brand-color-psychology
mike-coulbourn/claude-vibes
Use when selecting or evaluating brand colors, building a palette with primary, secondary, neutral, and accent roles, differentiating from competitor colors, or checking color contrast and accessibility. Keywords - color psychology, color palette, 60-30-10 rule, color harmony, archetype colors, cultural color meaning, WCAG contrast, hex and CMYK specifications.
scriptwriting-methodology
mike-coulbourn/claude-vibes
Open the skill to read its SKILL.md instructions.
visual-identity-direction
mike-coulbourn/claude-vibes
Use when translating brand strategy into visual creative direction, such as writing a creative or logo brief, describing mood boards, or setting photography, illustration, color, and type direction for a designer. Keywords - visual identity, visual direction, creative brief, mood board, logo brief, photography style, Alina Wheeler, visual language, design direction.
Popular marketing & seo skills
reddit-automation
flowkit-labs/skills
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.
twitter-automation
101-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
magentosh/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
qu-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
product-launch-video
heygen-com/hyperframes
Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.
twitter-automation
skills-shell/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet