skills/peterhdd/agent-skills/design-brand-guardian

design-brand-guardian

SKILL.md

Brand Identity Guide

Overview

This guide covers the end-to-end process of building and enforcing a brand identity system: from strategic positioning through visual tokens, voice guidelines, logo rules, and accessibility compliance. All outputs should be developer-ready with real values, not placeholders.

Brand Foundation Process

1. Discovery

  • Identify target audience, competitive landscape, and business objectives.
  • Audit existing brand assets (if any) for consistency gaps.
  • When creating a brand from scratch, start with positioning (audience, differentiator, personality) before any visual work.

2. Foundation

  • Define positioning, values, and personality before any visual work.
  • Write voice guidelines with a tone table and vocabulary lists.
  • Voice guidelines must include do/don't examples for each tone variation.

3. Visual System

  • Create color tokens with real hex values, not placeholders.
  • Define typography stack with web-safe fallbacks. Typography stacks should include at least two fallback fonts.
  • Specify logo usage rules with minimum sizes and clear-space ratios.
  • Verify every text/background pairing against WCAG AA (4.5:1 for normal text, 3:1 for large text).
  • Every brand element should reinforce the positioning strategy.

4. Enforcement

  • Review new assets against the brand guide checklist: palette, typography, voice, logo rules.
  • Flag deviations with the specific rule violated and a compliant alternative.
  • When a stakeholder requests an off-brand element, explain the brand rationale and offer a compliant alternative.

How to Handle Brand Evolution

  • When a brand needs to evolve, change the minimum number of tokens required to achieve the new positioning. Avoid full redesigns unless the current system cannot express the new direction.
  • When extending a brand to a new product line, reuse the core palette and voice but allow a unique accent color and sub-personality within the defined spectrum.

How to Audit an Asset for Brand Compliance

Check the following in order:

  1. Colors are within the defined palette.
  2. Typography uses approved families.
  3. Voice matches the context-appropriate tone.
  4. Logo usage falls within clear-space rules.

When brand guidelines conflict with usability, propose a solution that satisfies both before compromising either.

Scripts

The following scripts are available in the scripts/ directory for automated brand work:

scripts/check_contrast.py

WCAG 2.1 contrast ratio checker. Validates foreground/background color pairs against AA and AAA criteria for normal and large text.

python scripts/check_contrast.py --fg "#0F172A" --bg "#FFFFFF"
python scripts/check_contrast.py --file color_pairs.json --json

scripts/generate_tokens.py

Generates a full design token color scale (50-900), neutral scale, and semantic colors (success, warning, error, info) from a single primary hex color. Outputs CSS custom properties or JSON.

python scripts/generate_tokens.py "#3B82F6"
python scripts/generate_tokens.py "#3B82F6" --format json

See Meridian Analytics Example for a complete, production-ready brand guide demonstrating the expected structure and level of detail for all brand work.

Weekly Installs
3
GitHub Stars
7
First Seen
12 days ago
Installed on
mcpjam3
claude-code3
replit3
junie3
windsurf3
zencoder3