К основному содержанию
скилл CX Codex

brand-voice · rampstackco — скилл для Claude Code: что делает и как установить

Скилл brand-voice помогает составить гайдлайн по тону и голосу бренда с правилами лексики, контекстными сдвигами и парными примерами текста.

MIT 367 установок ★ 1 107 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add rampstackco/claude-skills --skill brand-voice -a claude-code
Открыть на GitHub

Что делает brand-voice

Скилл раскладывает голос бренда по четырём уровням: базовые черты характера («уверенный, но не высокомерный»), адаптация тона под разные сценарии (онбординг, ошибки интерфейса, поддержка), словарь и грамматика, а также библиотека парных примеров.

На входе агенту нужны позиционирование, описание аудитории, от 5 до 10 образцов текущих текстов и от 3 до 5 референсных брендов. Проверка черновиков перед публикацией сюда не входит: для аудита готовых текстов по уже созданной системе нужен отдельный скилл editorial-qa.

Какие задачи решает

  • сформировать единый гайдлайн по тону коммуникаций бренда
  • зафиксировать сдвиги тональности для разных экранов и каналов
  • составить библиотеку парных примеров хорошего и плохого копирайтинга
  • определить правила лексики и допустимую терминологию

Примеры запросов агенту

  • Помоги составить brand voice для нашего SaaS-сервиса на основе этих пяти текстов
  • Проведи аудит существующих текстов и выдели ключевые черты нашего голоса бренда
  • Опиши сдвиги тональности для экранов ошибок, онбординга и раздела цен

Как установить brand-voice

1Через Skills CLI (Vercel)

npx skills add rampstackco/claude-skills --skill brand-voice -a claude-code

2Вручную: положить файлы

~/.claude/skills/brand-voice/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/brand-voice/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о brand-voice

Как установить brand-voice в Claude Code?

Выполните команду npx skills add rampstackco/claude-skills --skill brand-voice -a claude-code. Также файл скилла можно положить напрямую в ~/.claude/skills/brand-voice/SKILL.md.

Что делает brand-voice?

Он создаёт структурированный документ голоса и тона бренда: выявляет черты характера, формулирует правила лексики и собирает библиотеку парных примеров.

Когда этот скилл не подходит?

Он не пишет итоговый копирайтинг для страниц (для этого есть content-and-copy) и не проверяет отдельные готовые черновики перед релизом — для этого предназначен editorial-qa.

Исходный текст

SKILL.md · MIT
---
name: brand-voice
description: "Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples. Use this skill whenever the user wants to define how a brand sounds, write a voice and tone document, audit existing copy for voice consistency, train a team or AI assistant on brand voice, or refine the personality of brand writing. Triggers on brand voice, voice and tone, tone of voice, writing voice, brand personality, copy voice, voice document, voice guidelines, how should we write, voice training, voice audit. Also triggers when the user has copy that 'feels off' and the underlying issue is voice, even if not stated explicitly. On a voice consistency check, this skill owns defining and documenting the voice system; use `editorial-qa` when a specific draft needs checking against an existing system before it publishes."
category: brand
catalog_summary: "Voice attributes, tone shifts, vocabulary, paired-example library"
display_order: 4
---

# Brand Voice

Define how a brand sounds in writing. Document it in a way that anyone (writer, designer, founder, AI assistant) can apply it consistently.

This skill produces a standalone voice document that can either live in the brand style guide or feed into it.

---

## When to use

- Defining brand voice for the first time
- Auditing existing copy for voice consistency
- Training a team, freelancer, or AI assistant on the brand voice
- Refining a voice that exists but is inconsistent across applications
- Adapting voice when a brand evolves (new audience, new positioning)

## When NOT to use

- Writing specific copy (use `content-and-copy`)
- Brand visual identity work (use `brand-identity`)
- Documenting a complete brand system (use `brand-style-guide`, which incorporates voice)
- Initial brand exploration (use `brand-ideation`)

---

## Required inputs

- The brand and its positioning
- The audience and what they need to hear
- 5 to 10 examples of existing brand writing (if any)
- 3 to 5 reference brands whose voice resonates with where this brand should go
- Any voice attributes already specified in the brief

---

## The framework: 4 layers

Voice has four layers, stacked. Each layer constrains the one below it.

### Layer 1: Voice attributes

The constants. The personality traits that define how the brand sounds across every context.

Pick 3 to 5 attributes. Pair each with what it is NOT (the failure mode if overdone).

Common attribute pairings (NOT a menu - generate your own):

- Confident, not arrogant
- Direct, not blunt
- Warm, not saccharine
- Witty, not sarcastic
- Smart, not academic
- Honest, not harsh
- Playful, not silly
- Practical, not boring
- Bold, not loud
- Curious, not unfocused

The "not" half is what saves writers from overshooting. "Confident" alone produces swagger. "Confident, not arrogant" tells writers where the line is.

### Layer 2: Tone shifts

Voice is constant. Tone adapts to context.

Map the major contexts the brand writes in. For each, document how voice expresses differently.

Common contexts:

