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 set of written style rules that an AI agent follows when it drafts marketing copy, customer messages and public content. This guide explains what a skill is, how to install this one, how to ask for it in plain language, and how to adapt it for your own company. By the end you will be able to install the skill, check that the agent is using it, and decide whether the included rules fit your team.
Brand Voice Guideluongnv89/claude-howto · MIT Download the skill 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 all projects, or into a project's .claude/skills/ folder.
- 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the ZIP.
- 4Ask for copy in plain language. Request marketing copy, a customer reply or public content and mention tone or writing style.
- 5Compare the output. Check the draft for active voice, short sentences, a call to action and no banned words.
- 6Adapt the rules. Edit SKILL.md and tone-examples.md to match your own brand guide before relying on it.
What does the brand-voice skill make the agent do?
When the skill is installed, the agent checks its drafts against a set of brand voice rules. The rules ask for copy that is friendly but professional, clear and free of jargon, written in the active voice, made of short sentences, and ending with a call to action. The skill also lists preferred words and banned words, such as avoiding 'cutting-edge', 'game-changer', 'leverage' and 'utilize'.
The skill includes example phrases that show what good and bad copy looks like, plus a second file, tone-examples.md, with sample announcements, support messages and feature descriptions. It is a set of guidelines, not a program, so it changes the wording the agent produces rather than running any tools.
- Friendly but professional, not casual
- Clear, with technical ideas explained simply
- Active voice and sentences under about 20 words
- A call to action in each piece
- Preferred words (for example 'Agent' instead of 'bot') and banned buzzwords
How do you install the brand-voice skill?
Download the ZIP file from the skill's page on this site. Unzip it into one of two folders: ~/.claude/skills/ to make the skill available to all your projects, or a project's .claude/skills/ folder to limit it to that project.
If you use the Claude apps instead, upload the ZIP under Settings → Capabilities → Skills.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload the ZIP
How do you trigger the skill with natural requests?
The skill's description says it applies when you write marketing copy, customer communication or public content, or when you mention brand tone, tone or writing style. You do not need a special command. Describe the task and mention the tone or style you want.
The skill is marked as not user-invocable in its settings, so it works in the background as guidance for the agent rather than appearing as a command you call by name.
- "Write a launch announcement for our new feature in our brand tone."
- "Draft a reply to this customer complaint that follows our writing style."
- "Rewrite this landing page paragraph to match our tone and avoid buzzwords."
What do good and bad outputs look like?
The skill's example of good copy is short and specific: it states what Claude does, gives a concrete benefit, and points toward action. The bad example is vague, uses corporate jargon and gives no concrete value. Comparing your agent's output to these examples is a quick way to see whether the skill is shaping the text.
Here is the good example from the skill's SKILL.md: "Claude 能自动化你的代码审查流程。它不再需要你手动检查每个 PR，而是会审查安全性、性能和质量，每周为团队节省数小时。" It is written in Chinese, matching the skill's source language.
- Good: clear value, concrete benefit, action-oriented
- Bad: vague claims, jargon, no specific value
What does the skill need and what should you check first?
The skill lists no required dependencies. It does not run scripts and does not use the network. Those facts come from the skill's own description, so you can rely on them when deciding whether to install it.
The skill controls style only. It does not check accuracy, facts, pricing or legal and regulatory compliance. Content that needs legal review still needs a human reviewer.
- Requires: nothing listed
- Runs scripts: no
- Uses network: no
- Does not verify facts, claims or compliance
How do you adapt the skill for your own brand?
The included rules describe one specific company's mission and values (an AI development workflow automation company). If you use them unchanged, the agent will produce text that sounds like that company, not yours. Teams with an established brand voice should replace the mission, values, tone list, word lists and examples in SKILL.md and tone-examples.md with their own.
Start by editing the tone section, the do and don't lists, and the word lists. Then replace the examples so they show your company's real good and bad copy.
- Replace the mission and values section
- Rewrite the tone adjectives to match your guide
- Update the preferred and banned word lists
- Swap in your own good and bad examples in tone-examples.md
What people use it for
- Drafting product launch announcements with a consistent tone
- Writing empathetic support replies to customer messages
- Rewriting landing page text to remove buzzwords like 'leverage'
- Producing educational blog posts that explain technical ideas simply
- Keeping a team's marketing copy sounding the same across writers
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 instead upload the ZIP under Settings → Capabilities → Skills.
Does the brand-voice skill need any other software?
The skill lists no required dependencies. It does not run scripts and does not use the network, according to its description.
Is the brand-voice skill free?
The project is listed under the MIT licence. The source provided does not state pricing, so check the licence file in the repository for the terms.
Can I use the skill for my own company's tone?
Yes, but the included rules describe a specific company's mission and values, so you should replace them with your own guide. Otherwise the output will sound off-brand.
Will the skill make my content legally compliant?
No. The skill only controls style. It does not check accuracy or compliance, so legal or regulatory content needs a human review.
Why doesn't the agent seem to use the skill?
Make the request mention marketing copy, customer communication or tone or writing style, since those match the skill's description. Also confirm the ZIP was unzipped into the correct skills folder or uploaded in the apps.
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 you want an agent to write marketing copy, customer messages and public content in a consistent, plain style and to avoid buzzwords. Teams with an established brand voice should either adapt the rules thoroughly or choose a different tool, because the included mission, values and examples belong to one specific company. Do not rely on it for accuracy or legal review.
Download the skill