Brand Guidelines
Comprehensive brand identity systems for building, documenting, and enforcing consistent brand presence across every channel and touchpoint.
Table of Contents
Keywords
brand guidelines, brand identity, style guide, brand voice, tone of voice, visual identity, brand standards, brand consistency, color systems, typography, logo usage, brand colors, design standards, brand audit, brand governance, co-branding, brand architecture, brand personality, writing style guide, visual standards
Clarify First
Before building the guidelines, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Quick Start
Create Brand Guidelines from Scratch
- Define brand foundation (purpose, values, personality)
- Establish voice and tone system with attribute matrix
- Build visual identity system (colors, typography, logo rules)
- Document imagery and photography standards
- Create channel-specific application guides
- Compile into shareable brand guidelines document
Audit Existing Brand Consistency
- Collect samples from every active channel and touchpoint
- Run the Brand Audit Checklist against each sample
- Score consistency across all seven brand dimensions
- Document deviations with specific remediation recommendations
- Prioritize fixes by customer-facing visibility
Core Workflows
Workflow 1: Build a Brand Identity System
Step 1: Define Brand Foundation
## Brand Foundation
- Purpose: [Why the brand exists beyond revenue]
- Vision: [What the brand aspires to achieve in the world]
- Mission: [How the brand delivers on its purpose daily]
- Values (3-5):
1. [Value]: [What it means in practice, not just the word]
2. [Value]: [Behavioral definition]
3. [Value]: [Behavioral definition]
- Brand Promise: [The single commitment to customers]
Step 2: Establish Brand Personality
Select 3-5 personality traits from the archetype framework:
| Archetype |
Personality Traits |
Voice Characteristics |
Best For |
| Expert |
Knowledgeable, precise, authoritative |
Data-driven, technical depth, confidence |
B2B, enterprise, professional services |
| Guide |
Helpful, clear, patient |
Instructional, encouraging, step-by-step |
Education, SaaS, healthcare |
| Innovator |
Bold, forward-thinking, disruptive |
Visionary, provocative, future-focused |
Tech, startups, R&D |
| Friend |
Warm, approachable, genuine |
Conversational, inclusive, casual |
Consumer brands, community, lifestyle |
| Motivator |
Inspiring, energetic, empowering |
Action-oriented, ambitious, rallying |
Fitness, coaching, personal development |
| Challenger |
Direct, honest, contrarian |
Opinionated, confident, questioning |
Fintech, disruptor brands |
| Creator |
Imaginative, expressive, original |
Storytelling, vivid imagery, playful |
Design, media, entertainment |
Step 3: Document Voice and Tone
See the Voice and Tone System section below for the complete framework.
Step 4: Build Visual Identity
See the Visual Identity System section below for the complete framework.
Step 5: Create Application Guide
Document how guidelines apply to each channel:
- Website and product UI
- Email marketing
- Social media (per platform)
- Sales materials
- Customer support communications
- Press and media
- Co-branded materials
Workflow 2: Brand Audit
Step 1: Collect Samples
Gather 3-5 samples from each active channel:
- Website pages (homepage, product, blog, about)
- Email campaigns (marketing, transactional, support)
- Social media posts (per platform)
- Sales decks and proposals
- Customer support responses
- Advertising creative
- Physical materials (if applicable)
Step 2: Score Against Seven Dimensions
For each sample, score 1-5 on:
| Dimension |
1 (Poor) |
3 (Adequate) |
5 (Excellent) |
| Color usage |
Off-brand colors present |
Mostly correct, minor deviations |
Perfect palette adherence |
| Typography |
Wrong fonts used |
Correct fonts, inconsistent sizing |
Perfect type hierarchy |
| Logo usage |
Incorrect sizing, placement, or modification |
Mostly correct with minor issues |
Perfect logo application |
| Voice consistency |
Tone shifts dramatically between sections |
Generally consistent, occasional drift |
Voice is unmistakably on-brand |
| Imagery style |
Stock photos inconsistent with brand |
Mostly aligned, some off-brand choices |
Cohesive visual language |
| Layout patterns |
No recognizable brand patterns |
Some consistent elements |
Clear, repeated brand patterns |
| Content quality |
Errors, vague claims, inconsistent formatting |
Clean, generally well-written |
Precise, specific, error-free |
Step 3: Generate Audit Report
## Brand Audit Report: [Brand Name]
Date: [Date]
Auditor: [Name]
### Overall Score: [X/35]
### Dimension Scores
| Dimension | Score | Priority |
|-----------|-------|----------|
| Color | X/5 | [High/Medium/Low] |
| Typography | X/5 | [High/Medium/Low] |
| Logo | X/5 | [High/Medium/Low] |
| Voice | X/5 | [High/Medium/Low] |
| Imagery | X/5 | [High/Medium/Low] |
| Layout | X/5 | [High/Medium/Low] |
| Content | X/5 | [High/Medium/Low] |
### Critical Issues
[Specific deviations with exact references]
### Recommendations
[Prioritized fixes with implementation guidance]
Brand Identity Dimensions
Dimension 1: Brand Foundation
The strategic layer that everything else builds on:
- Purpose — Why the brand exists (not "to make money")
- Values — What the brand believes and practices
- Positioning — Where the brand sits in the competitive landscape
- Promise — The core commitment to customers
Dimension 2: Voice and Tone
How the brand communicates across all written and spoken channels. See detailed framework below.
Dimension 3: Visual Identity
Colors, typography, logo, imagery, and layout patterns. See detailed framework below.
Dimension 4: Verbal Identity
Specific language choices:
- Naming conventions — How products, features, and tiers are named
- Terminology — Preferred terms vs. avoided terms
- Taglines and slogans — Core messaging lines
- Boilerplate copy — Standard company descriptions for press, bios, footers
Dimension 5: Experiential Identity
How the brand feels in interaction:
- UI patterns — Consistent interaction patterns in product
- Service tone — How support and success teams communicate
- Onboarding experience — First impression and initial value delivery
- Physical presence — Office, events, swag, packaging
Voice and Tone System
Voice vs. Tone
Voice is consistent — it is who the brand is. It does not change.
Tone adapts — it adjusts based on context, audience, and situation.
Example: A brand's voice is always "clear and confident." But the tone shifts:
- Product announcement: enthusiastic, forward-looking
- Incident response: calm, transparent, accountable
- Tutorial: patient, encouraging, precise
Voice Attribute Matrix
Define 3-5 voice attributes with spectrum positions:
| Attribute |
We Are |
We Are Not |
| [e.g., Direct] |
We get to the point. We say what we mean. |
We are not blunt or dismissive. We are not rude. |
| [e.g., Knowledgeable] |
We share expertise with confidence. |
We are not condescending. We do not lecture. |
| [e.g., Human] |
We write like people, not corporations. |
We are not unprofessional. We do not use slang carelessly. |
Tone Calibration by Context
| Context |
Formality |
Energy |
Technical Depth |
| Marketing homepage |
Medium |
High |
Low |
| Product documentation |
Medium-High |
Neutral |
High |
| Blog posts |
Medium-Low |
Medium |
Medium |
| Error messages |
Medium |
Calm |
Low |
| Social media |
Low-Medium |
High |
Low |
| Sales proposals |
High |
Medium |
Medium-High |
| Customer support |
Medium |
Warm |
Varies |
| Incident reports |
High |
Calm |
High |
Writing Style Rules
Grammar and Mechanics:
- Oxford comma: [Yes/No]
- Contractions: [When to use/avoid]
- Sentence case vs. Title Case for headings: [Standard]
- Number formatting: [Spell out 1-9, numerals for 10+]
- Date formatting: [Month Day, Year vs. DD/MM/YYYY]
- Ampersand usage: [When acceptable]
Vocabulary Standards:
- Preferred terms: [List of terms to always use]
- Avoided terms: [List of terms to never use]
- Jargon policy: [When industry jargon is acceptable]
- Acronym policy: [Spell out on first use, then abbreviate]
Visual Identity System
Color System
Primary Palette:
| Role |
Color Name |
Hex |
RGB |
Use Case |
| Primary |
[Name] |
#XXXXXX |
R, G, B |
Primary CTAs, key brand elements |
| Secondary |
[Name] |
#XXXXXX |
R, G, B |
Supporting elements, accents |
| Neutral Dark |
[Name] |
#XXXXXX |
R, G, B |
Body text, dark backgrounds |
| Neutral Light |
[Name] |
#XXXXXX |
R, G, B |
Backgrounds, borders |
Extended Palette:
| Role |
Color Name |
Hex |
Use Case |
| Success |
[Name] |
#XXXXXX |
Positive states, confirmations |
| Warning |
[Name] |
#XXXXXX |
Cautionary states |
| Error |
[Name] |
#XXXXXX |
Error states, destructive actions |
| Info |
[Name] |
#XXXXXX |
Informational states |
Color Usage Rules:
- Primary color for CTAs and key interactive elements only
- Minimum contrast ratio: 4.5:1 for text, 3:1 for large text (WCAG AA)
- Never place colored text on colored backgrounds without checking contrast
- Do not create new color variations — use the defined palette only
Typography System
| Role |
Font |
Weight |
Size |
Line Height |
Use Case |
| Display |
[Font Name] |
Bold/Black |
48-72px |
1.1 |
Hero headlines |
| Heading 1 |
[Font Name] |
Bold |
36-48px |
1.2 |
Page titles |
| Heading 2 |
[Font Name] |
Semibold |
24-32px |
1.3 |
Section headers |
| Heading 3 |
[Font Name] |
Medium |
20-24px |
1.4 |
Subsection headers |
| Body |
[Font Name] |
Regular |
16-18px |
1.5-1.6 |
Paragraph text |
| Small |
[Font Name] |
Regular |
14px |
1.5 |
Captions, metadata |
| Code |
[Mono Font] |
Regular |
14-16px |
1.5 |
Code blocks, technical |
Typography Rules:
- Maximum 2 font families across the brand
- Heading hierarchy must be maintained (never skip levels)
- Minimum body text size: 16px for web, 10pt for print
- Maximum line length: 70-80 characters for readability
Logo System
Logo Variations:
- Primary: Full logo (icon + wordmark)
- Secondary: Wordmark only
- Icon: Icon/symbol only (for favicons, app icons, small spaces)
- Reversed: White version for dark backgrounds
Logo Rules:
- Minimum clear space: [X] times the height of the icon on all sides
- Minimum size: [X]px for digital, [X]mm for print
- Never stretch, rotate, recolor, or add effects to the logo
- Never place the logo on busy backgrounds without a container
- Approved background colors: [List specific colors]
Co-Branding Rules:
- Partner logos must be equal or smaller size
- Minimum separation between logos: [X]px
- Use a divider line or "+" symbol between logos
- Our logo always appears on the left or top
Imagery Standards
Photography Style:
- [Natural/staged] lighting
- [Warm/cool/neutral] color temperature
- [Diverse/specific] representation
- [Candid/polished] composition
- Do not use: [Specific stock photo cliches to avoid]
Illustration Style:
- [Flat/3D/line art/isometric] style
- Color palette limited to brand colors
- Consistent line weight: [X]px
- Corner radius: [X]px for rounded elements
Icon Style:
- [Outline/filled/two-tone] style
- Consistent stroke weight: [X]px
- Grid size: [X]px base grid
- Corner radius: [X]px
Brand Audit Framework
Quick Audit Checklist
Run this against any brand asset in under 5 minutes:
Full Audit Process
For a comprehensive brand audit across the organization:
- Inventory — List every customer-facing touchpoint
- Sample — Collect 3-5 recent examples from each touchpoint
- Score — Rate each sample across all seven dimensions (1-5)
- Analyze — Identify patterns in where consistency breaks down
- Prioritize — Rank fixes by customer visibility and business impact
- Remediate — Create specific fix instructions for each issue
- Govern — Establish review process to prevent future drift
Cross-Channel Application
Website
- Homepage reflects full brand identity (all dimensions)
- Product pages maintain visual consistency with marketing pages
- Blog uses the same typography and color system
- Error pages and empty states still reflect brand personality
- Favicon and OG images use approved logo variations
Email
- Header uses approved logo at correct size
- Color palette limited to brand palette
- CTA buttons match brand primary color
- Font stack includes web-safe fallbacks that approximate brand fonts
- Footer includes consistent boilerplate and legal text
Social Media
| Platform |
Avatar |
Cover/Banner |
Post Templates |
Voice Adaptation |
| LinkedIn |
Logo icon |
Brand banner |
Professional, clean |
Slightly more formal |
| Twitter/X |
Logo icon |
Brand banner |
Concise, punchy |
Slightly more casual |
| Instagram |
Logo icon |
N/A |
Visual-first, on-brand colors |
Visual storytelling emphasis |
| YouTube |
Logo icon |
Brand banner |
Thumbnail template |
Conversational |
Sales Materials
- Slide deck template with locked master slides
- Proposal template with approved cover page and footer
- One-pager template for leave-behinds
- All use approved color palette, typography, and logo placement
Customer Support
- Email signatures follow standard format
- Help center articles use brand voice (helpful, patient, clear)
- Chatbot responses match brand personality
- Escalation templates maintain professional but warm tone
Best Practices
Specificity over subjectivity — "Use #2563EB for primary buttons" is enforceable. "Use a nice blue" is not. Every guideline should be specific enough that a contractor produces on-brand work without guessing.
Show examples of what NOT to do — For every rule, include a clear violation example. People learn faster from anti-patterns than from rules.
Version and date everything — Brand guidelines evolve. Version every update and keep a changelog.
Distribute in a usable format — A 200-page PDF nobody reads is worse than a 10-page living document everyone references. Make guidelines accessible where people work.
Audit quarterly — Brand drift happens slowly. Schedule quarterly audits to catch deviations before they compound.
Provide templates, not just rules — Every channel should have a ready-to-use template that embodies the guidelines. Templates enforce consistency better than documentation.
Define escalation for edge cases — Who approves a new color? Who decides if a co-branding request is acceptable? Document the decision process.
Train new team members — Brand guidelines are only as effective as the people who follow them. Include guidelines in onboarding.
Integration Points
- Brand Strategist — Use for high-level brand positioning and architecture decisions. Brand Guidelines implements and documents those strategic decisions.
- Copywriting — Use brand voice and tone system when writing any marketing copy.
- Content Creator — Reference brand guidelines for every content piece to maintain consistency.
- Social Content — Apply platform-specific brand adaptations from the cross-channel guide.
- Ad Creative — Reference visual identity and voice standards for all advertising creative.
- Landing Page Generator — Apply brand colors, typography, and voice to all landing pages.
Troubleshooting
| Symptom |
Likely Cause |
Resolution |
| Brand colors look different across web and print |
RGB vs CMYK color space mismatch; no Pantone reference defined |
Document colors in all three systems (Hex/RGB for digital, CMYK for print, Pantone for exact matching) |
| Teams consistently use wrong fonts |
Font files not distributed or licensed for all team members |
Create a shared font kit, document web-safe fallbacks, include licensing status per font |
| Logo appears stretched or pixelated on partner sites |
Co-branding guidelines not shared or minimum size not enforced |
Distribute logo kit with vector formats (SVG/EPS), document minimum sizes and clear space rules |
| Voice varies dramatically across customer support vs marketing |
Tone calibration by context not documented or not trained |
Create channel-specific tone guides with before/after examples, include in onboarding |
| Brand drift detected in quarterly audit |
No governance process for new assets, no template enforcement |
Implement approval workflow, lock master templates, assign brand guardians per channel |
| Color contrast failures on accessibility audits |
Brand palette not tested against WCAG AA/AAA standards |
Run color_accessibility_checker.py on full palette, adjust problematic combinations |
| New hires produce off-brand content in first 30 days |
Brand guidelines not included in onboarding process |
Add brand guidelines review to onboarding checklist, provide quick-reference card |
Success Criteria
- Brand audit scores 4.0+/5.0 average across all seven dimensions (color, typography, logo, voice, imagery, layout, content)
- All brand color combinations meet WCAG AA contrast ratio (4.5:1 for normal text, 3:1 for large text)
- Quarterly audit variance stays below 10% across all channels
- 100% of customer-facing templates use approved brand assets
- New team members produce on-brand content within first 2 weeks of onboarding
- Zero unauthorized logo modifications detected across all channels
Scope & Limitations
In Scope: Visual identity systems (color, typography, logo, imagery), voice and tone frameworks, brand audit methodology, cross-channel application guides, co-branding rules, brand governance processes, accessibility compliance for brand colors.
Out of Scope: Brand strategy and positioning decisions (see brand-strategist skill), brand architecture models (see brand-strategist skill), marketing copy creation (see copywriting skill), design file creation (Figma, Sketch), print production specifications.
Limitations: Brand guidelines are documentation — enforcement depends on organizational process. This skill provides frameworks and audit tools but cannot enforce compliance without governance workflows. Color accessibility checking uses algorithmic WCAG formulas and does not account for all visual impairment types.
Scripts
| Script |
Purpose |
Usage |
scripts/brand_audit_scorer.py |
Score brand consistency across seven dimensions with priorities |
python scripts/brand_audit_scorer.py audit_data.json --json |
scripts/messaging_consistency_checker.py |
Check text against brand voice standards, detect vocabulary violations |
python scripts/messaging_consistency_checker.py --text "Your copy here" |
scripts/color_accessibility_checker.py |
Validate brand colors against WCAG contrast requirements |
python scripts/color_accessibility_checker.py --fg "#2563EB" --bg "#FFFFFF" |
1---2name: brand-guidelines-33description: Build and enforce brand identity systems: visual identity, voice and tone, typography, color, and cross-channel consistency. Use when creating style guides, defining brand voice, auditing brand consistency, or setting visual standards.4license: MIT5---6# Brand Guidelines
7
8Comprehensive brand identity systems for building, documenting, and enforcing consistent brand presence across every channel and touchpoint.
9
10---
11
12## Table of Contents
13
14- [Keywords](#keywords)
15- [Quick Start](#quick-start)
16- [Core Workflows](#core-workflows)
17- [Brand Identity Dimensions](#brand-identity-dimensions)
18- [Voice and Tone System](#voice-and-tone-system)
19- [Visual Identity System](#visual-identity-system)
20- [Brand Audit Framework](#brand-audit-framework)
21- [Cross-Channel Application](#cross-channel-application)
22- [Best Practices](#best-practices)
23- [Integration Points](#integration-points)
24
25---
26
27## Keywords
28
29brand guidelines, brand identity, style guide, brand voice, tone of voice, visual identity, brand standards, brand consistency, color systems, typography, logo usage, brand colors, design standards, brand audit, brand governance, co-branding, brand architecture, brand personality, writing style guide, visual standards
30
31---
32
33## Clarify First
34
35Before building the guidelines, confirm these inputs. If any is unknown or vague, ASK — do not assume:
36
37- [ ] **Brand foundation** — purpose, values, and brand promise (the strategic layer every voice and visual choice traces back to)
38- [ ] **Brand archetype/personality** — Expert / Guide / Innovator / Friend / etc. (sets voice attributes and tone calibration)
39- [ ] **Existing visual assets** — current colors, fonts, and logo, if any (determines build-new vs document-existing)
40- [ ] **Channels in scope** — web, email, social, sales, support (drives which cross-channel application sections to produce)
41
42Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
43
44## Quick Start
45
46### Create Brand Guidelines from Scratch
47
481. Define brand foundation (purpose, values, personality)
492. Establish voice and tone system with attribute matrix
503. Build visual identity system (colors, typography, logo rules)
514. Document imagery and photography standards
525. Create channel-specific application guides
536. Compile into shareable brand guidelines document
54
55### Audit Existing Brand Consistency
56
571. Collect samples from every active channel and touchpoint
582. Run the Brand Audit Checklist against each sample
593. Score consistency across all seven brand dimensions
604. Document deviations with specific remediation recommendations
615. Prioritize fixes by customer-facing visibility
62
63---
64
65## Core Workflows
66
67### Workflow 1: Build a Brand Identity System
68
69**Step 1: Define Brand Foundation**
70
71```markdown
72## Brand Foundation
73- Purpose: [Why the brand exists beyond revenue]
74- Vision: [What the brand aspires to achieve in the world]
75- Mission: [How the brand delivers on its purpose daily]
76- Values (3-5):
77 1. [Value]: [What it means in practice, not just the word]
78 2. [Value]: [Behavioral definition]
79 3. [Value]: [Behavioral definition]
80- Brand Promise: [The single commitment to customers]
81```
82
83**Step 2: Establish Brand Personality**
84
85Select 3-5 personality traits from the archetype framework:
86
87| Archetype | Personality Traits | Voice Characteristics | Best For |
88|-----------|-------------------|----------------------|----------|
89| Expert | Knowledgeable, precise, authoritative | Data-driven, technical depth, confidence | B2B, enterprise, professional services |
90| Guide | Helpful, clear, patient | Instructional, encouraging, step-by-step | Education, SaaS, healthcare |
91| Innovator | Bold, forward-thinking, disruptive | Visionary, provocative, future-focused | Tech, startups, R&D |
92| Friend | Warm, approachable, genuine | Conversational, inclusive, casual | Consumer brands, community, lifestyle |
93| Motivator | Inspiring, energetic, empowering | Action-oriented, ambitious, rallying | Fitness, coaching, personal development |
94| Challenger | Direct, honest, contrarian | Opinionated, confident, questioning | Fintech, disruptor brands |
95| Creator | Imaginative, expressive, original | Storytelling, vivid imagery, playful | Design, media, entertainment |
96
97**Step 3: Document Voice and Tone**
98
99See the Voice and Tone System section below for the complete framework.
100
101**Step 4: Build Visual Identity**
102
103See the Visual Identity System section below for the complete framework.
104
105**Step 5: Create Application Guide**
106
107Document how guidelines apply to each channel:
108- Website and product UI
109- Email marketing
110- Social media (per platform)
111- Sales materials
112- Customer support communications
113- Press and media
114- Co-branded materials
115
116### Workflow 2: Brand Audit
117
118**Step 1: Collect Samples**
119
120Gather 3-5 samples from each active channel:
121- Website pages (homepage, product, blog, about)
122- Email campaigns (marketing, transactional, support)
123- Social media posts (per platform)
124- Sales decks and proposals
125- Customer support responses
126- Advertising creative
127- Physical materials (if applicable)
128
129**Step 2: Score Against Seven Dimensions**
130
131For each sample, score 1-5 on:
132
133| Dimension | 1 (Poor) | 3 (Adequate) | 5 (Excellent) |
134|-----------|----------|---------------|----------------|
135| Color usage | Off-brand colors present | Mostly correct, minor deviations | Perfect palette adherence |
136| Typography | Wrong fonts used | Correct fonts, inconsistent sizing | Perfect type hierarchy |
137| Logo usage | Incorrect sizing, placement, or modification | Mostly correct with minor issues | Perfect logo application |
138| Voice consistency | Tone shifts dramatically between sections | Generally consistent, occasional drift | Voice is unmistakably on-brand |
139| Imagery style | Stock photos inconsistent with brand | Mostly aligned, some off-brand choices | Cohesive visual language |
140| Layout patterns | No recognizable brand patterns | Some consistent elements | Clear, repeated brand patterns |
141| Content quality | Errors, vague claims, inconsistent formatting | Clean, generally well-written | Precise, specific, error-free |
142
143**Step 3: Generate Audit Report**
144
145```markdown
146## Brand Audit Report: [Brand Name]
147Date: [Date]
148Auditor: [Name]
149
150### Overall Score: [X/35]
151
152### Dimension Scores
153| Dimension | Score | Priority |
154|-----------|-------|----------|
155| Color | X/5 | [High/Medium/Low] |
156| Typography | X/5 | [High/Medium/Low] |
157| Logo | X/5 | [High/Medium/Low] |
158| Voice | X/5 | [High/Medium/Low] |
159| Imagery | X/5 | [High/Medium/Low] |
160| Layout | X/5 | [High/Medium/Low] |
161| Content | X/5 | [High/Medium/Low] |
162
163### Critical Issues
164[Specific deviations with exact references]
165
166### Recommendations
167[Prioritized fixes with implementation guidance]
168```
169
170---
171
172## Brand Identity Dimensions
173
174### Dimension 1: Brand Foundation
175
176The strategic layer that everything else builds on:
177- **Purpose** — Why the brand exists (not "to make money")
178- **Values** — What the brand believes and practices
179- **Positioning** — Where the brand sits in the competitive landscape
180- **Promise** — The core commitment to customers
181
182### Dimension 2: Voice and Tone
183
184How the brand communicates across all written and spoken channels. See detailed framework below.
185
186### Dimension 3: Visual Identity
187
188Colors, typography, logo, imagery, and layout patterns. See detailed framework below.
189
190### Dimension 4: Verbal Identity
191
192Specific language choices:
193- **Naming conventions** — How products, features, and tiers are named
194- **Terminology** — Preferred terms vs. avoided terms
195- **Taglines and slogans** — Core messaging lines
196- **Boilerplate copy** — Standard company descriptions for press, bios, footers
197
198### Dimension 5: Experiential Identity
199
200How the brand feels in interaction:
201- **UI patterns** — Consistent interaction patterns in product
202- **Service tone** — How support and success teams communicate
203- **Onboarding experience** — First impression and initial value delivery
204- **Physical presence** — Office, events, swag, packaging
205
206---
207
208## Voice and Tone System
209
210### Voice vs. Tone
211
212**Voice** is consistent — it is who the brand is. It does not change.
213**Tone** adapts — it adjusts based on context, audience, and situation.
214
215Example: A brand's voice is always "clear and confident." But the tone shifts:
216- Product announcement: enthusiastic, forward-looking
217- Incident response: calm, transparent, accountable
218- Tutorial: patient, encouraging, precise
219
220### Voice Attribute Matrix
221
222Define 3-5 voice attributes with spectrum positions:
223
224| Attribute | We Are | We Are Not |
225|-----------|--------|------------|
226| [e.g., Direct] | We get to the point. We say what we mean. | We are not blunt or dismissive. We are not rude. |
227| [e.g., Knowledgeable] | We share expertise with confidence. | We are not condescending. We do not lecture. |
228| [e.g., Human] | We write like people, not corporations. | We are not unprofessional. We do not use slang carelessly. |
229
230### Tone Calibration by Context
231
232| Context | Formality | Energy | Technical Depth |
233|---------|-----------|--------|-----------------|
234| Marketing homepage | Medium | High | Low |
235| Product documentation | Medium-High | Neutral | High |
236| Blog posts | Medium-Low | Medium | Medium |
237| Error messages | Medium | Calm | Low |
238| Social media | Low-Medium | High | Low |
239| Sales proposals | High | Medium | Medium-High |
240| Customer support | Medium | Warm | Varies |
241| Incident reports | High | Calm | High |
242
243### Writing Style Rules
244
245**Grammar and Mechanics:**
246- Oxford comma: [Yes/No]
247- Contractions: [When to use/avoid]
248- Sentence case vs. Title Case for headings: [Standard]
249- Number formatting: [Spell out 1-9, numerals for 10+]
250- Date formatting: [Month Day, Year vs. DD/MM/YYYY]
251- Ampersand usage: [When acceptable]
252
253**Vocabulary Standards:**
254- Preferred terms: [List of terms to always use]
255- Avoided terms: [List of terms to never use]
256- Jargon policy: [When industry jargon is acceptable]
257- Acronym policy: [Spell out on first use, then abbreviate]
258
259---
260
261## Visual Identity System
262
263### Color System
264
265**Primary Palette:**
266
267| Role | Color Name | Hex | RGB | Use Case |
268|------|-----------|-----|-----|----------|
269| Primary | [Name] | #XXXXXX | R, G, B | Primary CTAs, key brand elements |
270| Secondary | [Name] | #XXXXXX | R, G, B | Supporting elements, accents |
271| Neutral Dark | [Name] | #XXXXXX | R, G, B | Body text, dark backgrounds |
272| Neutral Light | [Name] | #XXXXXX | R, G, B | Backgrounds, borders |
273
274**Extended Palette:**
275
276| Role | Color Name | Hex | Use Case |
277|------|-----------|-----|----------|
278| Success | [Name] | #XXXXXX | Positive states, confirmations |
279| Warning | [Name] | #XXXXXX | Cautionary states |
280| Error | [Name] | #XXXXXX | Error states, destructive actions |
281| Info | [Name] | #XXXXXX | Informational states |
282
283**Color Usage Rules:**
284- Primary color for CTAs and key interactive elements only
285- Minimum contrast ratio: 4.5:1 for text, 3:1 for large text (WCAG AA)
286- Never place colored text on colored backgrounds without checking contrast
287- Do not create new color variations — use the defined palette only
288
289### Typography System
290
291| Role | Font | Weight | Size | Line Height | Use Case |
292|------|------|--------|------|-------------|----------|
293| Display | [Font Name] | Bold/Black | 48-72px | 1.1 | Hero headlines |
294| Heading 1 | [Font Name] | Bold | 36-48px | 1.2 | Page titles |
295| Heading 2 | [Font Name] | Semibold | 24-32px | 1.3 | Section headers |
296| Heading 3 | [Font Name] | Medium | 20-24px | 1.4 | Subsection headers |
297| Body | [Font Name] | Regular | 16-18px | 1.5-1.6 | Paragraph text |
298| Small | [Font Name] | Regular | 14px | 1.5 | Captions, metadata |
299| Code | [Mono Font] | Regular | 14-16px | 1.5 | Code blocks, technical |
300
301**Typography Rules:**
302- Maximum 2 font families across the brand
303- Heading hierarchy must be maintained (never skip levels)
304- Minimum body text size: 16px for web, 10pt for print
305- Maximum line length: 70-80 characters for readability
306
307### Logo System
308
309**Logo Variations:**
310- Primary: Full logo (icon + wordmark)
311- Secondary: Wordmark only
312- Icon: Icon/symbol only (for favicons, app icons, small spaces)
313- Reversed: White version for dark backgrounds
314
315**Logo Rules:**
316- Minimum clear space: [X] times the height of the icon on all sides
317- Minimum size: [X]px for digital, [X]mm for print
318- Never stretch, rotate, recolor, or add effects to the logo
319- Never place the logo on busy backgrounds without a container
320- Approved background colors: [List specific colors]
321
322**Co-Branding Rules:**
323- Partner logos must be equal or smaller size
324- Minimum separation between logos: [X]px
325- Use a divider line or "+" symbol between logos
326- Our logo always appears on the left or top
327
328### Imagery Standards
329
330**Photography Style:**
331- [Natural/staged] lighting
332- [Warm/cool/neutral] color temperature
333- [Diverse/specific] representation
334- [Candid/polished] composition
335- Do not use: [Specific stock photo cliches to avoid]
336
337**Illustration Style:**
338- [Flat/3D/line art/isometric] style
339- Color palette limited to brand colors
340- Consistent line weight: [X]px
341- Corner radius: [X]px for rounded elements
342
343**Icon Style:**
344- [Outline/filled/two-tone] style
345- Consistent stroke weight: [X]px
346- Grid size: [X]px base grid
347- Corner radius: [X]px
348
349---
350
351## Brand Audit Framework
352
353### Quick Audit Checklist
354
355Run this against any brand asset in under 5 minutes:
356
357- [ ] Colors match approved palette exactly (no approximate matches)
358- [ ] Fonts are correct typeface, weight, and size
359- [ ] Logo has proper clear space and is an approved variation
360- [ ] Body text meets minimum size and contrast requirements
361- [ ] Imagery style matches brand photography/illustration standards
362- [ ] Tone matches brand voice attributes for this context
363- [ ] No prohibited uses present (stretched logos, unapproved colors, off-brand imagery)
364- [ ] Co-branding follows partner logo rules (if applicable)
365- [ ] Content is free of spelling, grammar, and factual errors
366- [ ] CTAs use approved language and styling
367
368### Full Audit Process
369
370For a comprehensive brand audit across the organization:
371
3721. **Inventory** — List every customer-facing touchpoint
3732. **Sample** — Collect 3-5 recent examples from each touchpoint
3743. **Score** — Rate each sample across all seven dimensions (1-5)
3754. **Analyze** — Identify patterns in where consistency breaks down
3765. **Prioritize** — Rank fixes by customer visibility and business impact
3776. **Remediate** — Create specific fix instructions for each issue
3787. **Govern** — Establish review process to prevent future drift
379
380---
381
382## Cross-Channel Application
383
384### Website
385
386- Homepage reflects full brand identity (all dimensions)
387- Product pages maintain visual consistency with marketing pages
388- Blog uses the same typography and color system
389- Error pages and empty states still reflect brand personality
390- Favicon and OG images use approved logo variations
391
392### Email
393
394- Header uses approved logo at correct size
395- Color palette limited to brand palette
396- CTA buttons match brand primary color
397- Font stack includes web-safe fallbacks that approximate brand fonts
398- Footer includes consistent boilerplate and legal text
399
400### Social Media
401
402| Platform | Avatar | Cover/Banner | Post Templates | Voice Adaptation |
403|----------|--------|-------------|---------------|-----------------|
404| LinkedIn | Logo icon | Brand banner | Professional, clean | Slightly more formal |
405| Twitter/X | Logo icon | Brand banner | Concise, punchy | Slightly more casual |
406| Instagram | Logo icon | N/A | Visual-first, on-brand colors | Visual storytelling emphasis |
407| YouTube | Logo icon | Brand banner | Thumbnail template | Conversational |
408
409### Sales Materials
410
411- Slide deck template with locked master slides
412- Proposal template with approved cover page and footer
413- One-pager template for leave-behinds
414- All use approved color palette, typography, and logo placement
415
416### Customer Support
417
418- Email signatures follow standard format
419- Help center articles use brand voice (helpful, patient, clear)
420- Chatbot responses match brand personality
421- Escalation templates maintain professional but warm tone
422
423---
424
425## Best Practices
426
4271. **Specificity over subjectivity** — "Use #2563EB for primary buttons" is enforceable. "Use a nice blue" is not. Every guideline should be specific enough that a contractor produces on-brand work without guessing.
428
4292. **Show examples of what NOT to do** — For every rule, include a clear violation example. People learn faster from anti-patterns than from rules.
430
4313. **Version and date everything** — Brand guidelines evolve. Version every update and keep a changelog.
432
4334. **Distribute in a usable format** — A 200-page PDF nobody reads is worse than a 10-page living document everyone references. Make guidelines accessible where people work.
434
4355. **Audit quarterly** — Brand drift happens slowly. Schedule quarterly audits to catch deviations before they compound.
436
4376. **Provide templates, not just rules** — Every channel should have a ready-to-use template that embodies the guidelines. Templates enforce consistency better than documentation.
438
4397. **Define escalation for edge cases** — Who approves a new color? Who decides if a co-branding request is acceptable? Document the decision process.
440
4418. **Train new team members** — Brand guidelines are only as effective as the people who follow them. Include guidelines in onboarding.
442
443---
444
445## Integration Points
446
447- **Brand Strategist** — Use for high-level brand positioning and architecture decisions. Brand Guidelines implements and documents those strategic decisions.
448- **Copywriting** — Use brand voice and tone system when writing any marketing copy.
449- **Content Creator** — Reference brand guidelines for every content piece to maintain consistency.
450- **Social Content** — Apply platform-specific brand adaptations from the cross-channel guide.
451- **Ad Creative** — Reference visual identity and voice standards for all advertising creative.
452- **Landing Page Generator** — Apply brand colors, typography, and voice to all landing pages.
453
454---
455
456## Troubleshooting
457
458| Symptom | Likely Cause | Resolution |
459|---------|-------------|------------|
460| Brand colors look different across web and print | RGB vs CMYK color space mismatch; no Pantone reference defined | Document colors in all three systems (Hex/RGB for digital, CMYK for print, Pantone for exact matching) |
461| Teams consistently use wrong fonts | Font files not distributed or licensed for all team members | Create a shared font kit, document web-safe fallbacks, include licensing status per font |
462| Logo appears stretched or pixelated on partner sites | Co-branding guidelines not shared or minimum size not enforced | Distribute logo kit with vector formats (SVG/EPS), document minimum sizes and clear space rules |
463| Voice varies dramatically across customer support vs marketing | Tone calibration by context not documented or not trained | Create channel-specific tone guides with before/after examples, include in onboarding |
464| Brand drift detected in quarterly audit | No governance process for new assets, no template enforcement | Implement approval workflow, lock master templates, assign brand guardians per channel |
465| Color contrast failures on accessibility audits | Brand palette not tested against WCAG AA/AAA standards | Run color_accessibility_checker.py on full palette, adjust problematic combinations |
466| New hires produce off-brand content in first 30 days | Brand guidelines not included in onboarding process | Add brand guidelines review to onboarding checklist, provide quick-reference card |
467
468---
469
470## Success Criteria
471
472- Brand audit scores 4.0+/5.0 average across all seven dimensions (color, typography, logo, voice, imagery, layout, content)
473- All brand color combinations meet WCAG AA contrast ratio (4.5:1 for normal text, 3:1 for large text)
474- Quarterly audit variance stays below 10% across all channels
475- 100% of customer-facing templates use approved brand assets
476- New team members produce on-brand content within first 2 weeks of onboarding
477- Zero unauthorized logo modifications detected across all channels
478
479---
480
481## Scope & Limitations
482
483**In Scope:** Visual identity systems (color, typography, logo, imagery), voice and tone frameworks, brand audit methodology, cross-channel application guides, co-branding rules, brand governance processes, accessibility compliance for brand colors.
484
485**Out of Scope:** Brand strategy and positioning decisions (see brand-strategist skill), brand architecture models (see brand-strategist skill), marketing copy creation (see copywriting skill), design file creation (Figma, Sketch), print production specifications.
486
487**Limitations:** Brand guidelines are documentation — enforcement depends on organizational process. This skill provides frameworks and audit tools but cannot enforce compliance without governance workflows. Color accessibility checking uses algorithmic WCAG formulas and does not account for all visual impairment types.
488
489---
490
491## Scripts
492
493| Script | Purpose | Usage |
494|--------|---------|-------|
495| `scripts/brand_audit_scorer.py` | Score brand consistency across seven dimensions with priorities | `python scripts/brand_audit_scorer.py audit_data.json --json` |
496| `scripts/messaging_consistency_checker.py` | Check text against brand voice standards, detect vocabulary violations | `python scripts/messaging_consistency_checker.py --text "Your copy here"` |
497| `scripts/color_accessibility_checker.py` | Validate brand colors against WCAG contrast requirements | `python scripts/color_accessibility_checker.py --fg "#2563EB" --bg "#FFFFFF"` |