Brand Style Guide
Document the brand system so other people can use it without ambiguity. This is the artifact that lives longest. Designers, developers, agencies, and vendors will reference it for years. Build it like a reference manual, not a presentation.
This skill assumes the brand identity is designed (run brand-identity first if not). The output of this skill is the canonical reference document.
When to use
- Creating brand guidelines for a finished identity
- Documenting an existing brand that has no formal guide
- Auditing an existing style guide for gaps or inconsistencies
- Building a brand book to hand to vendors, partners, or new team members
- Updating a guide after a major brand evolution
When NOT to use
- The brand identity is not yet designed (use
brand-identity)
- Brand voice work specifically (use
brand-voice for the voice doc, then integrate)
- Building UI components (use
design-standards or design-system)
Required inputs
- Finished brand identity (logo, colors, typography, imagery direction, motion principles)
- Brand voice and tone documentation (or sufficient inputs to write a voice section)
- Application examples that show the brand in real contexts
- Decisions on what is mandatory vs flexible vs forbidden
The framework: 8 sections
A complete style guide has eight sections. Most guides skip 2 or 3 of them and create downstream confusion. Build all 8 from the start.
1. Story
The narrative behind the brand. Why it exists, what it stands for, what it rejects.
- Origin / founding story
- Mission and vision
- Values (3 to 5, with what each means in practice)
- Positioning statement
- Audience (with the level of specificity from the brief)
- What we are not (the things we explicitly reject)
2. Logo system
Every variant of every mark, with rules.
- Primary logo (with construction grid showing relationships)
- Wordmark
- Symbol / glyph
- Lockup variations (horizontal, stacked, etc.)
- Monogram (if part of system)
- Clear space rules (minimum spacing around logo)
- Minimum sizes (smallest acceptable size for print and digital)
- Acceptable color treatments (full color, single color, knock-out, reverse)
- Forbidden treatments (stretching, rotating, recoloring, drop shadows, gradients - whatever is forbidden)
- File formats and where to find them
3. Color
The full color system with rules.
- Primary palette (signature colors)
- Secondary palette
- Neutrals scale
- Semantic colors (success, warning, error, info)
- Light mode and dark mode variants
- Per color: hex, RGB, HSL, CMYK, Pantone (if print-relevant)
- Contrast ratios documented
- Allowed pairings
- Forbidden pairings
- Usage hierarchy (primary first, secondary supporting, neutrals dominant)
4. Typography
The full type system.
- Display typeface (with sample sizes)
- Body typeface (with sample sizes)
- Monospace (if applicable)
- Type scale (specific sizes used)
- Weight and style usage (which weights for which contexts)
- Line height ratios
- Letter spacing standards
- Web fallback stacks
- Open-source alternatives for licensing-restricted contexts
- Forbidden treatments (all caps overuse, fake italics, etc.)
5. Imagery and illustration
What pictures look like in this brand.
- Photography direction with example library
- Illustration style with example library
- Iconography system with the full icon set (or rules for adding to it)
- Forbidden imagery (stock photo cliches, specific things never to show)
- Photo treatment rules (color treatment, crops, composition)
6. Voice and tone
How the brand sounds. (Pulled from brand-voice work if done separately.)
- Voice attributes (3 to 5 adjectives with "we are X, not Y" framing)
- Tone shifts by context (onboarding, error, marketing, support, legal)
- Vocabulary preferences (words we use, words we avoid)
- Grammar and style rules
- Examples (good and bad copy side by side)
7. Applications
The brand applied to real contexts.
- Web (homepage, product pages, blog template)
- Email (template, signature, transactional)
- Social (post templates, profile imagery, story formats)
- Print (business cards, letterhead, print ads)
- Packaging (if applicable)
- Signage (if applicable)
- Internal documents (slides, reports, proposals)
- Each with examples showing what good looks like
8. Dos and don'ts
The boundaries, illustrated.
- Logo dos and don'ts (visual examples of correct and incorrect use)
- Color dos and don'ts (combinations to use, combinations to avoid)
- Type dos and don'ts (treatments to use, treatments to avoid)
- Composition dos and don'ts (layout patterns that work, ones that do not)
- Voice dos and don'ts (phrases that fit, phrases that do not)
The dos and don'ts section is what people actually reference in practice. Make it the easiest section to scan.
Workflow
- Inventory the inputs. What identity work is finished? What voice work is finished? What is missing?
- Confirm the format. Is this a PDF, a web page, a Notion doc, a printed book, or all of the above? Different formats have different production requirements.
- Section by section, draft. Use the template in
references/style-guide-template.md.
- Stress-test with real examples. For every rule, find a real application example. Rules without examples get ignored.
- Get review from the people who will use it. Designers, developers, marketers. They will surface gaps.
- Version control. Style guides evolve. Date the doc. Note what changed in each version.
- Publish in the format the team will actually open. A 200-page PDF that lives on a shared drive is dead weight. A web page or Figma file with a clear URL gets used.
Failure patterns
- Skipping the "what we are not" sections. Without rejection rules, anything becomes acceptable.
- Document with no examples. Rules without visual examples are abstract and ignored.
- Document with only examples. Examples without rules cannot be applied to new situations.
- Static PDF that no one opens. Ship the guide in the format the team uses daily (web page, Figma, Notion, etc.).
- No version history. When the brand evolves, no one knows which rules changed or when.
- Aspirational rules. Rules the brand does not actually follow get treated as suggestions. Document what is actually true, not what is wished.
- Treating "dos and don'ts" as filler. This section is what people use most. Invest in it.
Output format
Default output is a multi-section markdown document or a structured set of files, plus a presentation-ready version (web page, PDF, or Figma) for sharing with stakeholders.
Recommended structure:
brand/
style-guide.md (the canonical document)
story.md (or as a section)
logo/
construction.md
files/ (SVG, PNG, etc.)
colors.md
typography.md
imagery/
photography.md
illustration.md
icons/
icons.md
files/
voice.md
applications/
web.md
email.md
social.md
print.md
dos-and-donts.md
For consumer-facing presentation, build a web page version that imports from these source files. The source files are canonical. The presentation is a view of them.
Reference files
references/style-guide-template.md - Fillable section-by-section template.
references/maintenance-playbook.md - How to keep the guide current after launch.
1---2name: brand-style-guide3description: Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts. Use this skill whenever the user wants to create brand guidelines, document an existing brand, build a brand book, audit an existing style guide for completeness, or produce the artifact that other teams will reference for years. Triggers on style guide, brand guidelines, brand book, brand standards, brand manual, style sheet, brand documentation, brand reference. Also triggers when the brand identity is finished and needs to be documented for handoff to designers, developers, vendors, or future team members.4---5
6# Brand Style Guide
7
8Document the brand system so other people can use it without ambiguity. This is the artifact that lives longest. Designers, developers, agencies, and vendors will reference it for years. Build it like a reference manual, not a presentation.
9
10This skill assumes the brand identity is designed (run `brand-identity` first if not). The output of this skill is the canonical reference document.
11
12---
13
14## When to use
15
16- Creating brand guidelines for a finished identity
17- Documenting an existing brand that has no formal guide
18- Auditing an existing style guide for gaps or inconsistencies
19- Building a brand book to hand to vendors, partners, or new team members
20- Updating a guide after a major brand evolution
21
22## When NOT to use
23
24- The brand identity is not yet designed (use `brand-identity`)
25- Brand voice work specifically (use `brand-voice` for the voice doc, then integrate)
26- Building UI components (use `design-standards` or `design-system`)
27
28---
29
30## Required inputs
31
32- Finished brand identity (logo, colors, typography, imagery direction, motion principles)
33- Brand voice and tone documentation (or sufficient inputs to write a voice section)
34- Application examples that show the brand in real contexts
35- Decisions on what is mandatory vs flexible vs forbidden
36
37---
38
39## The framework: 8 sections
40
41A complete style guide has eight sections. Most guides skip 2 or 3 of them and create downstream confusion. Build all 8 from the start.
42
43### 1. Story
44The narrative behind the brand. Why it exists, what it stands for, what it rejects.
45
46- Origin / founding story
47- Mission and vision
48- Values (3 to 5, with what each means in practice)
49- Positioning statement
50- Audience (with the level of specificity from the brief)
51- What we are not (the things we explicitly reject)
52
53### 2. Logo system
54Every variant of every mark, with rules.
55
56- Primary logo (with construction grid showing relationships)
57- Wordmark
58- Symbol / glyph
59- Lockup variations (horizontal, stacked, etc.)
60- Monogram (if part of system)
61- Clear space rules (minimum spacing around logo)
62- Minimum sizes (smallest acceptable size for print and digital)
63- Acceptable color treatments (full color, single color, knock-out, reverse)
64- Forbidden treatments (stretching, rotating, recoloring, drop shadows, gradients - whatever is forbidden)
65- File formats and where to find them
66
67### 3. Color
68The full color system with rules.
69
70- Primary palette (signature colors)
71- Secondary palette
72- Neutrals scale
73- Semantic colors (success, warning, error, info)
74- Light mode and dark mode variants
75- Per color: hex, RGB, HSL, CMYK, Pantone (if print-relevant)
76- Contrast ratios documented
77- Allowed pairings
78- Forbidden pairings
79- Usage hierarchy (primary first, secondary supporting, neutrals dominant)
80
81### 4. Typography
82The full type system.
83
84- Display typeface (with sample sizes)
85- Body typeface (with sample sizes)
86- Monospace (if applicable)
87- Type scale (specific sizes used)
88- Weight and style usage (which weights for which contexts)
89- Line height ratios
90- Letter spacing standards
91- Web fallback stacks
92- Open-source alternatives for licensing-restricted contexts
93- Forbidden treatments (all caps overuse, fake italics, etc.)
94
95### 5. Imagery and illustration
96What pictures look like in this brand.
97
98- Photography direction with example library
99- Illustration style with example library
100- Iconography system with the full icon set (or rules for adding to it)
101- Forbidden imagery (stock photo cliches, specific things never to show)
102- Photo treatment rules (color treatment, crops, composition)
103
104### 6. Voice and tone
105How the brand sounds. (Pulled from `brand-voice` work if done separately.)
106
107- Voice attributes (3 to 5 adjectives with "we are X, not Y" framing)
108- Tone shifts by context (onboarding, error, marketing, support, legal)
109- Vocabulary preferences (words we use, words we avoid)
110- Grammar and style rules
111- Examples (good and bad copy side by side)
112
113### 7. Applications
114The brand applied to real contexts.
115
116- Web (homepage, product pages, blog template)
117- Email (template, signature, transactional)
118- Social (post templates, profile imagery, story formats)
119- Print (business cards, letterhead, print ads)
120- Packaging (if applicable)
121- Signage (if applicable)
122- Internal documents (slides, reports, proposals)
123- Each with examples showing what good looks like
124
125### 8. Dos and don'ts
126The boundaries, illustrated.
127
128- Logo dos and don'ts (visual examples of correct and incorrect use)
129- Color dos and don'ts (combinations to use, combinations to avoid)
130- Type dos and don'ts (treatments to use, treatments to avoid)
131- Composition dos and don'ts (layout patterns that work, ones that do not)
132- Voice dos and don'ts (phrases that fit, phrases that do not)
133
134The dos and don'ts section is what people actually reference in practice. Make it the easiest section to scan.
135
136---
137
138## Workflow
139
1401. **Inventory the inputs.** What identity work is finished? What voice work is finished? What is missing?
1412. **Confirm the format.** Is this a PDF, a web page, a Notion doc, a printed book, or all of the above? Different formats have different production requirements.
1423. **Section by section, draft.** Use the template in [`references/style-guide-template.md`](references/style-guide-template.md).
1434. **Stress-test with real examples.** For every rule, find a real application example. Rules without examples get ignored.
1445. **Get review from the people who will use it.** Designers, developers, marketers. They will surface gaps.
1456. **Version control.** Style guides evolve. Date the doc. Note what changed in each version.
1467. **Publish in the format the team will actually open.** A 200-page PDF that lives on a shared drive is dead weight. A web page or Figma file with a clear URL gets used.
147
148---
149
150## Failure patterns
151
152- **Skipping the "what we are not" sections.** Without rejection rules, anything becomes acceptable.
153- **Document with no examples.** Rules without visual examples are abstract and ignored.
154- **Document with only examples.** Examples without rules cannot be applied to new situations.
155- **Static PDF that no one opens.** Ship the guide in the format the team uses daily (web page, Figma, Notion, etc.).
156- **No version history.** When the brand evolves, no one knows which rules changed or when.
157- **Aspirational rules.** Rules the brand does not actually follow get treated as suggestions. Document what is actually true, not what is wished.
158- **Treating "dos and don'ts" as filler.** This section is what people use most. Invest in it.
159
160---
161
162## Output format
163
164Default output is a multi-section markdown document or a structured set of files, plus a presentation-ready version (web page, PDF, or Figma) for sharing with stakeholders.
165
166Recommended structure:
167
168```
169brand/
170 style-guide.md (the canonical document)
171 story.md (or as a section)
172 logo/
173 construction.md
174 files/ (SVG, PNG, etc.)
175 colors.md
176 typography.md
177 imagery/
178 photography.md
179 illustration.md
180 icons/
181 icons.md
182 files/
183 voice.md
184 applications/
185 web.md
186 email.md
187 social.md
188 print.md
189 dos-and-donts.md
190```
191
192For consumer-facing presentation, build a web page version that imports from these source files. The source files are canonical. The presentation is a view of them.
193
194---
195
196## Reference files
197
198- [`references/style-guide-template.md`](references/style-guide-template.md) - Fillable section-by-section template.
199- [`references/maintenance-playbook.md`](references/maintenance-playbook.md) - How to keep the guide current after launch.