brand-brief — Claude Code skill: what it does, how to install
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.
no license ★ 215 updated 2026-08-18
/plugin marketplace add Blotato-Inc/blotato-skills
/plugin install blotato@blotato-skillsWhat brand-brief 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.
What it helps with
- 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 for the agent
- 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.
How to install brand-brief
1Plugin marketplace
/plugin marketplace add Blotato-Inc/blotato-skills/plugin install blotato@blotato-skillsThis installs the whole blotato plugin with all its skills
2Skills CLI (Vercel)
npx skills add Blotato-Inc/blotato-skills --skill brand-brief -a claude-code3Manually: put the files in place
~/.claude/skills/brand-brief/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/brand-brief/
1Skills CLI (Vercel)
npx skills add Blotato-Inc/blotato-skills --skill brand-brief -a codex2Manually: put the files in place
.agents/skills/brand-brief/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Blotato-Inc/blotato-skills --skill brand-brief -a cursor2Manually: put the files in place
.cursor/skills/brand-brief/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Blotato-Inc/blotato-skills blotato/skills/brand-brief2Manually: put the files in place
.github/skills/brand-brief/SKILL.md1Skills CLI (Vercel)
npx skills add Blotato-Inc/blotato-skills --skill brand-brief -a gemini-cli2Platform CLI
gemini skills install https://github.com/Blotato-Inc/blotato-skills --path blotato/skills/brand-briefManually: put the files in place
.devin/skills/brand-brief/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about brand-brief
How do I install brand-brief in Claude Code?
Add the marketplace with /plugin marketplace add Blotato-Inc/blotato-skills, then run /plugin install blotato@blotato-skills.
What does brand-brief do?
It interviews you about your business one question at a time and writes the answers to brand-brief.md, which the other content skills read before writing anything.
Do I have to redo the brief for every post?
No. It is captured once and edited later. When the file already exists, the skill offers to update it or start fresh.