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 written style guide that an AI agent reads before it drafts marketing text, customer messages or public content. It is built around one sample brand, an AI development-automation company, so it works as a template you adapt to your own company. This guide explains what the skill makes the agent do, how to install it, how to trigger it, and what to change before you rely on it.
Quick start
- 1Download the ZIP. Get the brand-voice ZIP file from this page.
- 2Unzip into a skills folder. Extract it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder.
- 3Or upload in the Claude apps. Go to Settings → Capabilities → Skills and upload the skill.
- 4Adapt SKILL.md to your brand. Replace the sample mission, values, tone, word lists and examples with your own.
- 5Update the examples and templates. Edit tone-examples.md and the files in templates/ to match your brand.
- 6Ask for content in plain words. Request a draft of marketing text or a customer message and review it against the rules.
What the Brand Voice Guide skill makes the agent do
Agent skills are folders of instructions that an AI agent loads when a task matches them. The brand-voice skill contains a style guide: a mission, core values, four tone traits (friendly but professional, clear and concise, confident, empathetic), preferred and banned words, and sample good and bad copy.
When the agent drafts text, it applies these rules. For example, it addresses readers as 'you', uses active voice, keeps sentences under 20 words, and avoids jargon such as 'leverage'. The skill also includes an email template and a social post template to structure messages.
- Uses 'you' when addressing readers
- Writes in active voice, for example 'Claude generates reports' rather than 'Reports are generated by Claude'
- Keeps sentences under 20 words and uses lists for clarity
- Avoids words such as 'leverage', 'cutting-edge' and 'paradigm shift'
- Prefers terms such as 'Agent' over 'bot' and 'Optimize' over 'revolutionize'
Install the brand-voice skill
Download the ZIP file from this page. Unzip it into your personal skills folder, ~/.claude/skills/, or into a project's .claude/skills/ folder if you want the skill available only in that project.
If you use the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/
- Claude apps: Settings → Capabilities → Skills, then upload
Adapt the guide to your own brand before use
The skill describes a specific sample brand. Its mission, values, tone and word lists belong to an AI workflow automation company, so using it unchanged would misrepresent another business. Edit SKILL.md to replace the mission, values, tone traits, preferred and banned words, and the good and bad examples with your own.
Also update tone-examples.md and the two templates in templates/ so that every sample matches your brand.
- Replace the mission and core values in SKILL.md
- Rewrite the preferred and banned word lists
- Replace the good and bad copy examples
- Update tone-examples.md and the templates to match
Trigger the skill with natural requests
The skill's description says it applies when you create marketing text, customer communications or public content, or when you mention brand voice, tone or writing style. You do not need a special command. Describe the task in plain words and the agent should load the guide.
The skill file sets user-invocable to false, so it is not offered as a slash command. Let the request itself trigger it.
- 'Draft a launch email for our new feature and keep our brand voice.'
- 'Write a LinkedIn post announcing the release, in our tone.'
- 'Check this customer reply against our brand voice.'
- 'What tone should our onboarding messages use?'
Check the result against the rules
Review the draft against the guide. Look for passive sentences, jargon, sentences longer than 20 words and any banned words. The guide's own bad example shows what to avoid: vague claims, corporate jargon and no concrete value.
The skill only applies rules written in its files. It does not analyze your existing content or research your brand, so the guide has to be accurate for your company.
- Check for banned words and jargon
- Confirm sentences are under 20 words
- Confirm the copy opens with the value to the reader
What people use it for
- Drafting product announcement posts that open with the value to readers
- Writing customer support emails using the email template structure
- Keeping launch emails and social posts in one consistent tone
- Onboarding new writers by giving them concrete good and bad examples
Frequently asked questions
How do I install the brand-voice agent skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps, you can upload it under Settings → Capabilities → Skills.
Do I need anything else to run this skill?
The listing states that it requires nothing extra, runs no scripts and uses no network access. It is a set of text files with style rules and templates.
Is the brand-voice skill free to use?
The skill is published under the MIT licence. This page does not list prices, so check the licence file in the download for the terms.
Can I use it for my company without changing anything?
Not safely. The guide describes a sample AI development-automation brand, so its mission, values and word lists would misrepresent another business. Edit SKILL.md and the examples to match your brand first.
Will the skill analyze my existing website or posts to learn my voice?
No. The skill only uses the rules written in its files and does not analyze your company's existing content. You need to write your own rules into the guide.
Should I use this skill for legal, regulatory or medical copy?
No, not as the final check. A style guide does not replace human review for legal, regulatory or medical text, so have a qualified person approve that copy.
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 this skill if your team wants AI-drafted marketing copy, emails or announcements to follow one consistent voice, and you are willing to rewrite the sample brand into your own. Pick something else if you want automatic brand research, or if you need final approval for legal, regulatory or medical copy, which requires human review.
Download the skill