| Context | Tone shift |
|---|---|
| Onboarding | Warmer, more enthusiastic, slightly slower pace |
| Hero / marketing | Confident, signature voice fully on |
| Product copy / UX | Direct, helpful, brief |
| Error messages | Calm, matter-of-fact, no apology theater |
| Success states | Brief celebration, redirect to next action |
| Empty states | Helpful, slightly playful, suggest action |
| 404 / not found | Self-aware, light, points the way home |
| Account deletion / cancellation | Quiet, respectful, no jokes |
| Pricing | Direct, transparent, confidence-inspiring |
| Legal / TOS | Plain language version sits next to the legal version |
| Support / help center | Patient, thorough, no condescension |
| Crisis communication | Calm, factual, accountable |
| Product announcements | Excited but not breathless |
| Email subject lines | Specific, never click-bait |

Voice stays consistent across all of these. Tone is what shifts.

### Layer 3: Vocabulary and grammar

The granular dial settings.

**Vocabulary preferences:**

- Words and phrases the brand uses
- Words and phrases the brand avoids
- Words the brand has redefined (if any) - e.g., a SaaS product calling its features "huddles" instead of "meetings"
- Industry jargon: keep it (signals expertise) or strip it (signals approachability)
- Sentence-opening preferences (some brands lean on imperatives, some on questions, some on statements)

**Grammar and style:**

- Contractions (use them = casual, avoid them = formal)
- Sentence length default (short = punchy, medium = considered, long = literary)
- Punctuation marks favored or avoided (em dash is famously polarizing)
- Pronouns ("we" / "you" / "I")
- Capitalization style (title case, sentence case, all-lowercase deliberate)
- Number formatting (spell out under ten, or always digits)
- Oxford comma (use or skip)
- Active vs passive voice (most brands prefer active)

### Layer 4: Examples and patterns

Voice is taught through examples, not rules. Build a library.

For each major content type, show:

- Bad example (off-voice)
- Good example (on-voice)
- Brief note on what changed

Cover the content types listed in the paired examples library of [`references/voice-document-template.md`](references/voice-document-template.md). The template owns that list, so there is one list to maintain rather than two that drift apart.

The floor is 15 paired examples. One pair per type in the template clears it. Past 25 the library gets harder to scan than to use, so treat 25 as the practical ceiling, not a hard cap. This is the most-used part of the voice doc in practice.

---

## Workflow

1. **Pick the entry point.** [`references/voice-frameworks.md`](references/voice-frameworks.md) has a "Choosing a framework" section that decides this. A brand starting from zero begins with archetypes there, then dimensions, then attributes, and rejoins this workflow at step 2. Everything below assumes copy exists to audit.
2. **Audit existing copy** if it exists. Identify what is on-brand, what is off, what patterns recur.
3. **Layer 1: Voice attributes.** Generate 5 to 8 candidates with "we are X, not Y" framing. Pick 3 to 5.
4. **Layer 2: Tone shifts.** List 8 to 15 contexts the brand writes in. Note the tone shift for each.
5. **Layer 3: Vocabulary and grammar.** Define preferences. Skip default rules unless they actually distinguish the brand.
6. **Layer 4: Examples.** Build the paired-example library against the template's content-type list, to the floor stated in the Layer 4 section above.
7. **Stress-test.** Pick a fresh writing brief and apply the voice doc. Score the result with the stress test in [`references/voice-frameworks.md`](references/voice-frameworks.md): 1 to 5 against each attribute, and anything scoring below 3 on any attribute is off-voice. Below 3 means the doc is incomplete, not that the copy needs another pass.
8. **Document.** Use the template in [`references/voice-document-template.md`](references/voice-document-template.md).
9. **Distribute.** Voice docs only work if they get used. Make the doc easy to reference inline (link to it from CMS templates, brief templates, AI assistant prompts).

---

## Failure patterns

- **Generic attributes ("friendly, professional, approachable").** Every brand says this. Means nothing. Pick attributes that genuinely distinguish.
- **No "we are NOT" pairings.** Without the rejection, attributes drift toward extremes.
- **Voice doc with no examples.** Rules without examples cannot be applied.
- **Examples that are obviously bad and obviously good.** Real voice work shows nuanced shifts, not cartoonish before/after.
- **Skipping tone shifts.** Treating voice as one-size-fits-all leads to a brand that sounds wrong in error states or legal contexts.
- **Documenting aspirational voice.** If the brand does not actually sound this way today and has no plan to shift, the doc is fiction.
- **Voice without distribution.** A perfect doc that no one references is worth nothing.

---

## Output format

Default output is a markdown document at `voice.md` in the brand folder. Sections:

1. Voice attributes (with we-are-not pairings)
2. Tone shifts by context
3. Vocabulary preferences
4. Grammar and style rules
5. Paired examples library (the most-used section)
6. Anti-patterns (specific phrases or constructions to avoid)
7. References (the brands and writers we are inspired by)

This doc can stand alone or feed into `brand-style-guide`.

---

## Reference files

