> typography, color, and cross-channel consistency. Use when creating style guides, defining brand voice, auditing brand consistency, or setting visual standards.
npx skills add https://github.com/borghei/Claude-Skills --skill brand-guidelines
Comprehensive brand identity systems for building, documenting, and enforcing consistent brand presence across every channel and touchpoint.
brand guidelines, brand identity, style guide, brand voice, tone of voice, visual identity, brand standards, brand consistency, color systems, typography, logo usage, brand colors, design standards, brand audit, brand governance, co-branding, brand architecture, brand personality, writing style guide, visual standards
Before building the guidelines, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Step 1: Define Brand Foundation
## Brand Foundation
- Purpose: [Why the brand exists beyond revenue]
- Vision: [What the brand aspires to achieve in the world]
- Mission: [How the brand delivers on its purpose daily]
- Values (3-5):
1. [Value]: [What it means in practice, not just the word]
2. [Value]: [Behavioral definition]
3. [Value]: [Behavioral definition]
- Brand Promise: [The single commitment to customers]
Step 2: Establish Brand Personality
Select 3-5 personality traits from the archetype framework:
| Archetype | Personality Traits | Voice Characteristics | Best For |
|-----------|-------------------|----------------------|----------|
| Expert | Knowledgeable, precise, authoritative | Data-driven, technical depth, confidence | B2B, enterprise, professional services |
| Guide | Helpful, clear, patient | Instructional, encouraging, step-by-step | Education, SaaS, healthcare |
| Innovator | Bold, forward-thinking, disruptive | Visionary, provocative, future-focused | Tech, startups, R&D |
| Friend | Warm, approachable, genuine | Conversational, inclusive, casual | Consumer brands, community, lifestyle |
| Motivator | Inspiring, energetic, empowering | Action-oriented, ambitious, rallying | Fitness, coaching, personal development |
| Challenger | Direct, honest, contrarian | Opinionated, confident, questioning | Fintech, disruptor brands |
| Creator | Imaginative, expressive, original | Storytelling, vivid imagery, playful | Design, media, entertainment |
Step 3: Document Voice and Tone
See the Voice and Tone System section below for the complete framework.
Step 4: Build Visual Identity
See the Visual Identity System section below for the complete framework.
Step 5: Create Application Guide
Document how guidelines apply to each channel:
Step 1: Collect Samples
Gather 3-5 samples from each active channel:
Step 2: Score Against Seven Dimensions
For each sample, score 1-5 on:
| Dimension | 1 (Poor) | 3 (Adequate) | 5 (Excellent) |
|-----------|----------|---------------|----------------|
| Color usage | Off-brand colors present | Mostly correct, minor deviations | Perfect palette adherence |
| Typography | Wrong fonts used | Correct fonts, inconsistent sizing | Perfect type hierarchy |
| Logo usage | Incorrect sizing, placement, or modification | Mostly correct with minor issues | Perfect logo application |
| Voice consistency | Tone shifts dramatically between sections | Generally consistent, occasional drift | Voice is unmistakably on-brand |
| Imagery style | Stock photos inconsistent with brand | Mostly aligned, some off-brand choices | Cohesive visual language |
| Layout patterns | No recognizable brand patterns | Some consistent elements | Clear, repeated brand patterns |
| Content quality | Errors, vague claims, inconsistent formatting | Clean, generally well-written | Precise, specific, error-free |
Step 3: Generate Audit Report
## Brand Audit Report: [Brand Name]
Date: [Date]
Auditor: [Name]
### Overall Score: [X/35]
### Dimension Scores
| Dimension | Score | Priority |
|-----------|-------|----------|
| Color | X/5 | [High/Medium/Low] |
| Typography | X/5 | [High/Medium/Low] |
| Logo | X/5 | [High/Medium/Low] |
| Voice | X/5 | [High/Medium/Low] |
| Imagery | X/5 | [High/Medium/Low] |
| Layout | X/5 | [High/Medium/Low] |
| Content | X/5 | [High/Medium/Low] |
### Critical Issues
[Specific deviations with exact references]
### Recommendations
[Prioritized fixes with implementation guidance]
The strategic layer that everything else builds on:
How the brand communicates across all written and spoken channels. See detailed framework below.
Colors, typography, logo, imagery, and layout patterns. See detailed framework below.
Specific language choices:
How the brand feels in interaction:
Voice is consistent — it is who the brand is. It does not change.
Tone adapts — it adjusts based on context, audience, and situation.
Example: A brand's voice is always "clear and confident." But the tone shifts:
Define 3-5 voice attributes with spectrum positions:
| Attribute | We Are | We Are Not |
|-----------|--------|------------|
| [e.g., Direct] | We get to the point. We say what we mean. | We are not blunt or dismissive. We are not rude. |
| [e.g., Knowledgeable] | We share expertise with confidence. | We are not condescending. We do not lecture. |
| [e.g., Human] | We write like people, not corporations. | We are not unprofessional. We do not use slang carelessly. |
| Context | Formality | Energy | Technical Depth |
|---------|-----------|--------|-----------------|
| Marketing homepage | Medium | High | Low |
| Product documentation | Medium-High | Neutral | High |
| Blog posts | Medium-Low | Medium | Medium |
| Error messages | Medium | Calm | Low |
| Social media | Low-Medium | High | Low |
| Sales proposals | High | Medium | Medium-High |
| Customer support | Medium | Warm | Varies |
| Incident reports | High | Calm | High |
Grammar and Mechanics:
Vocabulary Standards:
Primary Palette:
| Role | Color Name | Hex | RGB | Use Case |
|------|-----------|-----|-----|----------|
| Primary | [Name] | #XXXXXX | R, G, B | Primary CTAs, key brand elements |
| Secondary | [Name] | #XXXXXX | R, G, B | Supporting elements, accents |
| Neutral Dark | [Name] | #XXXXXX | R, G, B | Body text, dark backgrounds |
| Neutral Light | [Name] | #XXXXXX | R, G, B | Backgrounds, borders |
Extended Palette:
| Role | Color Name | Hex | Use Case |
|------|-----------|-----|----------|
| Success | [Name] | #XXXXXX | Positive states, confirmations |
| Warning | [Name] | #XXXXXX | Cautionary states |
| Error | [Name] | #XXXXXX | Error states, destructive actions |
| Info | [Name] | #XXXXXX | Informational states |
Color Usage Rules:
| Role | Font | Weight | Size | Line Height | Use Case |
|------|------|--------|------|-------------|----------|
| Display | [Font Name] | Bold/Black | 48-72px | 1.1 | Hero headlines |
| Heading 1 | [Font Name] | Bold | 36-48px | 1.2 | Page titles |
| Heading 2 | [Font Name] | Semibold | 24-32px | 1.3 | Section headers |
| Heading 3 | [Font Name] | Medium | 20-24px | 1.4 | Subsection headers |
| Body | [Font Name] | Regular | 16-18px | 1.5-1.6 | Paragraph text |
| Small | [Font Name] | Regular | 14px | 1.5 | Captions, metadata |
| Code | [Mono Font] | Regular | 14-16px | 1.5 | Code blocks, technical |
Typography Rules:
Logo Variations:
Logo Rules:
Co-Branding Rules:
Photography Style:
Illustration Style:
Icon Style:
Run this against any brand asset in under 5 minutes:
For a comprehensive brand audit across the organization:
| Platform | Avatar | Cover/Banner | Post Templates | Voice Adaptation |
|----------|--------|-------------|---------------|-----------------|
| LinkedIn | Logo icon | Brand banner | Professional, clean | Slightly more formal |
| Twitter/X | Logo icon | Brand banner | Concise, punchy | Slightly more casual |
| Instagram | Logo icon | N/A | Visual-first, on-brand colors | Visual storytelling emphasis |
| YouTube | Logo icon | Brand banner | Thumbnail template | Conversational |
| Symptom | Likely Cause | Resolution |
|---------|-------------|------------|
| Brand colors look different across web and print | RGB vs CMYK color space mismatch; no Pantone reference defined | Document colors in all three systems (Hex/RGB for digital, CMYK for print, Pantone for exact matching) |
| Teams consistently use wrong fonts | Font files not distributed or licensed for all team members | Create a shared font kit, document web-safe fallbacks, include licensing status per font |
| Logo appears stretched or pixelated on partner sites | Co-branding guidelines not shared or minimum size not enforced | Distribute logo kit with vector formats (SVG/EPS), document minimum sizes and clear space rules |
| Voice varies dramatically across customer support vs marketing | Tone calibration by context not documented or not trained | Create channel-specific tone guides with before/after examples, include in onboarding |
| Brand drift detected in quarterly audit | No governance process for new assets, no template enforcement | Implement approval workflow, lock master templates, assign brand guardians per channel |
| Color contrast failures on accessibility audits | Brand palette not tested against WCAG AA/AAA standards | Run color_accessibility_checker.py on full palette, adjust problematic combinations |
| New hires produce off-brand content in first 30 days | Brand guidelines not included in onboarding process | Add brand guidelines review to onboarding checklist, provide quick-reference card |
In Scope: Visual identity systems (color, typography, logo, imagery), voice and tone frameworks, brand audit methodology, cross-channel application guides, co-branding rules, brand governance processes, accessibility compliance for brand colors.
Out of Scope: Brand strategy and positioning decisions (see brand-strategist skill), brand architecture models (see brand-strategist skill), marketing copy creation (see copywriting skill), design file creation (Figma, Sketch), print production specifications.
Limitations: Brand guidelines are documentation — enforcement depends on organizational process. This skill provides frameworks and audit tools but cannot enforce compliance without governance workflows. Color accessibility checking uses algorithmic WCAG formulas and does not account for all visual impairment types.
| Script | Purpose | Usage |
|--------|---------|-------|
| scripts/brand_audit_scorer.py | Score brand consistency across seven dimensions with priorities | python scripts/brand_audit_scorer.py audit_data.json --json |
| scripts/messaging_consistency_checker.py | Check text against brand voice standards, detect vocabulary violations | python scripts/messaging_consistency_checker.py --text "Your copy here" |
| scripts/color_accessibility_checker.py | Validate brand colors against WCAG contrast requirements | python scripts/color_accessibility_checker.py --fg "#2563EB" --bg "#FFFFFF" |
Generate breadboard circuit mockups and visual diagrams using HTML5 Canvas drawing techniques. Use when asked to create circuit layouts, visualize electronic component placements, draw breadboard diagrams, mockup 6502 builds, generate retro computer schematics, or design vintage electronics projects. Supports 555 timers, W65C02S microprocessors, 28C256 EEPROMs, W65C22 VIA chips, 7400-series logic gates, LEDs, resistors, capacitors, switches, buttons, crystals, and wires.
> Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.
Analyze images, websites, and Figma files to extract their design and generate a `design.md` with token system, component inventory, and reconstruction notes. Use this skill whenever the user wants to understand, document, replicate, or audit the design of something visual: a screenshot, a URL, a Figma link, a Pinterest reference, a mockup, a competitor's site, a component, a dashboard, a landing page. Also when they ask 'extract the design system from X', 'document the style of Y', 'analyze this visually', 'convert this image into tokens', 'help me replicate this design', 'what palette does this site use', 'how is this built'. Also for single elements: 'copy this navbar', 'recreate this illustration', 'give me a prompt to regenerate this graphic' — element mode outputs a focused element.md, with token-grounded image-model prompts when the element is visual art. If the user brings any visual source and wants to understand it at a design level — this skill should activate.
Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.
Elite mobile app image-generation skill for creating premium, app-native screen concepts and flows. Designed for iOS, Android, and cross-platform mobile products. Prioritizes clean hierarchy, comfortably readable text, strong multi-screen consistency, controlled color palettes, non-generic creative direction, textured surfaces, image-led composition, tasteful custom iconography, and clean phone mockup framing. By default, screens should be shown inside a subtle premium iPhone or similar phone mockup with a visible frame, while the main focus stays on the app content itself. This skill generates images only. It does not write code.
Optimize web performance: bundle size, images, caching, lazy loading, and overall page speed. Use when site is slow, reducing bundle size, fixing layout shifts, improving Time to Interactive, or optimizing for Lighthouse scores. Triggers on: web performance, bundle size, page speed, slow site, lazy loading. Do NOT use for Core Web Vitals-specific fixes (use core-web-vitals), running Lighthouse audits (use perf-lighthouse), or Astro-specific optimization (use perf-astro).
| Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.
| Official GSAP skill for performance — prefer transforms, avoid layout thrashing, will-change, batching. Use when optimizing GSAP animations, reducing jank, or when the user asks about animation performance, FPS, or smooth 60fps.
Take borghei/brand-guidelines from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.