brand-messaging-architecture
Provides brand messaging architecture, value proposition, and brand pillar development frameworks including Peep Laja's Message Layers, Osterwalder's Value Proposition Canvas, Geoffrey Moore positioning template, April Dunford's Five Components, StoryBrand SB7, Andy Raskin's Strategic Narrative, the Messaging House, and MECLABS quality tests. Auto-activates during messaging framework development, value proposition creation, and brand pillar definition. Use when discussing messaging architecture, value proposition, brand pillars, message layers, messaging house, messaging hierarchy, elevator pitch, Peep Laja, Geoffrey Moore, April Dunford, StoryBrand, Andy Raskin, or MECLABS.
What this skill does
# Brand Messaging Architecture Framework
Quick reference for developing brand messaging, value propositions, and brand pillars using established methodologies from leading strategists.
> "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" |
> **Critical 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 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
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 ThRelated in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".