- [`references/voice-document-template.md`](references/voice-document-template.md) - Fillable template.
- [`references/voice-frameworks.md`](references/voice-frameworks.md) - Detailed walkthrough of the Nielsen Norman 4 dimensions, Jung archetypes, and the "we are X not Y" approach.

© rampstackco · MIT · rampstackco/claude-skills

Похожие скиллы

Все скиллы по теме «Маркетинг и контент» →

Сначала — brand-voice от других авторов.

brand-voice affaan-m Скилл brand-voice для Claude Code извлекает авторский стиль из реальных текстов и оформляет профиль для генерации контента без шаблонных фраз. Используйте его для постов, рассылок и документации. CX Codex +1 6 800установок brand-voice arnabbagxd Скилл brand-voice на Claude Code составляет гайд по голосу бренда и правилам копирайтинга. Задаёт единый тон текста для сайта, рассылок, соцсетей и интерфейса. CX Codex +1 2 200установок brand-voice luongnv89 Скилл brand-voice для Claude Code проверяет текст на соответствие голосу бренда: тону, словарю и правилам письма. Проверяет маркетинговые материалы, документацию и общение с клиентами. CX Codex +1 ★ 47 494звёзд репо brand-voice luongnv89 Скилл brand-voice держит тексты в одном тоне: маркетинг, письма клиентам, публичные страницы. Полезен, когда над контентом работает несколько человек. CX Codex +1 ★ 47 494звёзд репо brand-voice James Dickerson (@boringmarketer) Скилл brand-voice для Claude Code извлекает или собирает профиль голоса бренда по реальным текстам. Он также проверяет свежие публикации на отклонения от сохранённого профиля. CX Codex +1 ★ 778звёзд репо copywriting-tone-of-voice-creator samber Скилл copywriting-tone-of-voice-creator создаёт гайд по тональности бренда TONE.md или адаптирует его под новые каналы. Пригодится при запуске контент-фабрики или обновлении правил общения с аудиторией. CX Codex +1 5 800установок Brand Guidelines Generator claude-office-skills Скилл Brand Guidelines Generator формирует регламенты по стилю бренда, правилам типографики и цветовым палитрам. Пригодится маркетологам и разработчикам для фиксации визуальных стандартов проекта. CX Codex +1 4 900установок brand-voice-enforcement официальный anthropics Скилл brand-voice-enforcement автоматически применяет гайдлайны бренда к любому контенту: письмам, постам, предложениям. Загружает ваши правила, адаптирует тон под аудиторию и объясняет, как работает бренд. CX Codex +1 3 900установок brand-review официальный anthropics Скилл brand-review проверяет маркетинг-текст, копирайт и контент против гайда вашего бренда, стиля и принципов. Находит отклонения по уровню серьёзности и предлагает исправления. CX Codex +1 3 400установок brand-messaging arnabbagxd Скилл brand-messaging для Claude Code строит иерархию брендового месседжинга: от корневого сообщения и ценностного предложения до слоганов и доказательных точек для сегментов аудитории. CX Codex +1 2 000установок brand-voice-analyzer OneWave-AI Скилл brand-voice-analyzer разбирает тексты компании, формирует гайдлайн по тону бренда и проверяет новые статьи на соответствие ему. CX Codex +1 281установок

Из того же набора102

Весь набор →
brand-ideation Скилл brand-ideation для ранней стадии бренда: генерирует территории позиционирования, варианты названий, настроения и нарративы, а потом помогает свести всё к одному направлению. CX Codex +1 388установок seo-aeo-geo Скилл seo-aeo-geo для оптимизации контента и структуры сайта под ИИ-поиск: цитирование в ответах языковых моделей, llms.txt, извлекаемая разметка. CX Codex +1 381установок email-deliverability Скилл email-deliverability разбирает доставляемость писем: настраивает SPF, DKIM и DMARC, следит за репутацией отправителя и подсказывает, почему письма падают в спам. CX Codex +1 372установок design-system Скилл design-system для Claude Code и других платформ: собирает или проверяет дизайн-систему — токены, компоненты, именование, контрибуцию и документацию. Держит стиль продуктов согласованным. CX Codex +1 369установок brand-discovery Скилл brand-discovery собирает данные об аудитории, конкурентах и категории, затем предлагает возможные направления позиционирования. Пригодится в начале проекта, до брифа и творческой концепции. CX Codex +1 366установок accessibility-audit Скилл accessibility-audit проводит аудит доступности интерфейса по стандарту WCAG 2.1 AA и формирует план исправления ошибок. Пригодится перед релизом и при подготовке к проверкам ADA или Section 508. CX Codex +1 364установок information-architecture Скилл information-architecture проектирует структуру сайта или продукта: карту страниц, навигацию, URL, типы контента и таксономию. Нужен при создании и перестройке IA. CX Codex +1 354установок creative-brief Скилл creative-brief для Claude Code превращает смутную идею в конкретный брифинг. Задаёт вопросы, чтобы выровнять команду и зафиксировать требования до первой строки кода. CX Codex +1 354установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой