How to use the Brand Voice Writer agent skill

What is an agent skill and what does brand-voice do?

An agent skill is a folder of instructions and supporting files that an AI agent loads when a task matches the skill's description. The brand-voice skill is described as ensuring that all communication matches brand voice and tone guidelines, and it is meant for marketing copy, customer communications, public-facing content, or requests that mention brand voice, tone, or writing style.

Once installed, the agent checks its writing against a sample brand's voice rules: friendly but professional, clear and concise, confident, and empathetic. The skill is written around one example company's identity, so treat it as a template rather than a finished style guide for your business.

• Favors active voice, such as "Claude generates reports" rather than "Reports are generated by Claude".
• Uses "you" language and includes calls-to-action.
• Keeps sentences under 20 words and prefers lists for clarity.
• Avoids corporate jargon and buzzwords such as "cutting-edge", "game-changer", "leverage", "utilize" and "paradigm shift".
• Uses included email and social post templates and good and bad copy examples as reference.

How do you install the brand-voice skill?

You can install the skill for yourself or for a single project. Download the ZIP from the skill's page on this directory and unzip it. For a personal install, place the unzipped skill folder in ~/.claude/skills/. For a project install, place it in the project's .claude/skills/ folder.

If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.

• Personal install: ~/.claude/skills/
• Project install: .claude/skills/ inside your project
• Claude apps: Settings → Capabilities → Skills, then upload the skill

What files are in the skill?

The skill folder contains four files. SKILL.md holds the brand identity, writing guidelines, vocabulary lists and examples. The templates folder holds two starting points, and tone-examples.md shows the tone applied to different kinds of content.

• SKILL.md: mission, values, tone of voice, do's and don'ts, preferred and avoided terms, good and bad examples
• templates/email-template.txt: subject line, greeting, opening, body, example, call to action and sign-off placeholders
• templates/social-post-template.txt: hook, two to three lines of value, call to action, and one or two emoji at most
• tone-examples.md: sample lines for an exciting announcement, empathetic support, a confident product feature and an educational blog post

How do you trigger the skill with natural requests?

You do not need a special command. Ask for the kind of content you want and mention tone, voice or the channel. The skill's description lists the triggers: marketing copy, customer communications, public-facing content, and mentions of brand voice, tone or writing style.

Name the audience, the channel and the goal in your request. The more context you give, the easier it is for the agent to match the rules.

• "Write a launch email for our new feature in our brand voice."
• "Draft three social posts announcing the release, following our tone guidelines."
• "Rewrite this customer apology so it sounds empathetic and clear."
• "Check this landing page copy for jargon and buzzwords."

What does a before-and-after look like?

The skill includes a good and a bad example to show the difference. The bad example is vague and uses jargon. The good example names the value, gives specific benefits and asks for action.

• Bad: "Claude leverages cutting-edge AI to provide comprehensive software development solutions." It is vague, uses corporate jargon and gives no specific value.
• Good: "Claude automates your code review process. Instead of manually checking each PR, Claude reviews security, performance, and quality—saving your team hours every week." It has clear value, specific benefits and an action-oriented tone.

How do you adapt the skill to your own brand?

The skill's mission, values, tone and vocabulary belong to a sample company. If you have an established brand guide, rewrite these sections before relying on the skill, because the sample rules could conflict with yours. If you do not have a guide, use the skill as a starting style guide and edit it.

Edit SKILL.md first, then update the templates and tone examples so they match the new rules. Keep the rules that are general writing advice, such as active voice and short sentences, if they suit you.

• Replace the Mission and Values sections with your own.
• Change the Tone of Voice list to your brand's traits.
• Update Preferred Terms and Avoid Terms to match your vocabulary.
• Replace the good and bad examples with copy from your brand.
• Adjust the templates and tone-examples.md to fit your channels.

What does the skill need, and what should you watch for?

The source lists no special requirements. The skill does not run scripts and does not use the network. It only covers style, so it does not check facts, accuracy or compliance. Do not rely on it for legal, medical or other regulated communications, and have a qualified reviewer check those.

• Requires: nothing listed by the source
• Runs scripts: no
• Uses network: no
• Not for teams with an established brand guide unless you rewrite the built-in rules
• Not for legal, medical or regulated communications