Get the FREE Ultimate OpenClaw Setup Guide →

brand-guidelines

Scanned
npx machina-cli add skill anilcancakir/claude-code-plugins/brand-guidelines --openclaw
Files (1)
SKILL.md
7.8 KB

Brand Guidelines Skill

Create comprehensive, platform-agnostic brand guidelines using Jungian archetypes and color psychology.

Purpose

Define brand IDENTITY that works across ALL platforms:

  • Web (any framework)
  • Mobile (iOS, Android, Flutter)
  • Print (marketing materials)
  • Social media

Output: HEX colors and font names, NOT framework-specific code.

The 12 Brand Archetypes

ArchetypeCore DesireBrand VoiceColor Direction
InnocentSafety, happinessOptimistic, simple, honestSoft pastels, white, sky blue
SageKnowledge, truthExpert, clear, trustworthyDeep blues, greens, gray
ExplorerFreedom, discoveryAdventurous, independentEarth tones, rust, forest
OutlawRevolution, liberationBold, rebellious, provocativeBlack, red, orange
MagicianTransformationVisionary, inspiring, mysteriousPurple, deep blue, gold
HeroMastery, courageEmpowering, confident, directRed, blue, gold
LoverIntimacy, experiencePassionate, sensual, elegantRed, pink, burgundy
JesterJoy, funPlayful, irreverent, entertainingBright, varied, yellow
EverymanBelongingRelatable, honest, friendlyNeutral, warm brown, earth
CaregiverService, nurturingCompassionate, supportive, warmSoft blue, green, white
RulerControl, powerAuthoritative, refined, premiumNavy, gold, burgundy
CreatorInnovation, expressionImaginative, artistic, expressiveVaried, artistic, bold

Archetype Selection by Product Type

Product TypePrimarySecondaryWhy
B2B SaaSSageMagicianTrust + transformation
Developer ToolsSageCreatorKnowledge + innovation
E-commerceEverymanCaregiverAccessible + supportive
FintechRulerSageAuthority + expertise
Health/WellnessCaregiverInnocentCare + purity
Creative ToolsCreatorMagicianExpression + transformation
EnterpriseHeroRulerAchievement + authority
Consumer AppJesterEverymanFun + relatable
LuxuryRulerLoverPremium + desire

Color Palette Creation

Step 1: Choose Primary Color

Based on archetype, select a primary hue:

ArchetypeRecommended HuesPsychology
SageBlue (200-240)Trust, expertise, calm
MagicianPurple (260-290)Mystery, transformation
HeroRed (0-15) or Blue (210-230)Energy, confidence
RulerNavy (220-240) or Gold (40-50)Authority, premium
CreatorAny bold colorCreativity, uniqueness

Step 2: Generate 9-Shade Scale

Use HSL to create shades from a base color:

ShadeLightnessSaturation AdjustUsage
5097%-5%Lightest backgrounds
10094%-5%Light backgrounds
20086%-3%Light accents
30074%0%Borders
40060%0%Disabled states
50050%BasePrimary (base)
60042%+3%Hover states
70034%+5%Active/pressed
80026%+5%Dark accents
90018%+5%Darkest

Step 3: Add Semantic Colors

RoleHEX ExampleUsage
Success#10B981Confirmations, positive feedback
Warning#F59E0BCaution, attention needed
Error#EF4444Errors, destructive actions
Info#3B82F6Neutral information

Step 4: Create Neutral Grays

Add brand tint to neutral grays:

  • Cool tint (blue): Professional, tech
  • Warm tint (yellow/brown): Friendly, approachable

Typography Guidelines

Font Pairing by Archetype

ArchetypeHeading StyleBody StyleExamples
SageGeometric sans or serifClean sansInter, Source Sans Pro
MagicianModern sansSystem stackManrope, Plus Jakarta Sans
HeroBold sansClean sansMontserrat, Roboto
RulerElegant serifRefined sansPlayfair Display, Lora
CreatorDisplay/artisticReadable sansSpace Grotesk, Poppins
EverymanFriendly sansSystem stackNunito, Open Sans
JesterPlayful/roundedFriendly sansNunito, Quicksand

Type Scale (4px Baseline)

NameSizeWeightLine HeightUsage
xs12px40016pxCaptions, footnotes
sm14px40020pxLabels, metadata
base16px40024pxBody text
lg18px40028pxLead paragraphs
xl20px60028pxSmall headings
2xl24px60032pxSection headings
3xl30px70036pxPage titles
4xl36px70040pxHero headings
5xl48px70048pxDisplay

Voice & Tone by Archetype

Sage Voice

  • Tone: Expert but accessible
  • Do: Explain complex topics simply, cite evidence, be precise
  • Don't: Be condescending, use jargon without explanation

Magician Voice

  • Tone: Visionary and inspiring
  • Do: Paint possibilities, use transformative language
  • Don't: Over-promise, be vague about how

