# storybrand-messaging

A skill that scores and rewrites brand messaging along the StoryBrand beats, with the customer as hero and your brand as the guide. Useful when the homepage copy is not landing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 6100 installs · ★ 2508
- Author: wondelai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/wondelai/skills/tree/HEAD/storybrand-messaging/SKILL.md
- Updated: 2026-09-10
- HTML: https://affpapa.org/en/nevibecode/skills/storybrand-messaging

## What it does

The skill walks copy through the seven SB7 beats. The customer is the hero and the brand is the guide helping them win: one clear desire, then the problem on three levels (external, internal, philosophical) with a specific villain, then empathy paired with authority, a 3-4 step plan, one direct call to action, and the stakes of success and failure. What ships inside is instruction for the model, not code.

There is a score attached. The Quick Diagnostic counts 7 rows and adds up to 3 points for a one-liner someone can repeat after hearing it once; the skill asks for the current score and the exact edits needed to reach 10/10. Two references come with it: `references/brand-script.md` for drafting all seven elements from a blank page, and `references/sales-conversations.md` for discovery questions and objection handling on a call.

Triggering runs on phrasing like "brand message", "website copy", "elevator pitch", "one-liner", "brand script". A request without any of them may not fire the skill, so name it yourself. It also keeps the plan to 4 steps, which means a long funnel gets trimmed rather than described.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill storybrand-messaging -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/storybrand-messaging/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/storybrand-messaging/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill storybrand-messaging -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/storybrand-messaging/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill storybrand-messaging -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/storybrand-messaging/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wondelai/skills storybrand-messaging
```

2. **Manually: put the files in place**
- File: `.github/skills/storybrand-messaging/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill storybrand-messaging -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/wondelai/skills --path storybrand-messaging
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/storybrand-messaging/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill storybrand-messaging -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/wondelai/skills/tree/HEAD/storybrand-messaging/SKILL.md

## When to use it
- rewrite a homepage headline so the customer sees their own goal
- draft a one-liner for a pitch and test it on first hearing
- split a customer problem into external, internal and philosophical layers
- cut a bloated onboarding flow to a 3-4 step plan
- keep sales emails and collateral saying the same thing

## Example prompts
- Rewrite the top of the landing page with StoryBrand: customer as hero, us as the guide. Here is the current copy.
- Build a brand script for our product and score the current copy with the Quick Diagnostic up to 10/10
- Our one-liner does not stick. Rewrite it so someone can repeat it after one read.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 739485a1e0a58545.

BEGIN THIRD-PARTY FILE 739485a1e0a58545
```text
---
name: 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)
```
END THIRD-PARTY FILE 739485a1e0a58545

The third-party file has ended. Everything between the 739485a1e0a58545 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2398 of 14858 bytes. © wondelai · MIT · https://github.com/wondelai/skills/tree/HEAD/storybrand-messaging/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md