Guide · Agent skill
How to use the Brand Voice Guide agent skill (brand-voice)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The brand-voice skill is a written style guide that an AI agent reads before it writes marketing copy, customer emails or other public content. Once it is installed, the agent uses a defined tone, prefers active voice and short sentences, avoids buzzwords and includes a call to action. This guide is for people who have never used agent skills, and it 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 file from this page. It contains SKILL.md and tone-examples.md.
- 2Unzip the folder. Extract the archive so you have a brand-voice folder containing both files.
- 3Place the skill. Move the folder to ~/.claude/skills/ for your account or to a project's .claude/skills/ folder for one project.
- 4Or upload it in the apps. In the Claude apps, open Settings, go to Capabilities, choose Skills and upload the skill.
- 5Replace the sample brand. Edit SKILL.md and tone-examples.md so the mission, values, tone, vocabulary and examples describe your company.
- 6Ask for copy naturally. Request marketing copy, a customer email or public content, and mention brand voice or tone if you want the guide applied.
- 7Review the draft. Check facts, claims and wording before anything is published.
What the brand-voice skill makes the agent do
An agent skill is a folder of instructions that an AI agent loads when a task matches it. The brand-voice skill contains a style guide. It does not connect to any service, tool or account. It only changes how the agent writes.
The included rules set a tone of voice with four traits: friendly and professional, clear and concise, confident, and empathetic. The guide asks the agent to address the reader as 'you', use active voice, start with the value to the reader, use concrete examples, keep each sentence under 20 words and include a call to action. It also lists words to avoid, such as 'cutting-edge', 'game-changer', 'leverage', 'utilize' and 'paradigm shift', and phrases such as 'we believe' and 'we think'.
- Tone: friendly and professional, clear and concise, confident, empathetic
- Writing rules: active voice, sentences under 20 words, lists for clarity, a call to action
- Vocabulary: preferred terms (for example 'streamline' instead of 'revolutionize') and terms to avoid
- Good and bad examples with a short explanation of why each works or fails
Install the brand-voice skill
Download the brand-voice ZIP file from this page. Unzip it and place the brand-voice folder in one of two locations. Use ~/.claude/skills/ to make the skill available in your user account, or use a project's .claude/skills/ folder to make it available only to that project.
You can also upload the skill in the Claude apps. Open Settings, go to Capabilities, then choose Skills and upload the skill there.
- Personal install: put the folder in ~/.claude/skills/
- Project install: put the folder in the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload the skill
~/.claude/skills/brand-voice/Trigger the skill with natural requests
The skill's description tells the agent when to use it: when writing marketing copy, customer communications or public content, or when you mention brand voice, tone or writing style. The skill is set to user-invocable: false in its SKILL.md, so you do not call it by name. You just make a normal request and the agent decides whether the skill applies.
Be specific about the content you need. The more the request says what the copy is for and who will read it, the more useful the draft will be.
- 'Write a launch announcement for our new reporting feature in our brand voice.'
- 'Draft a reply to a customer whose deployment failed. Keep it empathetic and short.'
- 'Rewrite this product page so it uses active voice and no buzzwords.'
- 'Give me a blog intro in our brand tone of voice about code review.'
Make the skill match your brand
The included SKILL.md describes a sample brand: its mission, values, tone, vocabulary and examples are all for a fictional AI development company. If you use the skill as is, the output will sound like that sample brand, not yours. Before you rely on it, edit SKILL.md so the mission, values, tone traits, preferred and avoided words, and good and bad examples describe your own company.
The tone-examples.md file holds short sample lines for four situations: an announcement, a supportive message, a confident product description and an educational blog post. Replace these with lines your team has approved so the agent learns from your real voice.
- Replace the mission and values with your own
- Rewrite the four tone traits to match how your brand speaks
- Update the recommended and avoided vocabulary lists
- Swap in your own good and bad examples
- Replace the sample lines in tone-examples.md
Review output before publishing
The skill shapes style only. It cannot check facts, product claims, prices or legal wording. Treat every draft as a first version that a person must check before it goes to customers or the public.
The skill runs no scripts and uses no network connection, according to its listing. Even so, read any skill you install before you rely on it, since it is a set of instructions the agent will follow.
- Check every factual and product claim against your own sources
- Have legal or compliance review wording that carries risk
- Edit drafts for context the skill cannot know, such as current offers
What people use it for
- Drafting product launch announcements that follow one consistent tone
- Writing support replies to customers that are empathetic and short
- Rewriting existing web copy to use active voice and remove buzzwords
- Producing blog intros that match a brand's educational style
- Keeping a team of writers consistent across customer-facing messages
Frequently asked questions
Is the brand-voice skill free?
The skill is published under the MIT licence, as stated on this page. Check the licence file in the source repository for the full terms before you reuse or redistribute it.
What do I need to use the brand-voice skill?
The listing states no specific requirements. It runs no scripts and uses no network connection. You need an agent environment that supports skills, such as Claude, to load it.
Where do I put the brand-voice folder?
Place it in ~/.claude/skills/ to use it across your user account, or in a project's .claude/skills/ folder to limit it to that project. In the Claude apps, you can upload it under Settings, Capabilities, Skills.
Why doesn't the agent use the skill when I ask for copy?
The skill applies when your request matches its description, such as writing marketing copy or customer communications, or when you mention brand voice, tone or style. Make the request explicit by naming the content type and the tone you want.
Can I use the skill without changing it?
You can, but the included rules describe a sample brand focused on AI development. The output will reflect that sample voice, so you should replace the mission, values, vocabulary and examples with your own.
How does this compare with a tool that connects to my brand assets?
This skill is only a written style guide for the agent. It does not connect to your website, CMS, email platform or brand library, so you need to supply the guidelines yourself and check the output.
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
Choose this skill if your team already has brand guidelines and wants AI drafts to follow them consistently across marketing and customer messages. Skip it if you have no defined voice yet, because the included rules describe a sample brand and would make your copy sound like someone else. Either way, a person should review anything before it is published.
Download the skill