Brand Voice Enforcer
Overview
This skill enforces brand voice consistency across all consumer-facing content — PDP copy, social posts, email campaigns, packaging copy, and customer service templates. It ingests a brand's voice framework, builds a scoring rubric, and rewrites non-conforming content while preserving factual accuracy and SEO value.
Brand voice is treated as a measurable system, not a subjective opinion. Every piece of content receives a quantified Voice Adherence Score (VAS) against the brand's defined personality dimensions.
When to Use
- Onboarding new copywriters or agencies who need guardrails.
- Auditing existing content libraries for voice drift after rebrands or acquisitions.
- Adapting content across channels (packaging → digital, US → international) while preserving voice.
- Reviewing AI-generated or user-submitted content before publication.
- Building or updating a brand voice scoring model for automated QA pipelines.
Required Inputs
| Input |
Description |
Example |
brand_voice_guide |
The complete brand voice document or structured summary |
PDF, markdown, or JSON |
voice_dimensions |
3-5 personality axes with definitions |
["Warm & Approachable", "Expert but Accessible", "Playfully Confident"] |
vocabulary_rules |
Preferred terms, banned words, and substitutions |
{ "preferred": {"utilize": "use"}, "banned": ["cheap", "chemical-free"] } |
content_samples |
3-5 exemplar pieces that embody the ideal voice |
URLs or text blocks |
input_content |
The content to be evaluated and rewritten |
Raw text or HTML |
channel |
Target channel for format-specific norms |
"Instagram caption", "PDP bullet", "email subject" |
audience_segment |
Primary audience persona |
"Millennial parents, health-conscious" |
Methodology
Step 1 — Voice Profile Construction
Parse the brand voice guide into a structured Voice DNA Model:
- Personality Dimensions: Map each dimension to a 1-5 scale with behavioral anchors.
- Example: Warmth — 1 (clinical/detached) → 5 (conversational/intimate).
- Sentence Patterns: Identify preferred syntax — short declarative vs. compound; active vs. passive; question leads vs. statement leads.
- Lexical Fingerprint: Build a preferred vocabulary set (200-500 words) and a banned vocabulary set from the guide and exemplar content.
- Punctuation & Formatting Style: Em dashes vs. parentheses, exclamation point frequency, emoji policy, capitalization rules.
- Persona Guardrails: Define what the brand is and is not (e.g., "expert but never condescending").
Step 2 — Content Analysis & Scoring
Evaluate input content against the Voice DNA Model using the Voice Adherence Scorecard:
| Dimension |
Weight |
Scoring Criteria |
| Tone Alignment |
25% |
Does emotional register match target dimensions? |
| Vocabulary Compliance |
25% |
Preferred terms used; banned terms absent; jargon level appropriate |
| Syntax Pattern Match |
20% |
Sentence length, structure, and rhythm match exemplars |
| Persona Consistency |
15% |
Content sounds like the defined brand persona throughout |
| Channel Fit |
15% |
Tone and format norms match the target channel |
Calculate a composite Voice Adherence Score (VAS) from 0-100:
- 90-100: Publication-ready. Minor polish only.
- 70-89: Acceptable with targeted edits. Flag specific deviations.
- 50-69: Significant rewrite needed. Multiple dimension failures.
- Below 50: Full rewrite. Content is off-brand.
Step 3 — Deviation Identification
For each deviation detected, produce a structured finding:
deviation:
location: "Bullet 3, sentence 2"
dimension: "Tone Alignment"
severity: "major" # minor | moderate | major
original: "This product eliminates germs using powerful chemicals."
issue: "Word 'chemicals' is banned; tone is clinical rather than warm."
suggestion: "This formula wipes out 99.9% of germs with plant-powered ingredients."
Step 4 — Guided Rewrite
- Preserve all factual claims, keywords, and regulatory language from the original.
- Apply voice transformations in priority order: banned word removal → tone adjustment → syntax alignment → persona tuning.
- Maintain or improve readability scores (never increase grade level by more than 1).
- Re-score the rewritten content to confirm VAS ≥ 85.
Step 5 — Cross-Channel Adaptation
When adapting across channels, apply channel-specific voice modulations:
| Channel |
Modulation |
| PDP (Amazon/Walmart) |
More functional, keyword-aware; caps-led bullets |
| Social (Instagram/TikTok) |
Shorter sentences, emoji-permitted, conversational hooks |
| Email |
Personalized, benefit-first subject lines, CTA-driven body |
| Packaging |
Concise, legal-reviewed, regulatory claim format |
| Customer Service |
Empathetic, solution-oriented, first-person plural ("we") |
Output Specification
output:
voice_adherence_score: float # 0-100 composite VAS
dimension_scores:
tone_alignment: float
vocabulary_compliance: float
syntax_pattern_match: float
persona_consistency: float
channel_fit: float
deviations: list[Deviation] # Structured deviation findings
rewritten_content: string # Voice-corrected content
rewrite_changelog: list[string] # Summary of changes made
confidence: float # Model confidence in rewrite quality
Analysis Framework
The Brand Voice Consistency Matrix evaluates voice across three layers:
- Surface Layer (vocabulary, punctuation, formatting) — easiest to enforce, most commonly violated.
- Structural Layer (sentence patterns, paragraph rhythm, information hierarchy) — requires syntactic analysis.
- Semantic Layer (emotional tone, persona expression, cultural resonance) — requires contextual understanding.
Enforcement priority: Surface → Structural → Semantic. Surface violations are auto-corrected; structural issues are flagged with suggestions; semantic misalignments require human review.
Examples
Brand Voice Profile: "Sunny Kitchen" — a natural food brand.
- Dimensions: Warm (5), Playful (4), Expert (3), Premium (2).
- Banned words: "artificial," "processed," "cheap," "stuff."
- Preferred: "wholesome," "real ingredients," "kitchen-crafted."
Input: "Our product is manufactured using all-natural processes and contains no artificial ingredients."
Analysis: VAS = 42. "Manufactured" is clinical (Warmth violation). "All-natural" is an FDA-flagged term. Passive voice mismatches playful dimension.
Rewrite: "We craft every jar in small batches with real, wholesome ingredients — nothing artificial, ever."
New VAS: 91.
Guidelines
- Never sacrifice regulatory accuracy for voice. Approved claims must remain verbatim even if they sound off-brand.
- Flag any rewrite that alters a factual claim for human review.
- When brand guides conflict with channel requirements (e.g., Amazon caps style vs. brand's lowercase preference), channel rules take precedence with a logged exception.
- Update the Voice DNA Model quarterly or after any brand refresh.
- Treat voice dimensions as a spectrum, not a binary — partial adherence is scored proportionally.
Validation Checklist
1---2name: brand-voice-enforcer3description: Analyze and rewrite content to strict brand voice guidelines, scoring adherence across tone, vocabulary, syntax patterns, and persona alignment for CPG and retail brands.4---56# Brand Voice Enforcer78## Overview910This skill enforces brand voice consistency across all consumer-facing content — PDP copy, social posts, email campaigns, packaging copy, and customer service templates. It ingests a brand's voice framework, builds a scoring rubric, and rewrites non-conforming content while preserving factual accuracy and SEO value.1112Brand voice is treated as a measurable system, not a subjective opinion. Every piece of content receives a quantified Voice Adherence Score (VAS) against the brand's defined personality dimensions.1314## When to Use1516- Onboarding new copywriters or agencies who need guardrails.17- Auditing existing content libraries for voice drift after rebrands or acquisitions.18- Adapting content across channels (packaging → digital, US → international) while preserving voice.19- Reviewing AI-generated or user-submitted content before publication.20- Building or updating a brand voice scoring model for automated QA pipelines.2122## Required Inputs2324| Input | Description | Example |25|---|---|---|26| `brand_voice_guide` | The complete brand voice document or structured summary | PDF, markdown, or JSON |27| `voice_dimensions` | 3-5 personality axes with definitions | `["Warm & Approachable", "Expert but Accessible", "Playfully Confident"]` |28| `vocabulary_rules` | Preferred terms, banned words, and substitutions | `{ "preferred": {"utilize": "use"}, "banned": ["cheap", "chemical-free"] }` |29| `content_samples` | 3-5 exemplar pieces that embody the ideal voice | URLs or text blocks |30| `input_content` | The content to be evaluated and rewritten | Raw text or HTML |31| `channel` | Target channel for format-specific norms | "Instagram caption", "PDP bullet", "email subject" |32| `audience_segment` | Primary audience persona | "Millennial parents, health-conscious" |3334## Methodology3536### Step 1 — Voice Profile Construction3738Parse the brand voice guide into a structured **Voice DNA Model**:39401. **Personality Dimensions**: Map each dimension to a 1-5 scale with behavioral anchors.41 - Example: *Warmth* — 1 (clinical/detached) → 5 (conversational/intimate).422. **Sentence Patterns**: Identify preferred syntax — short declarative vs. compound; active vs. passive; question leads vs. statement leads.433. **Lexical Fingerprint**: Build a preferred vocabulary set (200-500 words) and a banned vocabulary set from the guide and exemplar content.444. **Punctuation & Formatting Style**: Em dashes vs. parentheses, exclamation point frequency, emoji policy, capitalization rules.455. **Persona Guardrails**: Define what the brand *is* and *is not* (e.g., "expert but never condescending").4647### Step 2 — Content Analysis & Scoring4849Evaluate input content against the Voice DNA Model using the **Voice Adherence Scorecard**:5051| Dimension | Weight | Scoring Criteria |52|---|---|---|53| Tone Alignment | 25% | Does emotional register match target dimensions? |54| Vocabulary Compliance | 25% | Preferred terms used; banned terms absent; jargon level appropriate |55| Syntax Pattern Match | 20% | Sentence length, structure, and rhythm match exemplars |56| Persona Consistency | 15% | Content sounds like the defined brand persona throughout |57| Channel Fit | 15% | Tone and format norms match the target channel |5859Calculate a composite **Voice Adherence Score (VAS)** from 0-100:60- **90-100**: Publication-ready. Minor polish only.61- **70-89**: Acceptable with targeted edits. Flag specific deviations.62- **50-69**: Significant rewrite needed. Multiple dimension failures.63- **Below 50**: Full rewrite. Content is off-brand.6465### Step 3 — Deviation Identification6667For each deviation detected, produce a structured finding:6869```yaml70deviation:71 location: "Bullet 3, sentence 2"72 dimension: "Tone Alignment"73 severity: "major" # minor | moderate | major74 original: "This product eliminates germs using powerful chemicals."75 issue: "Word 'chemicals' is banned; tone is clinical rather than warm."76 suggestion: "This formula wipes out 99.9% of germs with plant-powered ingredients."77```7879### Step 4 — Guided Rewrite80811. Preserve all factual claims, keywords, and regulatory language from the original.822. Apply voice transformations in priority order: banned word removal → tone adjustment → syntax alignment → persona tuning.833. Maintain or improve readability scores (never increase grade level by more than 1).844. Re-score the rewritten content to confirm VAS ≥ 85.8586### Step 5 — Cross-Channel Adaptation8788When adapting across channels, apply channel-specific voice modulations:8990| Channel | Modulation |91|---|---|92| PDP (Amazon/Walmart) | More functional, keyword-aware; caps-led bullets |93| Social (Instagram/TikTok) | Shorter sentences, emoji-permitted, conversational hooks |94| Email | Personalized, benefit-first subject lines, CTA-driven body |95| Packaging | Concise, legal-reviewed, regulatory claim format |96| Customer Service | Empathetic, solution-oriented, first-person plural ("we") |9798## Output Specification99100```yaml101output:102 voice_adherence_score: float # 0-100 composite VAS103 dimension_scores:104 tone_alignment: float105 vocabulary_compliance: float106 syntax_pattern_match: float107 persona_consistency: float108 channel_fit: float109 deviations: list[Deviation] # Structured deviation findings110 rewritten_content: string # Voice-corrected content111 rewrite_changelog: list[string] # Summary of changes made112 confidence: float # Model confidence in rewrite quality113```114115## Analysis Framework116117The **Brand Voice Consistency Matrix** evaluates voice across three layers:1181191. **Surface Layer** (vocabulary, punctuation, formatting) — easiest to enforce, most commonly violated.1202. **Structural Layer** (sentence patterns, paragraph rhythm, information hierarchy) — requires syntactic analysis.1213. **Semantic Layer** (emotional tone, persona expression, cultural resonance) — requires contextual understanding.122123Enforcement priority: Surface → Structural → Semantic. Surface violations are auto-corrected; structural issues are flagged with suggestions; semantic misalignments require human review.124125## Examples126127**Brand Voice Profile**: "Sunny Kitchen" — a natural food brand.128- Dimensions: Warm (5), Playful (4), Expert (3), Premium (2).129- Banned words: "artificial," "processed," "cheap," "stuff."130- Preferred: "wholesome," "real ingredients," "kitchen-crafted."131132**Input**: "Our product is manufactured using all-natural processes and contains no artificial ingredients."133134**Analysis**: VAS = 42. "Manufactured" is clinical (Warmth violation). "All-natural" is an FDA-flagged term. Passive voice mismatches playful dimension.135136**Rewrite**: "We craft every jar in small batches with real, wholesome ingredients — nothing artificial, ever."137138**New VAS**: 91.139140## Guidelines141142- Never sacrifice regulatory accuracy for voice. Approved claims must remain verbatim even if they sound off-brand.143- Flag any rewrite that alters a factual claim for human review.144- When brand guides conflict with channel requirements (e.g., Amazon caps style vs. brand's lowercase preference), channel rules take precedence with a logged exception.145- Update the Voice DNA Model quarterly or after any brand refresh.146- Treat voice dimensions as a spectrum, not a binary — partial adherence is scored proportionally.147148## Validation Checklist149150- [ ] Voice DNA Model is built from the provided brand guide and exemplars.151- [ ] All five VAS dimensions are scored independently.152- [ ] Every deviation is logged with location, severity, and a concrete suggestion.153- [ ] Rewritten content scores ≥ 85 VAS.154- [ ] No factual claims, certifications, or regulatory language was altered.155- [ ] Banned vocabulary is fully removed.156- [ ] Readability grade level did not increase by more than 1.157- [ ] Channel-specific formatting rules are applied.158- [ ] Rewrite changelog is complete and auditable.159- [ ] Final output reviewed against brand "is / is not" persona guardrails.