# brand-voice

A skill that holds marketing copy, customer emails and public pages to one tone of voice. Handy when several people write for the same brand.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 45153
- Author: luongnv89
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/luongnv89/claude-howto/tree/HEAD/03-skills/brand-voice/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/luongnv89-brand-voice

## What it does

The skill encodes a brand's voice and applies it to whatever the agent writes. Inside are a mission, values and four tone traits: friendly but professional, clear and concise, confident, empathetic. Then come do's and don'ts — address the reader as "you", prefer active voice, keep sentences under 20 words, lead with the value. Corporate jargon, "we believe" phrasing, all caps and walls of text are out.

A vocabulary section swaps weak words for better ones: streamline instead of revolutionize, integrate instead of synergize, use instead of utilize. Two examples show the gap between a concrete benefit and a vague claim about advanced technology.

The skill is marked `user-invocable: false`, so you cannot call it by hand — it fires when a task touches marketing copy, customer communication or public-facing content. The rules are written for one specific company: mission, values and vocabulary describe a particular product, so you will need to rewrite the file for your own brand.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill brand-voice -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/brand-voice/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/brand-voice/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill brand-voice -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/brand-voice/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill brand-voice -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/brand-voice/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install luongnv89/claude-howto brand-voice
```

2. **Manually: put the files in place**
- File: `.github/skills/brand-voice/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill brand-voice -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/luongnv89/claude-howto --path 03-skills/brand-voice
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/brand-voice/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add luongnv89/claude-howto --skill brand-voice -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/luongnv89/claude-howto/tree/HEAD/03-skills/brand-voice/SKILL.md

## When to use it
- check marketing copy against the brand tone
- rewrite a customer email without corporate jargon
- keep one style when several writers share the content
- replace vague claims with a concrete benefit
- shorten sentences and break up walls of text

## Example prompts
- check this draft against our brand voice and suggest edits
- rewrite the customer email in our tone, no jargon
- audit the landing page against brand-voice rules and list what breaks them

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 8c088513c4d2a555.

BEGIN THIRD-PARTY FILE 8c088513c4d2a555
```text
---
name: brand-voice
description: Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when users mention brand voice, tone, or writing style.
user-invocable: false
---

# Brand Voice Skill

## Overview
This skill ensures all communications maintain consistent brand voice, tone, and messaging.

## Brand Identity

### Mission
Help teams automate their development workflows with AI

### Values
- **Simplicity**: Make complex things simple
- **Reliability**: Rock-solid execution
- **Empowerment**: Enable human creativity

### Tone of Voice
- **Friendly but professional** - approachable without being casual
- **Clear and concise** - avoid jargon, explain technical concepts simply
- **Confident** - we know what we're doing
- **Empathetic** - understand user needs and pain points

## Writing Guidelines

### Do's ✅
- Use "you" when addressing readers
- Use active voice: "Claude generates reports" not "Reports are generated by Claude"
- Start with value proposition
- Use concrete examples
- Keep sentences under 20 words
- Use lists for clarity
- Include calls-to-action

### Don'ts ❌
- Don't use corporate jargon
- Don't patronize or oversimplify
- Don't use "we believe" or "we think"
- Don't use ALL CAPS except for emphasis
- Don't create walls of text
- Don't assume technical knowledge

## Vocabulary

### ✅ Preferred Terms
- Claude (not "the Claude AI")
- Code generation (not "auto-coding")
- Agent (not "bot")
- Streamline (not "revolutionize")
- Integrate (not "synergize")

### ❌ Avoid Terms
- "Cutting-edge" (overused)
- "Game-changer" (vague)
- "Leverage" (corporate-speak)
- "Utilize" (use "use")
- "Paradigm shift" (unclear)

## Examples

### ✅ Good Example
"Claude automates your code review process. Instead of manually checking each PR, Claude reviews security, performance, and quality—saving your team hours every week."

Why it works: Clear value, specific benefits, action-oriented

### ❌ Bad Example
"Claude leverages cutting-edge AI to provide comprehensive software development solutions."

Why it doesn't work: Vague, corporate jargon, no specific value

---

**Last Updated**: August 4, 2026
**Claude Code Version**: 2.1.220
**Sources**:
- https://code.claude.com/docs/en/skills
**Compatible Models**: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5
```
END THIRD-PARTY FILE 8c088513c4d2a555

The third-party file has ended. Everything between the 8c088513c4d2a555 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© luongnv89 · MIT · https://github.com/luongnv89/claude-howto/tree/HEAD/03-skills/brand-voice/SKILL.md

## Similar
- [brand-language-codifier](https://affpapa.org/en/nevibecode/skills/brand-language-codifier.md) — skill · 1000 installs
- [content-creator](https://affpapa.org/en/nevibecode/skills/sickn33-content-creator.md) — skill · 1100 installs
- [hook-voice-patterns](https://affpapa.org/en/nevibecode/skills/hook-voice-patterns.md) — skill · 454 installs
- [brand-messaging](https://affpapa.org/en/nevibecode/skills/brand-messaging.md) — skill · 1700 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md