Analyze and rewrite content to strict brand voice guidelines
Brand voice enforcer

Analyze and rewrite content to strict brand voice guidelines, scoring adherence across tone, vocabulary, syntax patterns, and persona alignment for CPG and retail brands.
---
name: Brand Voice Enforcer
description: Analyze and rewrite content to strict brand voice guidelines, scoring adherence across tone, vocabulary, syntax patterns, and persona alignment for CPG and retail brands.
metadata:
display_name: "Brand Voice Enforcer"
short_description: "Enforce brand voice consistency across all content types"
default_prompt: "Score my brand voice enforcer and explain what to improve"
version: "1.0.1"
tags:
- cpg-retail
icon_path: "assets/icon.png"
---
# Brand Voice Enforcer
## Overview
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.
Manual install (npx, ZIP)
npx skills add writer/skills --skill Brand Voice Enforcer -g -a claude-codenpx degit writer/skills/skills/content-brand/brand-voice-enforcer#main ~/.claude/skills/brand-voice-enforcerConnects with Agent Alley MCP · agentalley.io/mcp
Files included
SKILL.md8.3 KB
Read SKILL.md here
Show the full text169 lines
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 |
| 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
- Voice DNA Model is built from the provided brand guide and exemplars.
- All five VAS dimensions are scored independently.
- Every deviation is logged with location, severity, and a concrete suggestion.
- Rewritten content scores ≥ 85 VAS.
- No factual claims, certifications, or regulatory language was altered.
- Banned vocabulary is fully removed.
- Readability grade level did not increase by more than 1.
- Channel-specific formatting rules are applied.
- Rewrite changelog is complete and auditable.
- Final output reviewed against brand "is / is not" persona guardrails.
| 1 | |
| 2 | name Brand Voice Enforcer |
| 3 | description 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 | |
| 5 | metadata |
| 6 | display_name "Brand Voice Enforcer" |
| 7 | short_description "Enforce brand voice consistency across all content types" |
| 8 | default_prompt "Score my brand voice enforcer and explain what to improve" |
| 9 | version "1.0.1" |
| 10 | tags |
| 11 | - cpg-retail |
| 12 | icon_path "assets/icon.png" |
| 13 | |
| 14 | |
| 15 | # Brand Voice Enforcer |
| 16 | |
| 17 | ## Overview |
| 18 | |
| 19 | 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. |
| 20 | |
| 21 | 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. |
| 22 | |
| 23 | ## When to Use |
| 24 | |
| 25 | Onboarding new copywriters or agencies who need guardrails. |
| 26 | Auditing existing content libraries for voice drift after rebrands or acquisitions. |
| 27 | Adapting content across channels (packaging → digital, US → international) while preserving voice. |
| 28 | Reviewing AI-generated or user-submitted content before publication. |
| 29 | Building or updating a brand voice scoring model for automated QA pipelines. |
| 30 | |
| 31 | ## Required Inputs |
| 32 | |
| 33 | | Input | Description | Example | |
| 34 | |---|---|---| |
| 35 | | `brand_voice_guide` | The complete brand voice document or structured summary | PDF, markdown, or JSON | |
| 36 | | `voice_dimensions` | 3-5 personality axes with definitions | `["Warm & Approachable", "Expert but Accessible", "Playfully Confident"]` | |
| 37 | | `vocabulary_rules` | Preferred terms, banned words, and substitutions | `{ "preferred": {"utilize": "use"}, "banned": ["cheap", "chemical-free"] }` | |
| 38 | | `content_samples` | 3-5 exemplar pieces that embody the ideal voice | URLs or text blocks | |
| 39 | | `input_content` | The content to be evaluated and rewritten | Raw text or HTML | |
| 40 | | `channel` | Target channel for format-specific norms | "Instagram caption", "PDP bullet", "email subject" | |
| 41 | | `audience_segment` | Primary audience persona | "Millennial parents, health-conscious" | |
| 42 | |
| 43 | ## Methodology |
| 44 | |
| 45 | ### Step 1 — Voice Profile Construction |
| 46 | |
| 47 | Parse the brand voice guide into a structured **Voice DNA Model**: |
| 48 | |
| 49 | **Personality Dimensions**: Map each dimension to a 1-5 scale with behavioral anchors. |
| 50 | Example: *Warmth* — 1 (clinical/detached) → 5 (conversational/intimate). |
| 51 | **Sentence Patterns**: Identify preferred syntax — short declarative vs. compound; active vs. passive; question leads vs. statement leads. |
| 52 | **Lexical Fingerprint**: Build a preferred vocabulary set (200-500 words) and a banned vocabulary set from the guide and exemplar content. |
| 53 | **Punctuation & Formatting Style**: Em dashes vs. parentheses, exclamation point frequency, emoji policy, capitalization rules. |
| 54 | **Persona Guardrails**: Define what the brand *is* and *is not* (e.g., "expert but never condescending"). |
| 55 | |
| 56 | ### Step 2 — Content Analysis & Scoring |
| 57 | |
| 58 | Evaluate input content against the Voice DNA Model using the **Voice Adherence Scorecard**: |
| 59 | |
| 60 | | Dimension | Weight | Scoring Criteria | |
| 61 | |---|---|---| |
| 62 | | Tone Alignment | 25% | Does emotional register match target dimensions? | |
| 63 | | Vocabulary Compliance | 25% | Preferred terms used; banned terms absent; jargon level appropriate | |
| 64 | | Syntax Pattern Match | 20% | Sentence length, structure, and rhythm match exemplars | |
| 65 | | Persona Consistency | 15% | Content sounds like the defined brand persona throughout | |
| 66 | | Channel Fit | 15% | Tone and format norms match the target channel | |
| 67 | |
| 68 | Calculate a composite **Voice Adherence Score (VAS)** from 0-100: |
| 69 | **90-100**: Publication-ready. Minor polish only. |
| 70 | **70-89**: Acceptable with targeted edits. Flag specific deviations. |
| 71 | **50-69**: Significant rewrite needed. Multiple dimension failures. |
| 72 | **Below 50**: Full rewrite. Content is off-brand. |
| 73 | |
| 74 | ### Step 3 — Deviation Identification |
| 75 | |
| 76 | For each deviation detected, produce a structured finding: |
| 77 | |
| 78 | |
| 79 | deviation: |
| 80 | location: "Bullet 3, sentence 2" |
| 81 | dimension: "Tone Alignment" |
| 82 | severity: "major" # minor | moderate | major |
| 83 | original: "This product eliminates germs using powerful chemicals." |
| 84 | issue: "Word 'chemicals' is banned; tone is clinical rather than warm." |
| 85 | suggestion: "This formula wipes out 99.9% of germs with plant-powered ingredients." |
| 86 | |
| 87 | |
| 88 | ### Step 4 — Guided Rewrite |
| 89 | |
| 90 | Preserve all factual claims, keywords, and regulatory language from the original. |
| 91 | Apply voice transformations in priority order: banned word removal → tone adjustment → syntax alignment → persona tuning. |
| 92 | Maintain or improve readability scores (never increase grade level by more than 1). |
| 93 | Re-score the rewritten content to confirm VAS ≥ 85. |
| 94 | |
| 95 | ### Step 5 — Cross-Channel Adaptation |
| 96 | |
| 97 | When adapting across channels, apply channel-specific voice modulations: |
| 98 | |
| 99 | | Channel | Modulation | |
| 100 | |---|---| |
| 101 | | PDP (Amazon/Walmart) | More functional, keyword-aware; caps-led bullets | |
| 102 | | Social (Instagram/TikTok) | Shorter sentences, emoji-permitted, conversational hooks | |
| 103 | | Email | Personalized, benefit-first subject lines, CTA-driven body | |
| 104 | | Packaging | Concise, legal-reviewed, regulatory claim format | |
| 105 | | Customer Service | Empathetic, solution-oriented, first-person plural ("we") | |
| 106 | |
| 107 | ## Output Specification |
| 108 | |
| 109 | |
| 110 | output: |
| 111 | voice_adherence_score: float # 0-100 composite VAS |
| 112 | dimension_scores: |
| 113 | tone_alignment: float |
| 114 | vocabulary_compliance: float |
| 115 | syntax_pattern_match: float |
| 116 | persona_consistency: float |
| 117 | channel_fit: float |
| 118 | deviations: list[Deviation] # Structured deviation findings |
| 119 | rewritten_content: string # Voice-corrected content |
| 120 | rewrite_changelog: list[string] # Summary of changes made |
| 121 | confidence: float # Model confidence in rewrite quality |
| 122 | |
| 123 | |
| 124 | ## Analysis Framework |
| 125 | |
| 126 | The **Brand Voice Consistency Matrix** evaluates voice across three layers: |
| 127 | |
| 128 | **Surface Layer** (vocabulary, punctuation, formatting) — easiest to enforce, most commonly violated. |
| 129 | **Structural Layer** (sentence patterns, paragraph rhythm, information hierarchy) — requires syntactic analysis. |
| 130 | **Semantic Layer** (emotional tone, persona expression, cultural resonance) — requires contextual understanding. |
| 131 | |
| 132 | Enforcement priority: Surface → Structural → Semantic. Surface violations are auto-corrected; structural issues are flagged with suggestions; semantic misalignments require human review. |
| 133 | |
| 134 | ## Examples |
| 135 | |
| 136 | **Brand Voice Profile**: "Sunny Kitchen" — a natural food brand. |
| 137 | Dimensions: Warm (5), Playful (4), Expert (3), Premium (2). |
| 138 | Banned words: "artificial," "processed," "cheap," "stuff." |
| 139 | Preferred: "wholesome," "real ingredients," "kitchen-crafted." |
| 140 | |
| 141 | **Input**: "Our product is manufactured using all-natural processes and contains no artificial ingredients." |
| 142 | |
| 143 | **Analysis**: VAS = 42. "Manufactured" is clinical (Warmth violation). "All-natural" is an FDA-flagged term. Passive voice mismatches playful dimension. |
| 144 | |
| 145 | **Rewrite**: "We craft every jar in small batches with real, wholesome ingredients — nothing artificial, ever." |
| 146 | |
| 147 | **New VAS**: 91. |
| 148 | |
| 149 | ## Guidelines |
| 150 | |
| 151 | Never sacrifice regulatory accuracy for voice. Approved claims must remain verbatim even if they sound off-brand. |
| 152 | Flag any rewrite that alters a factual claim for human review. |
| 153 | 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. |
| 154 | Update the Voice DNA Model quarterly or after any brand refresh. |
| 155 | Treat voice dimensions as a spectrum, not a binary — partial adherence is scored proportionally. |
| 156 | |
| 157 | ## Validation Checklist |
| 158 | |
| 159 | [ ] Voice DNA Model is built from the provided brand guide and exemplars. |
| 160 | [ ] All five VAS dimensions are scored independently. |
| 161 | [ ] Every deviation is logged with location, severity, and a concrete suggestion. |
| 162 | [ ] Rewritten content scores ≥ 85 VAS. |
| 163 | [ ] No factual claims, certifications, or regulatory language was altered. |
| 164 | [ ] Banned vocabulary is fully removed. |
| 165 | [ ] Readability grade level did not increase by more than 1. |
| 166 | [ ] Channel-specific formatting rules are applied. |
| 167 | [ ] Rewrite changelog is complete and auditable. |
| 168 | [ ] Final output reviewed against brand "is / is not" persona guardrails. |
| 169 |
Details
- License
- Apache-2.0
- Stars on the repo
- ★ 7
- Checked
- Source
- writer/skills ↗
- Creator
- writer · 5 listings
Similar skills
See all →
SkillBrand voice, visual identity, messaging frameworks
SkillMap what our buyers believeAudience belief mapper
SkillPaste in your website and marketing copyBrand Voice Analysis and Guidelines Generation
SkillYour brand designerFounder brand
SkillAdapt one core brand voice coherently across every adBrand voice ad adaptation
SkillCreate or update their product marketing context documentMore from writer
SkillGenerates systematic ad creative variants across copyAd creative variant generator
SkillScores and ranks influencers for brand partnership fitInfluencer fit scoring
SkillSimulate CPG pricing strategies including cost pass-throughPricing strategy simulator
SkillGenerate and optimize SEO-richProduct description optimizer