# brand-brief

Runs a short interview about your business and saves it to brand-brief.md, so the other content skills in the set write in your voice instead of a template.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 215 repo stars
- Author: Blotato
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Blotato-Inc/blotato-skills/tree/HEAD/blotato/skills/brand-brief/SKILL.md
- Updated: 2026-08-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/brand-brief

## What it does

The skill walks a business owner through six questions: what you sell, who buys, the one action a reader should take, an opinion your industry would argue with, a recent story, and the voice you write in. They come one at a time, each expecting a sentence or three. A one-word answer gets a follow-up. It also starts on its own when another skill needs context and finds no file.

Answers land in `brand-brief.md` in the current folder, split into Business, Customer, Primary CTA, Strong Opinion, Story Vault and Voice, plus house rules such as contractions, active voice and digits for numbers. Run it again and it reads the existing file first, then asks whether to update that or start over. The toolset is small: Read, Write, Edit, Glob and AskUserQuestion.

Skip the brief and the other skills in the set (`post-writer`, `content-coach`, `post-grader`) have nothing to anchor to: posts come out generic and voice can't be graded. The contrarian opinion is the part the skill treats as its main fuel for posts, so answering “nothing comes to mind” undercuts the whole file.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add Blotato-Inc/blotato-skills
```
In the agent chat (not a shell):
```text
/plugin install blotato@blotato-skills
```
This installs the whole blotato plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add Blotato-Inc/blotato-skills --skill brand-brief -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Blotato-Inc/blotato-skills --skill brand-brief -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Blotato-Inc/blotato-skills --skill brand-brief -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Blotato-Inc/blotato-skills blotato/skills/brand-brief
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Blotato-Inc/blotato-skills --skill brand-brief -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Blotato-Inc/blotato-skills --path blotato/skills/brand-brief
```

### Windsurf (Devin Desktop)

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

### 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/Blotato-Inc/blotato-skills/tree/HEAD/blotato/skills/brand-brief/SKILL.md

## When to use it
- capture what the business sells in plain words
- describe one real customer instead of a demographic
- pick a single call to action for every post
- record a contrarian opinion the posts can lean on
- update the brief when the product or voice changes

## Example prompts
- Set up my brand, I'll tell you what I sell and who buys.
- Update my business info in `brand-brief.md`.
- Save my brand voice so my posts sound like my shop.

## Similar
- [brand-writer](https://affpapa.org/en/nevibecode/skills/brand-writer.md) — skill · 821 installs
- [brand-voice](https://affpapa.org/en/nevibecode/skills/luongnv89-brand-voice.md) — skill · ★ 47494 repo stars
- [brand-language-codifier](https://affpapa.org/en/nevibecode/skills/brand-language-codifier.md) — skill · 1100 installs
- [voice-dossier-builder](https://affpapa.org/en/nevibecode/skills/voice-dossier-builder.md) — skill · 1100 installs
- [brand-voice-analyzer](https://affpapa.org/en/nevibecode/skills/brand-voice-analyzer.md) — skill · 281 installs
- [bootstrap](https://affpapa.org/en/nevibecode/skills/manojbajaj95-bootstrap.md) — skill · 127 installs

From the same set: [blotato-inc/blotato-skills](https://affpapa.org/en/nevibecode/by/blotato-inc/blotato-skills.md) — 9 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
