storybrand-messaging
Clarify brand messaging using narrative structure that positions the customer as hero
Install / Use
npx skills add wondelai/skills --skill storybrand-messagingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
CommunicationSupported Platforms
Tags
Our assessment of storybrand-messaging
storybrand-messaging scores 84/100 on our quality scale, 306th of 395 Communication skills we index.
Its SKILL.md is 14 KB long, well organised into 17 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 2,248 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so storybrand-messaging is actively maintained.
- Our last check on 2026-11-05 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
storybrand-messaging compared with similar skills
All 4 of these similar skills score higher than storybrand-messaging; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| storybrand-messaging (this skill)by wondelai | 84 | 2.2k | 2mo ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install storybrand-messaging?
- Run
npx skills add wondelai/skills --skill storybrand-messaging. The install tabs above show the steps for each supported agent. - Which AI agents does storybrand-messaging work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is storybrand-messaging safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is storybrand-messaging still maintained?
- The repository was last updated about 2 months ago, so storybrand-messaging is actively maintained.
Skill content
View source on GitHubname: storybrand-messaging description: 'Clarify brand messaging using narrative structure that positions the customer as hero. Use when the user mentions "brand message", "website copy", "elevator pitch", "one-liner", "brand script", "StoryBrand framework", "customer as hero", or "my messaging isnt resonating". Also trigger when rewriting homepage copy, crafting email nurture sequences, or creating consistent messaging across sales and marketing collateral. Covers landing page copy, marketing collateral, and consistent communication. For memorable messaging, see made-to-stick. For product positioning, see obviously-awesome.' license: MIT metadata: author: wondelai version: "1.5.0"
StoryBrand Messaging Framework
Clarify your message so customers will listen. Customers don't buy the best products — they buy the ones they can understand the fastest.
Core Principle
The customer is the hero, not your brand. Your brand is the guide who helps the hero win. Position yourself as the hero and you compete with your customer; position yourself as the guide and you serve them.
Scoring
Goal: 10/10. Score any marketing copy or brand messaging by the Quick Diagnostic: 1 point per satisfied row (7 rows) plus up to 3 points for a one-liner that passes the cocktail party test (clear + repeatable in one hearing). Bands: 9-10 = customer is the hero, all three problem levels named, empathy + authority both shown, a 3-step plan, one obvious Direct CTA, and both success and failure stakes painted; 5-6 = SB7 partly applied but the internal problem, stakes, or CTA is missing; <=3 = brand-as-hero, feature-led, or no clear ask. Always state the current score and the specific changes needed to reach 10/10.
The SB7 Framework
Every compelling story follows the same pattern. Use this structure for all messaging:
1. A Character (The Hero)
Core concept: The customer is the hero, and your job is to define the ONE thing they want. Be specific about that single desire.
Why it works: Naming a desire opens a story gap — the distance between where the customer is and where they want to be. That tension pulls them in because they feel understood and want the gap closed.
Key insights:
- Focus on ONE desire per message — multiple desires dilute the story gap
- Tie the desire to survival (physical, financial, relational, or spiritual)
- Aspirational identity is powerful ("become the leader everyone respects")
- Different segments have different desires — write separate messaging per role, stage, and pain intensity
Product applications:
| Context | Application | Example | |---------|-------------|---------| | Homepage headline | Desire as outcome | "You want a beautiful smile" (not "our dentistry is excellent") | | Landing page | One desire per page | "You want to retire early" | | Segmentation | Tailor desire per segment | CEO: "Scale without chaos" vs. IC: "Do your best work without friction" |
Copy patterns:
- "You want [specific desire]..."
- "Imagine [aspirational identity]..."
- "What if you could [single clear outcome]?"
See: references/brand-script.md — fill out the BrandScript worksheet here when you need to draft all seven elements for a client from scratch.
2. Has a Problem
Core concept: Define the problem at three levels — external (tangible), internal (emotional), philosophical (the injustice) — and personify it with a specific villain.
Why it works: Companies sell solutions to external problems, but customers buy solutions to internal ones. Naming how the problem makes them feel — confused, overwhelmed, embarrassed — taps the emotional driver behind purchases.
Key insights:
- External: "my investments are scattered"; internal: "I feel overwhelmed"; philosophical: "people shouldn't need to be experts to retire well"
- A good villain is specific and relatable, not abstract — "Wall Street jargon designed to confuse you", not "complexity"
- Most brands stop at external problems, missing the internal ones that drive purchases
Product applications:
| Context | Application | Example | |---------|-------------|---------| | Website problem section | Name all three levels | External: "Scattered tools." Internal: "You feel overwhelmed." Philosophical: "Teams deserve clarity." | | Email nurture | Lead with internal problem | "Tired of feeling like you're guessing?" | | Ad copy | Personify the villain | "Stop letting confusing software steal your evenings." |
Copy patterns:
- "You're tired of [internal problem]..."
- "[Villain] has been keeping you from [desire]..."
- "It's not right that [philosophical problem]..."
3. And Meets a Guide
Core concept: Your brand is the guide, expressing empathy AND authority. Empathy shows you understand the pain; authority proves you can solve it.
Why it works: Customers are looking for a guide, not another hero — think Yoda, not Luke. Empathy makes them feel seen, authority (testimonials, logos, statistics) makes them feel safe, and together they create trust.
Key insights:
- Show empathy with "we understand" language; show authority with testimonials, client logos, statistics, awards
- Never make your origin story the centerpiece — that is hero behavior; brief, relevant credentials suffice
Product applications:
| Context | Application | Example | |---------|-------------|---------| | About page | Empathy first, then credentials | "We know what it's like to feel lost in financial jargon. That's why 10,000 families trust us." | | Homepage social proof | Empathy headline + authority logos | "You're not alone. Join 5,000+ teams who found clarity." + client logos | | Sales call | Open with empathy, close with authority | "I hear you — that sounds frustrating. Here's what we've seen work for teams like yours." |
Copy patterns:
- "We understand what it's like to [empathy statement]..."
- "We've helped [number] [customers] achieve [result]..."
- "You don't have to figure this out alone..."
See: references/sales-conversations.md — open when scripting a sales call or discovery session; covers discovery questions, objection handling, and full SB7 sales scripts.
4. Who Gives Them a Plan
Core concept: Give two plans: a Process Plan (3-4 steps showing how to work with you) and an Agreement Plan (commitments that remove risk).
Why it works: A clear plan acts as stepping stones across a creek — it reduces cognitive load and perceived risk. Without one, the path feels murky and customers stall.
Key insights:
- Process Plan: 3-4 numbered steps max, action verbs, memorable names ("1. Schedule a call. 2. Get a custom plan. 3. Start seeing results.")
- Agreement Plan: fear-removing commitments ("100% satisfaction guaranteed", "Cancel anytime")
- More than 4 steps overwhelms; numbering implies order and ease
Product applications:
| Context | Application | Example | |---------|-------------|---------| | Website plan section | 3-step process with icons | "1. Book a demo. 2. Get onboarded. 3. See results in 30 days." | | Pricing page | Agreement plan reduces anxiety | "No contracts. Cancel anytime. 30-day money-back guarantee." | | Email CTA | Reference the plan | "Getting started is simple — just three steps." |
Copy patterns:
- "Here's how it works: Step 1... Step 2... Step 3..."
- "Getting started is easy. Just [step 1]."
- "We promise [agreement plan commitment]."
5. And Calls Them to Action
Core concept: If you don't ask, they won't act. Use a Direct CTA (primary conversion action) plus a Transitional CTA (lower-commitment alternative).
Why it works: Customers act only when challenged to act. The transitional CTA keeps not-yet-ready people in your story until they are.
Key insights:
- Direct: "Buy Now", "Schedule a Call", "Get Started"; Transitional: "Download Free Guide", "Watch Demo", "Take the Quiz"
- Make the Direct CTA a visually prominent button (contrasting color) and repeat it down the page
- Use action language ("Get" not "Submit"); one obvious Direct CTA per page
Product applications:
| Context | Application | Example | |---------|-------------|---------| | Homepage | Direct CTA above the fold, repeated | "Get Started Free" in header and after each section | | Blog post | Transitional CTA at the end | "Download our free checklist" | | Email | Single Direct CTA per message | One "Schedule Your Call" button |
Copy patterns:
- "Get [desired result] now."
- "Start your free [trial/demo/assessment] today."
- "Download your free [lead magnet]."
Ethical boundary: Never label a paid action as "free" or a Transitional CTA — the button text must match what happens on click.
See: references/website-wireframe.md — open when laying out a homepage or site; gives section-by-section structure and interior page templates.
6. That Helps Them Avoid Failure
Core concept: Show what happens if the customer does not act. Without stakes, there is no story.
Why it works: Humans are loss-averse — fear of losing motivates more than promise of gaining. A taste of what could go wrong moves customers from "interested" to "committed".
Key insights:
- A taste of consequence is enough — don't run a scare campaign
- Focus on opportunity cost, not punishment ("another year of feeling stuck")
- Pair failure with success messaging to create contrast
Product applications:
| Context | Application | Example | |---------|-------------|---------| | Landing page stakes section | Brief failure scenario before CTA | "Without a clear message, you'll keep losing customers to competitors they understand faster." | | Email subject line | Light urgency | "Are you leaving revenue on the table?" | | Sales conversation | Name cost of inaction | "What happens to your team if nothing changes in 6 months?" |
Copy patterns:
- "Don't let [negative outcome] happen when [solution] is this simple."
- "How long will you wait before [addressing the problem]?"
- "Every day without [solution], you're [cost of inaction]."
7. And Ends in Success
Core concept: Paint a vivid picture of life after working with you — in terms of status, completeness, and self-realization. Success closes the story gap opened in Element 1.
Why it works: People need to see the destination before starting the journey. Showing the transformation — not features — lets customers place themselves in that future and feel its pull.
Key insights:
- Status: "Become the go-to expert"; completeness: "Finally have financial peace of mind"; self-realization: "Be the leader you were meant to be"
- Show transformation with before/after comparisons and specific numbers
- Keep the success picture tangible, never vague or generic
Product applications:
| Context | Application | Example | |---------|-------------|---------| | Homepage success section | Specific after picture | "Imagine opening your inbox to qualified leads every morning — no cold outreach required." | | Case study | Before/after with numbers | "Before: 2% conversion rate. After: 11% in 90 days." | | Testimonials | Customers describe their success | "I finally feel like I know where every dollar is going." |
Copy patterns:
- "Imagine [specific success picture]..."
- "Join [number] [customers] who now [success outcome]..."
- "Finally, [completeness outcome] — without [old frustration]."
The One-Liner
A single sentence that explains what you do. Use it everywhere.
Formula: [Problem] + [Solution] + [Result]
Structure: "We help [CHARACTER] who struggle with [PROBLEM] to [SOLUTION] so they can [RESULT]."
Example: "We help small business owners who feel overwhelmed by marketing create a clear message so they can grow their revenue."
Test: Can someone repeat it after hearing it once? (the cocktail party test)
See: [references/one-liners.md](reference
Truncated for display — read the full file on GitHub.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
