brand-systems
Building comprehensive brand identity systems from strategy to implementation. Covers logo design, color palettes, typography pairing, voice guidelines, and system documentation. Use when creating new brands, rebranding, or systematizing existing identities.
What this skill does
# Brand Systems
A brand is a promise made visible. Brand systems are the rules that ensure that promise is kept consistently.
## When to Use This Skill
- Creating a new brand identity
- Rebranding or refreshing an existing identity
- Building brand guidelines documentation
- Systematizing ad-hoc brand elements
- Training others on brand application
## Brand System Components
### 1. Strategy Layer (Foundation)
#### Positioning Statement
```
For [target audience]
Who [statement of need]
[Brand] is a [category]
That [key benefit]
Unlike [competitors]
We [key differentiator]
```
#### Brand Pillars
1. **Purpose**: Why we exist beyond profit
2. **Vision**: The future we're creating
3. **Mission**: How we'll get there
4. **Values**: What we believe (3-5 core values)
#### Brand Personality
Define 3-5 adjectives with behavioral examples:
| Trait | What It Means | What It Doesn't Mean |
|-------|---------------|----------------------|
| Bold | Take clear positions | Aggressive/reckless |
| Approachable | Warm and welcoming | Unprofessional |
| Innovative | Forward-thinking | Gimmicky |
#### Brand Archetype
Choose primary (and optional secondary) from:
| Archetype | Core Desire | Voice Character |
|-----------|-------------|-----------------|
| Sage | Truth | Knowledgeable, analytical |
| Innocent | Safety | Optimistic, simple |
| Explorer | Freedom | Adventurous, authentic |
| Ruler | Control | Authoritative, refined |
| Creator | Innovation | Imaginative, visionary |
| Caregiver | Service | Nurturing, supportive |
| Magician | Transformation | Visionary, charismatic |
| Hero | Mastery | Courageous, determined |
| Outlaw | Liberation | Rebellious, disruptive |
| Lover | Intimacy | Passionate, sensual |
| Jester | Enjoyment | Playful, irreverent |
| Everyman | Belonging | Friendly, humble |
---
### 2. Visual Identity Layer
#### Logo System
**Logo Types**:
| Type | Description | Example |
|------|-------------|---------|
| Wordmark | Name as logo | Google, Coca-Cola |
| Lettermark | Initials | IBM, HBO |
| Symbol | Abstract mark | Nike, Apple |
| Combination | Symbol + wordmark | Adidas, Lacoste |
| Emblem | Text inside symbol | Starbucks, NFL |
**Logo Requirements**:
- Works at 16px favicon size
- Works on dark and light backgrounds
- Recognizable in B&W
- No gradients that break in print
- Clear space rules defined
**Logo Lockups**:
```
[Symbol] [Symbol][Wordmark] [Wordmark]
[Symbol]
Symbol Horizontal Stacked
Only Lockup Lockup
```
**Clear Space**:
Define minimum space around logo (typically height of a logo element):
```
┌──────────────────────────────┐
│ │
│ ┌──────────────────┐ │
│ │ │ │
│ │ LOGO │ │ ← Clear space = 'X'
│ │ │ │ (defined by logo element)
│ └──────────────────┘ │
│ │
└──────────────────────────────┘
```
#### Color Palette
**Primary Palette**:
```
Primary:
Name: [Descriptive name, e.g., "Trust Blue"]
Hex: #2563eb
RGB: 37, 99, 235
HSL: 221, 83%, 53%
Tailwind: blue-600
Usage: CTAs, links, primary actions
Accessible on: white (4.5:1), gray-50 (4.2:1)
```
**Extended Palette**:
- Primary shades (50-950 scale)
- Secondary color (with shades)
- Accent color (high contrast)
- Neutral scale (gray tones)
- Semantic colors (success, warning, error, info)
**Color Proportions**:
```
60% - Dominant (backgrounds, large areas)
30% - Secondary (supporting elements)
10% - Accent (highlights, CTAs)
```
**Dark Mode Considerations**:
```
Light Mode Dark Mode
white → gray-900
gray-50 → gray-800
gray-900 → white
blue-600 → blue-400
```
#### Typography System
**Type Scale**:
```javascript
const typeScale = {
xs: '0.75rem', // 12px - captions
sm: '0.875rem', // 14px - secondary text
base: '1rem', // 16px - body
lg: '1.125rem', // 18px - lead text
xl: '1.25rem', // 20px - h4
'2xl': '1.5rem', // 24px - h3
'3xl': '1.875rem', // 30px - h2
'4xl': '2.25rem', // 36px - h1
'5xl': '3rem', // 48px - display
'6xl': '3.75rem', // 60px - hero
};
```
**Font Pairing Principles**:
| Approach | Example | Effect |
|----------|---------|--------|
| Contrast | Serif heading + sans body | Classic, editorial |
| Complement | Geometric heading + humanist body | Modern, friendly |
| Superfamily | Same family, different weights | Unified, systematic |
**Recommended Pairs**:
- **Editorial**: Playfair Display + Source Sans Pro
- **Modern**: Outfit + Inter
- **Technical**: Space Grotesk + IBM Plex Sans
- **Elegant**: Cormorant Garamond + Lato
- **Startup**: Cal Sans + Geist
#### Imagery & Iconography
**Photography Style**:
- Subject matter guidelines
- Color treatment (natural, saturated, muted)
- Composition preferences
- Mood and lighting
- What to avoid
**Icon System**:
```
Style: [Outlined | Filled | Duotone]
Stroke weight: [1.5px | 2px | 2.5px]
Corner radius: [0 | 2px | rounded]
Grid: [24x24 | 16x16]
Source: [Lucide | Heroicons | Phosphor | Custom]
```
**Illustration Style** (if applicable):
- Style references
- Color usage
- Line weight
- Level of detail
- Character guidelines
---
### 3. Voice Layer
#### Voice Attributes
Define 3-4 constant personality traits:
```
We are:
1. [Trait 1] - [What this means in practice]
2. [Trait 2] - [What this means in practice]
3. [Trait 3] - [What this means in practice]
We are NOT:
1. [Anti-trait 1]
2. [Anti-trait 2]
3. [Anti-trait 3]
```
#### Tone Variations
Voice is constant; tone adapts to context:
| Context | Tone Adjustment | Example |
|---------|-----------------|---------|
| Welcome | Warm, enthusiastic | "Welcome! We're excited to have you." |
| Error | Calm, helpful | "Something went wrong. Here's how to fix it." |
| Success | Celebratory, brief | "Done! Your changes are live." |
| Tutorial | Patient, encouraging | "Let's walk through this together." |
| Legal | Clear, direct | "By continuing, you agree to our terms." |
#### Writing Guidelines
- Sentence length preferences
- Active vs. passive voice
- Punctuation style
- Capitalization rules
- Words to use/avoid
- Jargon policy
---
### 4. System Layer
#### Design Tokens
```javascript
// tokens.js
export const tokens = {
colors: { /* color definitions */ },
typography: { /* font definitions */ },
spacing: {
xs: '0.25rem', // 4px
sm: '0.5rem', // 8px
md: '1rem', // 16px
lg: '1.5rem', // 24px
xl: '2rem', // 32px
'2xl': '3rem', // 48px
'3xl': '4rem', // 64px
},
radii: {
sm: '0.25rem',
md: '0.5rem',
lg: '0.75rem',
xl: '1rem',
full: '9999px',
},
shadows: { /* shadow definitions */ },
transitions: {
fast: '150ms ease-out',
normal: '200ms ease-out',
slow: '300ms ease-out',
},
};
```
#### Component Patterns
Document common component patterns:
```markdown
## Button
### Variants
- Primary: Main actions
- Secondary: Alternative actions
- Ghost: Tertiary actions
- Destructive: Dangerous actions
### Sizes
- sm: Compact contexts
- md: Default
- lg: Prominent placement
### States
- Default
- Hover
- Active/Pressed
- Focus (keyboard)
- Disabled
- Loading
```
#### Layout Patterns
- Grid system (12-column, gutters)
- Breakpoints
- Container widths
- Section spacing
---
### 5. Application Layer
#### Touchpoint Guidelines
Document brand application for:
- Website
- Mobile app
- Email templates
- Social media profiles
- Presentation templates
- Print materials
- Packaging (if applicable)
- Environmental/signage
#### Do's and Don'ts
Visual examples of correct and incorrect usage:
```
✓ DO ✗ DON'T
─────────────────────────────────────────
Logo on white background Logo on busy photo
Logo with clear space Logo crowdedRelated in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".