Guide · Agent skill
How to use the Brand Voice Guide agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The brand-voice skill is a file of written style rules that an AI agent reads before it drafts marketing copy, customer messages or public content. It holds a mission statement, core values, a tone description, writing do's and don'ts, preferred and banned words, and good and bad examples. This guide explains what the skill does, how to install it, how to trigger it, and how to replace the sample brand with your own.
Brand Voice Guideluongnv89/claude-howto · MIT Download the skill Quick start
- 1Download the ZIP. Get the brand-voice ZIP from this page and unzip it on your computer.
- 2Choose an install location. Place the folder in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder for one project.
- 3Or upload in the Claude apps. If you use the Claude apps, upload the skill under Settings → Capabilities → Skills.
- 4Ask for content naturally. Describe the marketing copy, customer message or public content you need, and mention tone or voice.
- 5Check the draft. Compare the output against the banned words and do's and don'ts in the guide.
- 6Adapt the sample brand. Replace the mission, values, tone, vocabulary and examples with your own before relying on the skill for your company.
What is an agent skill, and what does brand-voice make the agent do?
An agent skill is a folder containing a SKILL.md file with instructions that an AI agent can load when a task calls for them. The brand-voice skill's description says it is used when creating marketing copy, customer communications or public content, or when the user mentions brand tone, voice or writing style.
While the skill is active, the agent follows the rules in the file so its output stays consistent. The file's tone section asks for writing that is friendly but professional, clear and concise, confident, and empathetic. It also tells the agent to use "you" for the reader, write in the active voice, start with the value, use concrete examples, keep sentences under 20 words, and include calls to action.
- Filters banned words such as "cutting-edge", "game-changer", "leverage", "utilize" and "paradigm shift".
- Swaps in preferred terms, for example "Streamline" instead of "revolutionize" and "Agent" instead of "bot".
- Avoids phrases such as "we believe" or "we think" and all-caps emphasis.
- Uses the good and bad example pairs in the file as reference for what to write and what to avoid.
Install the brand-voice skill from the ZIP
Download the ZIP for brand-voice from this page and unzip it. The skill's only listed file is SKILL.md. Put the unzipped skill folder in one of two places: your personal skills folder, ~/.claude/skills/, so it is available across your projects, or a project's .claude/skills/ folder, so it is available only in that project.
If you use the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.
- Personal install: place the folder in ~/.claude/skills/.
- Project install: place the folder in the project's .claude/skills/ folder.
- Claude apps: upload it under Settings → Capabilities → Skills.
How do you trigger the brand-voice skill with natural requests?
You do not need a special command. The skill's frontmatter sets user-invocable to false, so you trigger it by describing your task. Mention the kind of content you need, or mention tone, voice or writing style directly. The skill's description lists marketing copy, customer communications and public content as the triggers.
Be specific about the audience and the channel. The more context you give, the more the agent's draft will reflect the rules in the guide.
- "Draft a launch email for our new feature in our brand voice."
- "Write a customer reply about a delayed order. Check our tone and banned words."
- "Rewrite this landing page intro so it matches our brand style."
- "Review this blog post for brand voice and jargon."
What does the skill need, and what does it run?
The source lists no required tools or packages for this skill. It does not run scripts and does not use the network. The only file listed is SKILL.md, which contains plain instructions and the sample brand content.
Because the skill only contains text rules, it does not check whether a claim is true or whether copy meets legal or regulatory requirements.
- Requires: nothing listed.
- Runs scripts: no.
- Uses network: no.
- Files: SKILL.md.
How do you adapt the sample guide to your own brand?
The sample guide in SKILL.md is written for an AI automation company that promotes Claude. Its mission, values, tone, and vocabulary are specific to that brand. If you use the file unchanged for another company, the output will drift toward that company's messaging.
Replace the sample content section by section. Keep the structure, which covers identity, writing guidelines, vocabulary and examples, and rewrite each part for your brand.
- Mission: write one sentence describing what your company helps people do.
- Values: replace the three sample values with your own.
- Tone: keep four to five traits that describe how you want to sound.
- Vocabulary: list your preferred terms and banned terms, with the reason for each.
- Examples: write one good and one bad example for your own copy and explain why each works or fails.
What people use it for
- Drafting marketing emails that sound the same across a team.
- Writing customer support replies that avoid jargon and use "you".
- Reviewing landing page or blog copy for banned words such as "leverage" or "cutting-edge".
- Creating a first draft of your own brand style guide by replacing the sample content.
Frequently asked questions
Is the brand-voice skill free to use?
The item is listed under the MIT licence. Check the licence file in the source repository for the full terms before you reuse or modify it.
What do I need to install the brand-voice skill?
The source lists no required tools, packages or scripts. You need a way to place the skill folder in ~/.claude/skills/ or a project's .claude/skills/ folder, or to upload it in the Claude apps under Settings → Capabilities → Skills.
Does the brand-voice skill run scripts or use the internet?
No. The source lists the skill as not running scripts and not using the network. It contains a single SKILL.md file of text instructions.
Can I use brand-voice for my own company?
Yes, but the sample mission, values and vocabulary are written for an AI automation company that promotes Claude. Rewrite those sections for your brand first, or the output will match the wrong messaging.
Will the skill check my copy for legal or medical accuracy?
No. The skill enforces style only. It does not check accuracy or compliance, so legal, medical or regulated copy still needs formal review.
How is this different from a plain style guide I paste into the chat?
The source describes the skill as a set of rules the agent follows when drafting, triggered by the content type or by mentions of tone and voice. A pasted guide depends on you remembering to include it each time. This comparison is based on the skill's description and does not include benchmarks.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use brand-voice if your team wants AI-drafted marketing or customer messages to share one consistent voice, or if you want a starting template for your own style guide. Pick something else if you need a skill for another company's voice without rewriting it, or if you need legal, medical or regulated copy checked for accuracy, since this skill only enforces style.
Download the skill