Hero Voice

  • Tone: Empowering and confident
  • Do: Challenge and motivate, celebrate achievement
  • Don't: Be aggressive, diminish struggles

Ruler Voice

  • Tone: Authoritative and refined
  • Do: Be confident, use premium language
  • Don't: Be elitist, talk down to users

Creator Voice

  • Tone: Imaginative and expressive
  • Do: Inspire creativity, celebrate uniqueness
  • Don't: Be pretentious, dismiss simplicity

Everyman Voice

  • Tone: Relatable and honest
  • Do: Use everyday language, be authentic
  • Don't: Try too hard to be cool, be generic

brand.md Output Format

# Brand Guidelines

> [Project Name] Brand Identity

## Brand Personality

**Primary Archetype**: [Name] (70%)
[Brief description]

**Secondary Archetype**: [Name] (30%)
[Brief description]

## Core Values

1. **[Value]**: [What it means]
2. **[Value]**: [What it means]
3. **[Value]**: [What it means]

## Color Palette

### Primary Colors

| Name | HEX | Usage |
|------|-----|-------|
| Primary | #XXXXXX | CTAs, key elements |
| Secondary | #XXXXXX | Supporting elements |
| Accent | #XXXXXX | Highlights |

### Primary Scale

| Shade | HEX | Usage |
|-------|-----|-------|
| 50 | #XXXXXX | Lightest backgrounds |
| ... | ... | ... |
| 900 | #XXXXXX | Darkest |

### Semantic Colors

| Role | HEX | Usage |
|------|-----|-------|
| Success | #XXXXXX | Confirmations |
| Warning | #XXXXXX | Cautions |
| Error | #XXXXXX | Errors |
| Info | #XXXXXX | Information |

## Typography

### Font Stack
- **Headings**: [Font Name]
- **Body**: [Font Name]
- **Monospace**: [Font Name]

### Type Scale
[Type scale table]

## Voice & Tone

### Brand Voice
- [Attribute]: [Description]

### Tone by Context
| Context | Tone | Example |
|---------|------|---------|
| Marketing | [Tone] | "[Example]" |
| UI | [Tone] | "[Example]" |
| Errors | [Tone] | "[Example]" |

### Writing Guidelines

**Do:**
- [Guideline]

**Don't:**
- [Anti-pattern]

Color Accessibility

Ensure WCAG AA compliance:

  • Normal text: 4.5:1 contrast ratio
  • Large text: 3:1 contrast ratio
  • UI elements: 3:1 contrast ratio

Test combinations:

  • Light text on dark backgrounds
  • Dark text on light backgrounds
  • Buttons and interactive elements

References

For detailed archetype color palettes and examples:

Source

git clone https://github.com/anilcancakir/claude-code-plugins/blob/main/project-optimizer/skills/brand-guidelines/SKILL.mdView on GitHub

Overview

Create platform-agnostic brand guidelines using Jungian archetypes and color psychology. Output HEX colors and font names for web, mobile, print, and social materials, without framework-specific code.

How This Skill Works

The skill maps each archetype to a color direction and brand voice, then translates that into a cohesive palette and typography. It outputs a primary color, a 9-shade scale via HSL, semantic colors (success, warning, error, info), and neutral grays, all as HEX and font names for cross-platform use.

When to Use It

  • Launching a cross-platform brand across web, mobile, print, and social
  • Running /my_brand to generate brand guidelines
  • Creating a brand.md with platform-agnostic specs
  • Selecting a color palette aligned to a chosen archetype
  • Defining typography and voice guidelines for consistent brand personality

Quick Start

  1. Step 1: Choose a primary color based on archetype (e.g., Sage → blue 200-240; Magician → purple 260-290; Hero → red/blue 0-15/210-230)
  2. Step 2: Generate a 9-shade scale using the base color with the provided Lightness and Saturation adjustments
  3. Step 3: Add semantic colors (Success, Warning, Error, Info) and create neutral grays; export HEX codes and font names for web, mobile, print, and social

Best Practices

  • Align the archetype with product type using the Archetype Selection by Product Type table
  • Define color direction, voice, and typography per archetype
  • Build a 9-shade color scale from the chosen primary color using the provided Lightness and Saturation adjustments
  • Create neutral grays with cool tint for tech brands or warm tint for approachable brands
  • Deliver platform-agnostic outputs (HEX colors and font names) rather than framework code

Example Use Cases

  • Fintech brand using Sage + Ruler with navy and gold palette and a clean sans-serif for authority and premium feel
  • Creative tools brand using Creator + Magician with bold purples and gold and expressive typography
  • Health/Wellness brand using Caregiver + Innocent with soft blues/greens and white for trust and purity
  • Luxury brand using Lover + Ruler with navy, burgundy, and gold and refined typography for sophistication
  • Consumer app using Jester + Everyman with bright yellow accents and friendly, approachable typography

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers