# brand-storytelling

A skill that helps you build a brand story: positioning, pitch, messaging. Useful when the company talks about itself and only a feature list sticks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 334 installs · ★ 643
- Author: pedronauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/marketing/brand-storytelling/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/brand-storytelling

## What it does

The skill runs a conversation about your brand in stages. First it asks who is listening and what they should do afterwards. Then it helps you locate the core: the change or insight the brand revolves around. Next comes structure, followed by phrases, metaphors and concrete moments that other people can repeat on their own.

Its guidance draws on product leaders and storytelling specialists. The story comes before the product. The customer is the hero, and the founder hands over the tool rather than taking the stage. The skill also names the usual failures it will point out: opening with who you are, listing features instead of a shift, a vision with nothing at stake. Expect questions rather than a finished draft.

The full set of interview observations sits in `references/guest-insights.md`, which the skill opens on request. Runs in Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill brand-storytelling -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill brand-storytelling -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill brand-storytelling -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills brand-storytelling
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill brand-storytelling -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/marketing/brand-storytelling
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill brand-storytelling -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/pedronauck/skills/tree/HEAD/skills/marketing/brand-storytelling/SKILL.md

## When to use it
- Write company positioning that isn't a feature list
- Open a pitch with the listener's problem
- Coin a phrase people will repeat at dinner
- Check whether the customer or the founder is the hero
- Pin down the single moment of change behind the story

## Example prompts
- Help me shape a brand story for investors, the product is a warehouse service
- Rework our pitch: it opens with who we are, I want to start from the customer's problem
- Build a messaging framework for the landing page, with the customer as the hero

## Similar
- [seo-audit](https://affpapa.org/en/nevibecode/skills/coreyhaines31-seo-audit.md) — skill · 237600 installs
- [programmatic-seo](https://affpapa.org/en/nevibecode/skills/coreyhaines31-programmatic-seo.md) — skill · 149700 installs
- [copy-editing](https://affpapa.org/en/nevibecode/skills/coreyhaines31-copy-editing.md) — skill · 149100 installs
- [marketing-ideas](https://affpapa.org/en/nevibecode/skills/coreyhaines31-marketing-ideas.md) — skill · 146900 installs
- [sales-enablement](https://affpapa.org/en/nevibecode/skills/sales-enablement.md) — skill · 118800 installs
- [revops](https://affpapa.org/en/nevibecode/skills/revops.md) — skill · 113500 installs

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 18 cards

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