Brand Review
If you see unfamiliar placeholders or need to check which tools are connected, see CONNECTORS.md.
Review marketing content against brand voice, style guidelines, and messaging standards. Flag deviations and provide specific improvement suggestions.
Trigger
User runs /brand-review or asks to review, check, or audit content against brand guidelines.
Inputs
Content to review — accept content in any of these forms:
- Pasted directly into the conversation
- A file path or ~~knowledge base reference (e.g. Notion page, shared doc)
- A URL to a published page
- Multiple pieces for batch review
Brand guidelines source (determined automatically):
- If a brand style guide is configured in local settings, use it automatically
- If not configured, ask: "Do you have a brand style guide or voice guidelines I should review against? You can paste them, share a file, or describe your brand voice. Otherwise, I'll do a general review for clarity, consistency, and professionalism."
Review Process
With Brand Guidelines Configured
Evaluate the content against each of these dimensions:
Voice and Tone
- Does the content match the defined brand voice attributes?
- Is the tone appropriate for the content type and audience?
- Are there shifts in voice that feel inconsistent?
- Flag specific sentences or phrases that deviate with an explanation of why
Terminology and Language
- Are preferred brand terms used correctly?
- Are any "avoid" terms or phrases present?
- Is jargon level appropriate for the target audience?
- Are product names, feature names, and branded terms used correctly (capitalization, formatting)?
Messaging Pillars
- Does the content align with defined messaging pillars or value propositions?
- Are claims consistent with approved messaging?
- Is the content reinforcing or contradicting brand positioning?
Style Guide Compliance
- Grammar and punctuation per style guide (e.g., Oxford comma, title case vs. sentence case)
- Formatting conventions (headers, lists, emphasis)
- Number formatting, date formatting
- Acronym usage (defined on first use?)
Without Brand Guidelines (Generic Review)
Evaluate the content for:
Clarity
- Is the main message clear within the first paragraph?
- Are sentences concise and easy to understand?
- Is the structure logical and easy to follow?
- Are there ambiguous statements or unclear references?
Consistency
- Is the tone consistent throughout?
- Are terms used consistently (no switching between synonyms for the same concept)?
- Is formatting consistent (headers, lists, capitalization)?
Professionalism
- Is the content free of typos, grammatical errors, and awkward phrasing?
- Is the tone appropriate for the intended audience?
- Are claims supported or substantiated?
Legal and Compliance Flags (Always Checked)
Regardless of whether brand guidelines are configured, flag:
- Unsubstantiated claims — superlatives ("best", "fastest", "only") without evidence or qualification
- Missing disclaimers — financial claims, health claims, or guarantees that may need legal disclaimers
- Comparative claims — comparisons to competitors that could be challenged
- Regulatory language — content that may need compliance review (financial services, healthcare, etc.)
- Testimonial issues — quotes or endorsements without attribution or disclosure
- Copyright concerns — content that appears to be closely paraphrased from other sources
Brand Voice Reference
Use these frameworks to evaluate content against brand standards or to help the user document their brand voice.
Brand Voice Documentation Framework
A complete brand voice document should cover these areas:
- Brand Personality — Define the brand as if it were a person. Example: "If our brand were a person, they would be a knowledgeable colleague who explains complex things simply, celebrates your wins genuinely, and never talks down to you."
- Voice Attributes — 3-5 attributes that define how the brand communicates, each defined with what it means in practice, what it does NOT mean (to prevent misinterpretation), and an example.
- Audience Awareness — Who the brand is speaking to (primary and secondary), what they care about, their level of expertise, and how they expect to be addressed.
- Core Messaging Pillars — 3-5 key themes the brand consistently communicates, the hierarchy of these messages, and how each pillar connects to audience needs.
- Tone Spectrum — How the voice adapts across contexts while remaining recognizably the same brand.
- Style Rules — Specific grammar, formatting, and language rules.
- Terminology — Preferred and avoided terms.
Voice Attribute Spectrums
When defining or evaluating brand voice, position attributes on a spectrum:
| Spectrum |
One End |
Other End |
| Formality |
Formal, institutional |
Casual, conversational |
| Authority |
Expert, authoritative |
Peer-level, collaborative |
| Emotion |
Warm, empathetic |
Direct, matter-of-fact |
| Complexity |
Technical, precise |
Simple, accessible |
| Energy |
Bold, energetic |
Calm, measured |
| Humor |
Playful, witty |
Serious, earnest |
| Innovation |
Cutting-edge, forward-looking |
Established, proven |
For each chosen attribute, document it in this format:
[Attribute name]
- We are: [what this means in practice]
- We are not: [common misinterpretation to avoid]
- This sounds like: [example sentence demonstrating the attribute]
- This does NOT sound like: [example sentence violating the attribute]
Example:
Approachable
- We are: friendly, clear, jargon-free, welcoming to beginners and experts alike
- We are not: dumbed-down, overly casual, or lacking substance
- This sounds like: "Here's how to get started — it takes about five minutes."
- This does NOT sound like: "Yo! This is super easy, even a noob can do it lol."
Tone Adaptation Across Channels and Contexts
The brand voice stays consistent, but tone adapts to context. Tone is the emotional inflection applied to the voice.
Tone by Channel
| Channel |
Tone Adaptation |
Example |
| Blog |
Informative, conversational, educational |
"Let's walk through how this works and why it matters for your team." |
| Social media (LinkedIn) |
Professional, thought-provoking, concise |
"Three things we learned from running 50 campaigns this quarter." |
| Social media (Twitter/X) |
Punchy, direct, sometimes witty |
"Your landing page has 3 seconds. Make them count." |
| Email marketing |
Personal, helpful, action-oriented |
"We put together something we think you'll find useful." |
| Sales collateral |
Confident, benefit-driven, specific |
"Teams using our platform reduce reporting time by 40%." |
| Support/Help docs |
Clear, patient, step-by-step |
"If you see this error, here's how to fix it." |
| Press release |
Formal, factual, newsworthy |
"The company today announced the launch of..." |
| Error messages |
Empathetic, helpful, blame-free |
"Something went wrong on our end. We're looking into it." |
Tone by Situation
| Situation |
Tone Adaptation |
| Product launch |
Excited, confident, forward-looking |
| Incident or outage |
Transparent, empathetic, accountable |
| Customer success story |
Celebratory, specific, crediting the customer |
| Thought leadership |
Authoritative, nuanced, evidence-based |
| Onboarding |
Welcoming, encouraging, clear |
| Bad news (price increase, deprecation) |
Honest, respectful, solution-oriented |
| Competitive comparison |
Confident but fair, fact-based, not disparaging |
Tone Adaptation Rule
The voice attributes remain fixed. Tone dials them up or down based on context. For example, if a brand is "bold and warm":
- In a product launch, dial up boldness
- In an incident response, dial up warmth
- Neither attribute disappears; the balance shifts
Style Guide Enforcement
Grammar and Mechanics
Document and enforce these choices consistently:
| Rule |
Options |
Example |
| Oxford comma |
Yes / No |
"fast, reliable, and secure" vs. "fast, reliable and secure" |
| Sentence case vs. title case (headings) |
Sentence / Title |
"How to get started" vs. "How to Get Started" |
| Contractions |
Use / Avoid |
"we're" vs. "we are" |
| Em dash spacing |
No spaces / Spaces |
"this—and more" vs. "this — and more" |
| Numbers |
Spell out 1-9, numerals 10+ / Always numerals |
"five features" vs. "5 features" |
| Percent |
% / percent |
"50%" vs. "50 percent" |
| Date format |
Month DD, YYYY / DD/MM/YYYY / etc. |
"January 15, 2025" |
| Time format |
12-hour / 24-hour |
"3:00 PM" vs. "15:00" |
| Lists |
Periods / No periods on fragments |
"Set up your account." vs. "Set up your account" |
Formatting Conventions
- Heading hierarchy (when to use H1, H2, H3)
- Bold and italic usage (bold for emphasis, italic for titles/terms)
- Link text (descriptive vs. "click here" — always descriptive)
- Image alt text requirements
- Code formatting (for technical brands)
- Callout or highlight box usage
Punctuation and Emphasis
- Exclamation mark policy (limited use, never more than one)
- Ellipsis usage (avoid in most professional contexts)
- ALL CAPS policy (avoid; use bold for emphasis instead)
- Emoji usage by channel (professional channels: minimal or none; social: where appropriate)
Terminology Management
Preferred Terms
Maintain a list of preferred terms and their incorrect alternatives:
| Use This |
Not This |
Notes |
| sign up (verb) |
signup (verb) |
"signup" is the noun form |
| log in (verb) |
login (verb) |
"login" is the noun/adjective form |
| set up (verb) |
setup (verb) |
"setup" is the noun/adjective form |
| email |
e-mail |
No hyphen |
| website |
web site |
One word |
| data is (singular) |
data are |
Unless the publication requires plural |
Product and Feature Names
- Official capitalization for product names
- When to use the full product name vs. shorthand
- Whether to use "the" before product names
- How to handle versioning in copy
- Trademark and registration symbols (when required and when to omit)
Inclusive Language
- Use gender-neutral language (they/them for unknown individuals)
- Avoid ableist language ("crazy", "blind spot", "lame")
- Use person-first language where appropriate
- Avoid culturally specific idioms that may not translate
- Use "simple" or "straightforward" instead of "easy" (what is easy varies by person)
Industry Jargon Management
- Define which technical terms the audience understands without explanation
- List jargon that should always be defined or replaced with plain language
- Specify which acronyms need to be spelled out on first use
- Audience-specific glossary for terms that mean different things to different readers
Competitor and Category Terms
- How to refer to your product category (use your preferred framing)
- How to refer to competitors (by name or generically)
- Terms competitors have coined that you should avoid (to prevent reinforcing their positioning)
- Your preferred differentiation language
Output Format
Present the review as:
Summary
- Overall assessment: how well the content aligns with brand standards (or general quality)
- 1-2 sentence summary of the biggest strengths
- 1-2 sentence summary of the most important improvements
Detailed Findings
For each issue found, provide:
| Issue |
Location |
Severity |
Suggestion |
Where severity is:
- High — contradicts brand voice, contains compliance risk, or significantly undermines messaging
- Medium — inconsistent with guidelines but not damaging
- Low — minor style or preference issue
Revised Sections
For the top 3-5 highest-severity issues, provide a before/after showing the original text and a suggested revision.
Legal/Compliance Flags
List any legal or compliance concerns separately with recommended actions.
After Review
Ask: "Would you like me to:
- Revise the full content with these suggestions applied?
- Focus on fixing just the high-severity issues?
- Review additional content against the same guidelines?
- Help you document your brand voice for future reviews?"
1---2name: mkt-brand-review3description: Review content against your brand voice, style guide, and messaging pillars, flagging deviations by severity with specific before/after fixes. Use when checking a draft before it ships, when auditing copy for voice consistency and terminology, or when screening for unsubstantiated claims, missing disclaimers, and other legal flags.4---56# Brand Review78> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../../CONNECTORS.md).910Review marketing content against brand voice, style guidelines, and messaging standards. Flag deviations and provide specific improvement suggestions.1112## Trigger1314User runs `/brand-review` or asks to review, check, or audit content against brand guidelines.1516## Inputs17181. **Content to review** — accept content in any of these forms:19 - Pasted directly into the conversation20 - A file path or ~~knowledge base reference (e.g. Notion page, shared doc)21 - A URL to a published page22 - Multiple pieces for batch review23242. **Brand guidelines source** (determined automatically):25 - If a brand style guide is configured in local settings, use it automatically26 - If not configured, ask: "Do you have a brand style guide or voice guidelines I should review against? You can paste them, share a file, or describe your brand voice. Otherwise, I'll do a general review for clarity, consistency, and professionalism."2728## Review Process2930### With Brand Guidelines Configured3132Evaluate the content against each of these dimensions:3334#### Voice and Tone35- Does the content match the defined brand voice attributes?36- Is the tone appropriate for the content type and audience?37- Are there shifts in voice that feel inconsistent?38- Flag specific sentences or phrases that deviate with an explanation of why3940#### Terminology and Language41- Are preferred brand terms used correctly?42- Are any "avoid" terms or phrases present?43- Is jargon level appropriate for the target audience?44- Are product names, feature names, and branded terms used correctly (capitalization, formatting)?4546#### Messaging Pillars47- Does the content align with defined messaging pillars or value propositions?48- Are claims consistent with approved messaging?49- Is the content reinforcing or contradicting brand positioning?5051#### Style Guide Compliance52- Grammar and punctuation per style guide (e.g., Oxford comma, title case vs. sentence case)53- Formatting conventions (headers, lists, emphasis)54- Number formatting, date formatting55- Acronym usage (defined on first use?)5657### Without Brand Guidelines (Generic Review)5859Evaluate the content for:6061#### Clarity62- Is the main message clear within the first paragraph?63- Are sentences concise and easy to understand?64- Is the structure logical and easy to follow?65- Are there ambiguous statements or unclear references?6667#### Consistency68- Is the tone consistent throughout?69- Are terms used consistently (no switching between synonyms for the same concept)?70- Is formatting consistent (headers, lists, capitalization)?7172#### Professionalism73- Is the content free of typos, grammatical errors, and awkward phrasing?74- Is the tone appropriate for the intended audience?75- Are claims supported or substantiated?7677### Legal and Compliance Flags (Always Checked)7879Regardless of whether brand guidelines are configured, flag:80- **Unsubstantiated claims** — superlatives ("best", "fastest", "only") without evidence or qualification81- **Missing disclaimers** — financial claims, health claims, or guarantees that may need legal disclaimers82- **Comparative claims** — comparisons to competitors that could be challenged83- **Regulatory language** — content that may need compliance review (financial services, healthcare, etc.)84- **Testimonial issues** — quotes or endorsements without attribution or disclosure85- **Copyright concerns** — content that appears to be closely paraphrased from other sources8687## Brand Voice Reference8889Use these frameworks to evaluate content against brand standards or to help the user document their brand voice.9091### Brand Voice Documentation Framework9293A complete brand voice document should cover these areas:94951. **Brand Personality** — Define the brand as if it were a person. Example: "If our brand were a person, they would be a knowledgeable colleague who explains complex things simply, celebrates your wins genuinely, and never talks down to you."962. **Voice Attributes** — 3-5 attributes that define how the brand communicates, each defined with what it means in practice, what it does NOT mean (to prevent misinterpretation), and an example.973. **Audience Awareness** — Who the brand is speaking to (primary and secondary), what they care about, their level of expertise, and how they expect to be addressed.984. **Core Messaging Pillars** — 3-5 key themes the brand consistently communicates, the hierarchy of these messages, and how each pillar connects to audience needs.995. **Tone Spectrum** — How the voice adapts across contexts while remaining recognizably the same brand.1006. **Style Rules** — Specific grammar, formatting, and language rules.1017. **Terminology** — Preferred and avoided terms.102103### Voice Attribute Spectrums104105When defining or evaluating brand voice, position attributes on a spectrum:106107| Spectrum | One End | Other End |108|----------|---------|-----------|109| Formality | Formal, institutional | Casual, conversational |110| Authority | Expert, authoritative | Peer-level, collaborative |111| Emotion | Warm, empathetic | Direct, matter-of-fact |112| Complexity | Technical, precise | Simple, accessible |113| Energy | Bold, energetic | Calm, measured |114| Humor | Playful, witty | Serious, earnest |115| Innovation | Cutting-edge, forward-looking | Established, proven |116117For each chosen attribute, document it in this format:118119**[Attribute name]**120- **We are**: [what this means in practice]121- **We are not**: [common misinterpretation to avoid]122- **This sounds like**: [example sentence demonstrating the attribute]123- **This does NOT sound like**: [example sentence violating the attribute]124125Example:126127**Approachable**128- **We are**: friendly, clear, jargon-free, welcoming to beginners and experts alike129- **We are not**: dumbed-down, overly casual, or lacking substance130- **This sounds like**: "Here's how to get started — it takes about five minutes."131- **This does NOT sound like**: "Yo! This is super easy, even a noob can do it lol."132133### Tone Adaptation Across Channels and Contexts134135The brand voice stays consistent, but tone adapts to context. Tone is the emotional inflection applied to the voice.136137#### Tone by Channel138139| Channel | Tone Adaptation | Example |140|---------|----------------|---------|141| Blog | Informative, conversational, educational | "Let's walk through how this works and why it matters for your team." |142| Social media (LinkedIn) | Professional, thought-provoking, concise | "Three things we learned from running 50 campaigns this quarter." |143| Social media (Twitter/X) | Punchy, direct, sometimes witty | "Your landing page has 3 seconds. Make them count." |144| Email marketing | Personal, helpful, action-oriented | "We put together something we think you'll find useful." |145| Sales collateral | Confident, benefit-driven, specific | "Teams using our platform reduce reporting time by 40%." |146| Support/Help docs | Clear, patient, step-by-step | "If you see this error, here's how to fix it." |147| Press release | Formal, factual, newsworthy | "The company today announced the launch of..." |148| Error messages | Empathetic, helpful, blame-free | "Something went wrong on our end. We're looking into it." |149150#### Tone by Situation151152| Situation | Tone Adaptation |153|-----------|----------------|154| Product launch | Excited, confident, forward-looking |155| Incident or outage | Transparent, empathetic, accountable |156| Customer success story | Celebratory, specific, crediting the customer |157| Thought leadership | Authoritative, nuanced, evidence-based |158| Onboarding | Welcoming, encouraging, clear |159| Bad news (price increase, deprecation) | Honest, respectful, solution-oriented |160| Competitive comparison | Confident but fair, fact-based, not disparaging |161162#### Tone Adaptation Rule163The voice attributes remain fixed. Tone dials them up or down based on context. For example, if a brand is "bold and warm":164- In a product launch, dial up boldness165- In an incident response, dial up warmth166- Neither attribute disappears; the balance shifts167168### Style Guide Enforcement169170#### Grammar and Mechanics171Document and enforce these choices consistently:172173| Rule | Options | Example |174|------|---------|---------|175| Oxford comma | Yes / No | "fast, reliable, and secure" vs. "fast, reliable and secure" |176| Sentence case vs. title case (headings) | Sentence / Title | "How to get started" vs. "How to Get Started" |177| Contractions | Use / Avoid | "we're" vs. "we are" |178| Em dash spacing | No spaces / Spaces | "this—and more" vs. "this — and more" |179| Numbers | Spell out 1-9, numerals 10+ / Always numerals | "five features" vs. "5 features" |180| Percent | % / percent | "50%" vs. "50 percent" |181| Date format | Month DD, YYYY / DD/MM/YYYY / etc. | "January 15, 2025" |182| Time format | 12-hour / 24-hour | "3:00 PM" vs. "15:00" |183| Lists | Periods / No periods on fragments | "Set up your account." vs. "Set up your account" |184185#### Formatting Conventions186- Heading hierarchy (when to use H1, H2, H3)187- Bold and italic usage (bold for emphasis, italic for titles/terms)188- Link text (descriptive vs. "click here" — always descriptive)189- Image alt text requirements190- Code formatting (for technical brands)191- Callout or highlight box usage192193#### Punctuation and Emphasis194- Exclamation mark policy (limited use, never more than one)195- Ellipsis usage (avoid in most professional contexts)196- ALL CAPS policy (avoid; use bold for emphasis instead)197- Emoji usage by channel (professional channels: minimal or none; social: where appropriate)198199### Terminology Management200201#### Preferred Terms202203Maintain a list of preferred terms and their incorrect alternatives:204205| Use This | Not This | Notes |206|----------|----------|-------|207| sign up (verb) | signup (verb) | "signup" is the noun form |208| log in (verb) | login (verb) | "login" is the noun/adjective form |209| set up (verb) | setup (verb) | "setup" is the noun/adjective form |210| email | e-mail | No hyphen |211| website | web site | One word |212| data is (singular) | data are | Unless the publication requires plural |213214#### Product and Feature Names215- Official capitalization for product names216- When to use the full product name vs. shorthand217- Whether to use "the" before product names218- How to handle versioning in copy219- Trademark and registration symbols (when required and when to omit)220221#### Inclusive Language222- Use gender-neutral language (they/them for unknown individuals)223- Avoid ableist language ("crazy", "blind spot", "lame")224- Use person-first language where appropriate225- Avoid culturally specific idioms that may not translate226- Use "simple" or "straightforward" instead of "easy" (what is easy varies by person)227228#### Industry Jargon Management229- Define which technical terms the audience understands without explanation230- List jargon that should always be defined or replaced with plain language231- Specify which acronyms need to be spelled out on first use232- Audience-specific glossary for terms that mean different things to different readers233234#### Competitor and Category Terms235- How to refer to your product category (use your preferred framing)236- How to refer to competitors (by name or generically)237- Terms competitors have coined that you should avoid (to prevent reinforcing their positioning)238- Your preferred differentiation language239240## Output Format241242Present the review as:243244### Summary245- Overall assessment: how well the content aligns with brand standards (or general quality)246- 1-2 sentence summary of the biggest strengths247- 1-2 sentence summary of the most important improvements248249### Detailed Findings250251For each issue found, provide:252253| Issue | Location | Severity | Suggestion |254|-------|----------|----------|------------|255256Where severity is:257- **High** — contradicts brand voice, contains compliance risk, or significantly undermines messaging258- **Medium** — inconsistent with guidelines but not damaging259- **Low** — minor style or preference issue260261### Revised Sections262263For the top 3-5 highest-severity issues, provide a before/after showing the original text and a suggested revision.264265### Legal/Compliance Flags266267List any legal or compliance concerns separately with recommended actions.268269## After Review270271Ask: "Would you like me to:272- Revise the full content with these suggestions applied?273- Focus on fixing just the high-severity issues?274- Review additional content against the same guidelines?275- Help you document your brand voice for future reviews?"