.cursor/skills/brand-guide-creation/SKILL.md
Create, critique, or refresh brand guides and brand guideline documents through a collaborative workflow. Use when the user wants to build brand guidelines, brand books, style guides, tone-of-voice docs, logo and visual identity rules, messaging systems, or a full brand manual. Starts with discovery, anchors on local branding assets, then drafts a practical, example-heavy guide with governance, templates, and real usage guidance. Includes procedural visual system rules, AI-readiness layer for design tokens and prompt constraints, and a 7-layer quality audit for digital products.
npx skillsauth add alexwox/genesis-template brand-guide-creationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create brand guides that are executable, not decorative.
The output should help a new employee, contractor, founder, or agency partner make on-brand decisions quickly without asking for permission on every asset.
Use this skill when the user asks to:
Trigger aliases:
/brand-guide/brand-guidelinesAnchor on local assets before broad advice:
outputs/book-summaries/100m-branding-playbook.mdoutputs/book-summaries/100m-marketing-machine.mdUse those sources to keep the guide tied to:
If the user asks for benchmarks, examples, or "deep research," also use the deep-web-research skill.
Default to a balanced collaborative workflow:
Do not jump straight to colors and logos if positioning, audience, or desired associations are still fuzzy.
Ask for the minimum needed to make strong decisions:
High-leverage optional inputs:
If information is missing, ask only the highest-leverage questions first.
Determine which path fits:
new-brand: little or no prior brand system existsrefresh: brand exists but needs clearer rules and consistencyaudit: user already has a guide and wants critique or improvementrebrand: positioning, audience, or associations are changing materiallyBefore drafting, lock these decisions:
Audience: who the brand is forPositioning: what niche or role the brand occupiesPromise: what value the brand reliably signalsAssociations to own: what people should mentally group the brand withAssociations to avoid: what would make the brand feel off-strategyProof: what evidence makes the promise believableIf these are weak, the guide will become decorative and generic.
Near-miss counter-example: A brand locks all six spine decisions: clear audience (mid-market SaaS ops teams), sharp positioning (the automation layer between tools), a strong promise (10x fewer manual handoffs), deliberate associations to own (Zapier-level simplicity for enterprise workflows), associations to avoid (consulting-heavy, slow implementations). The spine looks complete and specific. But the Proof field says "our customers love us" and "great support." No named testimonials, no specific metrics, no case studies. The guide that follows has a strong voice, a clear visual identity, and zero concrete trust evidence — every proof placeholder gets filled with stock language. Fix: proof must be specific and reusable — named customers, quoted outcomes, and documented metrics (e.g., "Acme Corp reduced handoff errors 73% in 6 weeks").
Create guidance in four layers:
Brand coreVerbal systemVisual systemOperating systemThe operating system matters more than most people expect. Include governance, templates, asset locations, and approval rules so the guide is actually usable.
Use the structure in BRAND-GUIDE-TEMPLATE.md.
Default rule:
Before finalizing, ask:
If the answer is no to any of these, the guide is not strong enough yet.
If the brand has a website, app, or digital product, also run this checklist before finalizing. These seven layers are where professional design diverges most sharply from AI-generated defaults:
If any gate fails, return to the relevant visual system procedure and complete the fill-in-the-blank fields.
Unless the user explicitly wants a smaller deliverable, include:
Guide purpose and scopeBrand coreAudience and positioningAssociations to own and avoidVoice and toneMessaging pillarsLogo systemColor systemTypographyImagery, illustration, iconography, and motionChannel rulesTemplates and examplesGovernanceDo not accept vague language like:
Convert abstract traits into:
Separate:
voice: stable personalitytone: context-specific adjustmentNear-miss counter-example: A brand defines three clear voice traits (Confident, Precise, Warm) with do/avoid word lists and example rewrites for each. The voice section looks complete. But the guide never defines how tone shifts by context — so the same casual, warm register is used in marketing copy, legal disclaimers, error messages, and password-reset emails. A support email about a billing dispute reads like a marketing newsletter. Fix: add a tone-by-context table that specifies how traits flex up or down for each channel (sales, product UI, support, legal, internal).
The visual system is where brand guides most often fail. Generic rules like "specify approved variants" produce generic output. Each subsystem below has a fill-in-the-blank procedure that must be completed before drafting visual rules.
For logo rules specifically: specify approved variants, include usage rules, include misuse examples, and connect rules to channels where they matter. The procedures below cover the five subsystems where guides need to go beyond declarative rules.
Implementation depth: This skill defines WHAT values the brand should use. For HOW to implement those values in code — animation timing, component state systems, skeleton patterns, shadow layering, GPU performance, and the 50+ polish details that separate professional products from amateur ones — reference the product-craft skill.
Before choosing colors, fill in:
Worked example — Linear:
| Field | Value |
|---|---|
| Personality | Serious, exact, crafted |
| Mood | Cool neutral, desaturated |
| Action color | Desaturated blue oklch(0.546 0.14 258) — used only for selected states and primary actions |
| Structural colors | Nordic Gray #222326 (text), Mercury White #F4F5F8 (light surfaces) |
| Surface hierarchy | Background 12% → Card 15% → Popover 19% → Modal 22% lightness (LCH-based, generated from 3 inputs) |
| Dark mode | Primary design target; light mode is the override |
| Contrast | 4.5:1 minimum for body, 3:1 for large text |
Near-miss counter-example: A B2B SaaS brand picks a strong, distinctive color palette: deep teal action color, warm gray neutrals, graduated dark-mode surfaces. The palette is well-designed. But the guide doesn't restrict the action color to interactive elements only — designers start using teal for section backgrounds, decorative borders, and icon fills. Within three months, the CTA button no longer stands out on any page because teal is everywhere. Conversion on the main pricing page drops 18% and nobody connects it to the color drift. Fix: add the rule "action color appears only on clickable elements" and list specific misuse examples showing the color on non-interactive surfaces.
Before choosing fonts, fill in:
Worked example — Linear:
| Field | Value |
|---|---|
| Personality | Serious, exact |
| Category | Sans-serif (modern, technical) |
| Heading font | Inter Display (adds expression while maintaining readability) |
| Body font | Inter |
| Weight contrast | 400 (body) vs 700 (headings) |
| Body size | 13px, line-height 1.4–1.5, max-width 65ch |
| Letter-spacing | tracking-tight (-0.02em) on headings, neutral on body |
| Avoid | System defaults without explicit selection |
Near-miss counter-example:
A brand guide specifies Instrument Serif for headings and Inter for body — a distinctive, well-chosen pairing. The font section looks complete. But the guide doesn't specify max-width for body text or adjust line-height from the framework default (1.5). On desktop, body paragraphs stretch to 120+ characters per line with tight leading, making long-form content exhausting to read. The typography looks professional in hero sections but breaks down in documentation and blog posts. Fix: add max-width: 65ch for body containers and line-height: 1.6–1.7 for body text.
Before defining layout rules, fill in:
Worked example — Linear:
| Field | Value | |---|---| | Base unit | 4px | | Tight grouping | 4–8px | | Standard gap | 16–24px | | Generous | 32–48px | | Border radius | 6px (buttons/inputs), 8px (cards/panels), 12px (modals/dialogs) |
Anti-pattern: Uniform padding: 16px and gap: 24px everywhere with no variation. This creates mechanical, flat layouts where nothing feels grouped or separated — every element has equal visual weight regardless of its relationship to other elements.
Before defining motion rules, fill in:
Worked example — Linear:
| Field | Value |
|---|---|
| Easing | cubic-bezier(0.16, 1, 0.3, 1) ease-out |
| Fast | 100ms |
| Standard | 150ms |
| Slow | 250ms |
| Required states | hover, active (scale-0.98), focus (visible ring), disabled (reduced opacity), loading (inline indicator) |
Anti-pattern: Fade-in as the only animation, applied identically to every element on page load. Professional products use varied, purposeful motion: cards lift on hover, lists stagger on reveal, panels slide in from their origin direction.
Before defining surface rules, fill in:
Anti-pattern: Binary surfaces — one background color and one card color with nothing in between. Professional products use 3–5 graduated surface levels where each elevation step has a distinct lightness value and shadow treatment.
A signature visual is a single distinctive, branded element that an AI coding tool would never generate unprompted. It passes the 50ms trust gate, triggers the Von Restorff effect (200–300% better recall for distinctive elements), and does persuasion work — not just decoration. Not every brand needs one, but every brand should make a deliberate decision.
Before defining rules, fill in:
Decision gate — when a signature visual is warranted:
The gimmick-vs-signature test: Before committing, answer three questions. If any answer is "no," the element is a gimmick, not a signature moment:
Worked example — SuperShrimp:
| Field | Value | |---|---| | Type | Brand character (shrimp) + scroll-driven product demo (laptop) | | Character personality | Self-deprecating, motivational, gamified | | Relationship to product | The shrimp IS the posture metaphor — "stop sitting like a shrimp" | | Persuasion job | Laptop scroll demonstrates the product in context (user sees the app running on a laptop as they scroll) | | Usage contexts | Landing page hero, in-app avatar, leaderboard, social media | | Usage exclusions | Legal pages, invoices, formal partner communications | | Performance | Character is CSS/emoji-based (near-zero weight); laptop scroll uses lightweight scroll-triggered animation |
Near-miss counter-example: A B2B analytics startup creates an elaborate 3D mascot (a friendly robot) with WebGL animations on the landing page. The robot is beautifully rendered, has idle animations, and reacts to cursor movement. The visual craft is high. But the robot has no connection to the product (dashboards), the audience (data analysts who value precision over whimsy), or the brand promise (accurate forecasting). It adds 2.3 seconds to LCP on mobile. The mascot gets internal praise ("it looks so cool") but analytics show 40% of mobile visitors bounce before the hero finishes loading, and the brand is remembered as "the one with the robot" rather than "the accurate forecasting tool." Fix: the signature visual must serve the brand promise, not just demonstrate craft. If the product is about precision, the signature visual should demonstrate precision — not friendliness.
If the user has digital products, the visual system must produce outputs that feed directly into a design system:
Brand guides are now AI infrastructure. Without explicit visual constraints, AI coding tools (Cursor, Lovable, Bolt.new, Claude Code) default to the statistical average of their training data: Inter font, blue-to-purple gradients, Lucide icons, uniform spacing, and shadcn/ui components used without customization. Anthropic calls this distributional convergence — LLMs sample from the probability center of web training data, and safe, generic design choices dominate that center.
A brand guide that only works for humans reading a PDF misses its highest-leverage use case: serving as the constraint input that prevents AI tools from producing generic output.
For every brand with digital products, the guide must produce two AI-consumable outputs:
A CSS custom properties block (or Tailwind config) containing every value from the visual system. This block can be pasted directly into a project's stylesheet or handed to an AI coding tool.
:root {
--color-action: [action color hex];
--color-bg: [background hex];
--color-card: [card surface hex];
--color-text: [primary text hex];
--color-text-muted: [secondary text hex];
--color-border: [border hex];
--font-heading: [heading font stack];
--font-body: [body font stack];
--radius-sm: [small radius]px;
--radius-md: [medium radius]px;
--radius-lg: [large radius]px;
--space-tight: [tight grouping]px;
--space-standard: [standard gap]px;
--space-generous: [generous breathing room]px;
--ease-default: [easing function];
--duration-fast: [fast]ms;
--duration-standard: [standard]ms;
--duration-slow: [slow]ms;
}
A short markdown block optimized for AI context. Paste this into system prompts, Cursor rules, or Claude skills to steer AI output toward the brand's visual identity.
Fill in:
## Visual identity constraints
Personality: [1–3 words]
Mood: [warm/cool/neutral, saturated/muted]
Fonts: [heading font] for headings, [body font] for body text. Never use: [avoid list].
Colors: Action [hex], background [hex], card [hex], text [hex], border [hex].
Dark mode: [primary / override].
Spacing: [base unit]px base. Tight [X]px, standard [Y]px, generous [Z]px.
Radius: small [A]px, medium [B]px, large [C]px.
Motion: [easing function], fast [X]ms, standard [Y]ms, slow [Z]ms.
Reference products: [2–3 products whose design quality to match]
Avoid: [specific patterns to never use — e.g., "purple gradients, centered three-column feature grids, generic hero with gradient text"]
Worked example — B2B analytics brand:
## Visual identity constraints
Personality: Precise, calm, trustworthy
Mood: Cool neutral, muted
Fonts: IBM Plex Sans for headings, Inter for body. Never use: Roboto, Open Sans, system defaults without explicit selection.
Colors: Action #2563EB, background #09090B, card #111113, text #E4E4E7, border #27272A.
Dark mode: primary.
Spacing: 4px base. Tight 8px, standard 24px, generous 48px.
Radius: small 4px, medium 8px, large 12px.
Motion: cubic-bezier(0.16, 1, 0.3, 1), fast 100ms, standard 150ms, slow 250ms.
Reference products: Linear, Vercel, Raycast
Avoid: purple gradients, Lucide icons without customization, centered cards with uniform padding, fade-in as the only animation, shadcn/ui components used with zero brand adaptation.
Use Hormozi's branding and marketing-machine lens:
Good brand guides do not only describe how the brand looks. They also define how the brand earns trust.
Brand consistency is not a feel-good exercise. It is a measurable conversion lever. This section provides the specific mechanisms through which branding decisions directly affect conversion rates, trust formation, and revenue — and should be incorporated into every brand guide.
Use these numbers to justify brand investment internally. Brand consistency is not about aesthetics — it is about reducing the mental effort required to trust and buy.
Visitors form opinions about websites in 50 milliseconds — before any copy is read. Visual design quality is the first and fastest trust signal. Colors, typography, layout quality, and professional imagery either pass or fail this gate instantly.
Implications for brand guides:
When creating the brand guide color system, explicitly define:
When creating the brand guide typography system, specify:
Use this checklist in the brand guide to ensure consistency across all landing pages and marketing surfaces:
Each inconsistency is a micro-erosion of trust. Visitors cannot articulate why a page "feels off," but the conversion data will show it.
Define in every brand guide which brand decisions directly affect landing page conversion. Make these explicit so that landing page builders (whether internal team, agency, or AI) can apply them without guessing:
| Brand Guide Decision | Landing Page Impact | |---|---| | Headline voice (traits, vocabulary) | Determines headline tone and word choice on every page | | CTA tone (confident, casual, urgent) | Determines button text style across all pages | | Action color | Determines CTA button color (must be consistent) | | Proof asset library | Determines which testimonials, logos, and metrics appear on pages | | Association strategy | Determines which third-party logos, certifications, and media mentions to feature | | Imagery style | Determines hero images, product photos, and illustration treatment | | Trust badge selection | Determines which security, compliance, and review badges to display |
Apply Hormozi's deliberate association framework (from $100M Branding Playbook):
The brand should be deliberately paired with things the target avatar already trusts, follows, and values. On landing pages, this means:
Bad association: random Fortune 500 logos that don't match the avatar's world. Good association: specific peer companies, trusted publications, and relevant certifications that make the avatar think "these are my people."
The brand guide should define a systematic process for capturing and reusing trust assets, not leave proof to ad-hoc collection:
Capture cadence:
Proof asset types to maintain:
Proof-by-channel guidance:
Define which proof assets are approved for public use, which require customer consent refresh, and who maintains the proof library.
Use when the user wants to co-create the guide live.
Process:
Use when the user wants speed.
Produce:
Open Questions section listing what to validateUse when the user already has a brand guide.
Produce:
Do not finalize a guide unless it passes all of these:
Avoid:
indigo-500 default propagated through training data at massive scale. Every visual decision in the guide should deviate from at least 3 of these defaults. If it doesn't, revisit the visual system procedures.When delivering a full guide or major section, use:
# [Brand Name] Brand Guide
## Executive summary
[1 short paragraph]
## Brand core
## Audience and positioning
## Verbal identity
## Visual identity
## Channel guidance
## Templates and proof assets
## Governance
## Open questions
tools
Translate role-based organizations into workflow-based organizations by decomposing roles into scored tasks, extracting dark playbooks (proprietary tacit knowledge), formalizing workflows, calculating automation ROI, and producing a sequenced automation roadmap. Use when a company wants to identify what work can be automated, extract undocumented expert knowledge, or build an automation strategy.
development
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
development
Builds stakeholder-friendly project status updates from markdown sources. Use when asked for progress reports, implementation status, future plans, UI/UX flow summaries, infrastructure/data-flow summaries, risks, code smells, or scout-principle improvement notes.
development
Repeatable playbook for finding and interviewing key stakeholders to validate an offer pillar hypothesis. Produces a pain proximity map, target list, outreach plan, interview protocol, and structured synthesis of findings. Use when a hypothesis needs human validation before building.