MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads brand-messaging-architecture automatically when relevant.

  3. 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

ElementDefinitionAnswersAudience
PositioningStrategic foundation for perception"Why choose us?"Internal
MessagingContent and narratives communicating positioning"What do we say?"External
Value PropositionPromise 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:

LayerQuestionWhat to DoExample
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:

  1. Start with Customer Profile: deeply understand jobs, pains, gains
  2. Map your offering to show how you address each
  3. Identify where pain relievers and gain creators align most strongly
  4. 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 TypeWhat It IsExample Question
Functional JobThe core task to accomplish"What task are they trying to get done?"
Social JobHow they want to be perceived"What does using this say about them?"
Emotional JobHow 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

  1. Competitive Alternatives: What would customers use if your solution didn't exist?
  2. Unique Attributes: What features/capabilities do you have that alternatives lack?
  3. Value: What benefit do those unique attributes enable?
  4. Target Customer Characteristics: Who cares most about that value?
  5. Market Category: What context makes your unique value obvious?

Her 10-step method:

  1. Start with your best customers (those who bought quickly)
  2. Identify what they'd use if you didn't exist
  3. List your unique attributes vs. those alternatives
  4. Map each attribute to the value it enables
  5. Identify who cares most about that value
  6. Determine the market category that makes your value obvious
  7. Optionally, layer on a relevant market trend
  8. Create your positioning statement
  9. Share with team and get buy-in
  10. 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:

  1. Name a Big, Relevant Change: Something prospects sense but haven't articulated
  2. Show There Will Be Winners and Losers: Urgency to act
  3. Tease the Promised Land: What success looks like for those who adapt
  4. Introduce Features as "Magic Gifts": Capabilities that help reach promised land
  5. 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:

  1. A Character (the customer) has...
  2. A Problem (villain, external, internal, philosophical)...
  3. And Meets a Guide (your brand)...
  4. Who Gives Them a Plan...
  5. And Calls Them to Action...
  6. That Helps Them Avoid Failure...
  7. 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 TypeWhat It IsExample
Functional BenefitWhat the product does"Cleans clothes in 30 minutes"
Emotional BenefitHow it makes customers feel"Feel confident and put-together"
Self-Expressive BenefitWhat 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:

PillarWhat It DefinesKey Questions
PurposeWhy your brand exists beyond making moneyWhy did you start? What would be lost?
PositioningWhere you stand in the marketWho do you serve? How are you different?
PersonalityYour brand's voice, tone, characterIf your brand were a person, how would they speak?
PerceptionHow you're viewed internally and externallyWhat do people say about you?
Promotion/ProductHow you market and what you deliverWhat 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

CriterionQuestionHow to Improve
AppealIs the benefit desirable to your target customer?Ground in real customer research
ExclusivityCan only you claim this, or could competitors say the same?Find what makes you genuinely unique
ClarityCan customers understand it quickly and easily?Simplify language, remove jargon
CredibilityIs 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

MistakeProblemBetter Approach
Features over benefitsDescribes what it does, not what customers gain"Spend time on leads most likely to buy" > "AI-powered lead scoring"
Vague languageJargon obscures meaningIf a stranger can't understand it, simplify
No differentiationCompetitors can say the same thingFind what makes you genuinely unique
Unsubstantiated claims"Best-in-class" means nothing without proofBack every claim with evidence
Wrong audienceDoesn't match customer needsResearch before writing
One-size-fits-allIgnores segment differencesCreate segment-specific propositions
No validationUntested messaging often failsTest with real customers first

Common messaging architecture mistakes

  1. Skipping the Clarity layer: Differentiation means nothing if they don't understand what you are
  2. Too many pillars: More than 5 dilutes focus
  3. Inconsistency across touchpoints: Erodes trust over time
  4. Making the brand the hero: Customers are the heroes; you're the guide
  5. Not testing with real customers: Internal love doesn't mean external resonance
  6. Static messaging: Never updating as market and customers evolve

Testing & validation methods

MethodBest ForKey Considerations
Customer InterviewsDeep qualitative insightAim for 10-15 minimum
Landing Page TestsMessage performanceA/B test different value propositions
A/B TestingControlled experimentsTest one variable at a time
Fake Door TestsGauging interestPresent entry point, measure clicks
SurveysQuantitative validationComplement with qualitative data
Sales Team FeedbackReal-world objectionsWhat 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

ExpertInsight
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

  1. Customer-first: Great messaging starts with deep customer understanding
  2. Clarity before cleverness: Being understood is more important than being creative
  3. Consistency compounds: Every touchpoint reinforcing the same message builds trust
  4. Differentiation is essential: If competitors can say the same thing, it's not positioning
  5. Prove your claims: Unsubstantiated claims erode trust; evidence builds it
  6. Simplify ruthlessly: Complex messaging gets ignored; simple messaging gets remembered
  7. 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

View all →

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.

Marketing & SEO516 installs

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.

Marketing & SEO389 installs

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.

Docs & Writing354 installs

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.

Marketing & SEO303 installs

scriptwriting-methodology

mike-coulbourn/claude-vibes

Open the skill to read its SKILL.md instructions.

238 installs

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.

Media & Creative162 installs

Popular marketing & seo skills

View category →

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.

Marketing & SEO1.1M installs

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

Marketing & SEO880K installs

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

Marketing & SEO771.7K installs

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

Marketing & SEO564.3K installs

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.

Marketing & SEO538.7K installs

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

Marketing & SEO453.7K installs