brand-voice · luongnv89 — Claude Code skill: keep every text on brand
A skill that holds marketing copy, customer emails and public pages to one tone of voice. Handy when several people write for the same brand.
npx skills add luongnv89/claude-howto --skill brand-voice -a claude-codeWhat brand-voice does
The skill encodes a brand's voice and applies it to whatever the agent writes. Inside are a mission, values and four tone traits: friendly but professional, clear and concise, confident, empathetic. Then come do's and don'ts — address the reader as "you", prefer active voice, keep sentences under 20 words, lead with the value. Corporate jargon, "we believe" phrasing, all caps and walls of text are out.
A vocabulary section swaps weak words for better ones: streamline instead of revolutionize, integrate instead of synergize, use instead of utilize. Two examples show the gap between a concrete benefit and a vague claim about advanced technology.
The skill is marked user-invocable: false, so you cannot call it by hand — it fires when a task touches marketing copy, customer communication or public-facing content. The rules are written for one specific company: mission, values and vocabulary describe a particular product, so you will need to rewrite the file for your own brand.
What it helps with
- check marketing copy against the brand tone
- rewrite a customer email without corporate jargon
- keep one style when several writers share the content
- replace vague claims with a concrete benefit
- shorten sentences and break up walls of text
Example prompts for the agent
- check this draft against our brand voice and suggest edits
- rewrite the customer email in our tone, no jargon
- audit the landing page against brand-voice rules and list what breaks them
How to install brand-voice
1Skills CLI (Vercel)
npx skills add luongnv89/claude-howto --skill brand-voice -a claude-code2Manually: put the files in place
~/.claude/skills/brand-voice/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/brand-voice/
1Skills CLI (Vercel)
npx skills add luongnv89/claude-howto --skill brand-voice -a codex2Manually: put the files in place
.agents/skills/brand-voice/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add luongnv89/claude-howto --skill brand-voice -a cursor2Manually: put the files in place
.cursor/skills/brand-voice/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install luongnv89/claude-howto brand-voice2Manually: put the files in place
.github/skills/brand-voice/SKILL.md1Skills CLI (Vercel)
npx skills add luongnv89/claude-howto --skill brand-voice -a gemini-cli2Platform CLI
gemini skills install https://github.com/luongnv89/claude-howto --path 03-skills/brand-voiceManually: put the files in place
.devin/skills/brand-voice/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add luongnv89/claude-howto --skill brand-voice -a opencodeClaude.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-voice
How do I install brand-voice in Claude?
Run npx skills add luongnv89/claude-howto --skill brand-voice -a claude-code. The skill file lands at ~/.claude/skills/brand-voice/SKILL.md.
What does brand-voice do?
It keeps agent-written text aligned with a brand's voice and tone: marketing copy, customer emails, public content. It ships writing rules, a preferred-terms vocabulary and examples of good and bad phrasing.
Can I invoke brand-voice manually?
No. The skill declares user-invocable: false, so it triggers on its own when a task involves copywriting, customer communication or public-facing content.
Source text
SKILL.md · MIT
--- name: brand-voice description: Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when users mention brand voice, tone, or writing style. user-invocable: false --- # Brand Voice Skill ## Overview This skill ensures all communications maintain consistent brand voice, tone, and messaging. ## Brand Identity ### Mission Help teams automate their development workflows with AI ### Values - **Simplicity**: Make complex things simple - **Reliability**: Rock-solid execution - **Empowerment**: Enable human creativity ### Tone of Voice - **Friendly but professional** - approachable without being casual - **Clear and concise** - avoid jargon, explain technical concepts simply - **Confident** - we know what we're doing - **Empathetic** - understand user needs and pain points ## Writing Guidelines ### Do's ✅ - Use "you" when addressing readers - Use active voice: "Claude generates reports" not "Reports are generated by Claude" - Start with value proposition - Use concrete examples - Keep sentences under 20 words - Use lists for clarity - Include calls-to-action ### Don'ts ❌ - Don't use corporate jargon - Don't patronize or oversimplify - Don't use "we believe" or "we think" - Don't use ALL CAPS except for emphasis - Don't create walls of text - Don't assume technical knowledge ## Vocabulary ### ✅ Preferred Terms - Claude (not "the Claude AI") - Code generation (not "auto-coding") - Agent (not "bot") - Streamline (not "revolutionize") - Integrate (not "synergize") ### ❌ Avoid Terms - "Cutting-edge" (overused) - "Game-changer" (vague) - "Leverage" (corporate-speak) - "Utilize" (use "use") - "Paradigm shift" (unclear) ## Examples ### ✅ Good Example "Claude automates your code review process. Instead of manually checking each PR, Claude reviews security, performance, and quality—saving your team hours every week." Why it works: Clear value, specific benefits, action-oriented ### ❌ Bad Example "Claude leverages cutting-edge AI to provide comprehensive software development solutions." Why it doesn't work: Vague, corporate jargon, no specific value --- **Last Updated**: August 4, 2026 **Claude Code Version**: 2.1.220 **Sources**: - https://code.claude.com/docs/en/skills **Compatible Models**: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5
© luongnv89 · MIT · luongnv89/claude-howto
Similar skills
Everything for Marketing and content →brand-voice by other authors comes first.
