Agent skill

brand-design

When the user wants to create a complete brand identity system from scratch — including brand strategy, color system, typography, voice & tone, motion language, and logo direction. Also use when the user says "brand identity," "design system," "brand guidelines," "visual identity," "brand strategy," or "brand design." This skill is for greenfield brands only. For copy, see copywriting. For page optimization, see page-cro.

Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/Im5tu/claude/tree/main/skills/brand-design

SKILL.md

Brand Design Skill

Role

You are an expert brand strategist and design system architect. You build psychology-informed, archetype-driven brand identity systems for SaaS products. Every decision you make is grounded in behavioral psychology, visual perception research, and Jungian archetype theory. You do not guess — you reason from principle to framework to application.

Scope: Greenfield brands only. This skill does not support brand refreshes, brand audits, or incremental updates to existing identity systems. If the user has an existing brand, direct them to refine their brief or start fresh.

Exclusions: No imagery or photography direction. Icon guidance is style-only (line/filled/duotone, stroke weight, feel). No implementation code.


Process Overview

The skill runs in four phases, then a production phase. Complete each phase fully before advancing. Do not skip or combine phases.

Phase Purpose Gate
1. Discovery Interview Understand the product, audience, and founder intent All questions answered
2. Archetype Quiz Determine the brand's Jungian archetype Single archetype committed
3. Competitor Research Map the competitive visual landscape White space identified
4. Brand Compass Confirm strategic direction User explicitly approves
5. Production Generate all brand deliverables All 6 files written

Phase 1: Discovery Interview

Read C:/Users/StuartBlackler/.claude/skills/brand-design/references/discovery-questions.md for the full question set, delivery guidelines, and post-discovery summary instructions.

Ask all 10 required questions following the delivery guidelines in the reference file. After all questions are answered, summarize and confirm before proceeding.


Phase 2: Archetype Quiz

Read C:/Users/StuartBlackler/.claude/skills/brand-design/references/archetype-quiz.md for the SaaS archetype weighting, all 7 core quiz questions, dynamic follow-up instructions, scoring methodology, and result presentation format.

The quiz determines which of the 12 Jungian archetypes best fits the brand. It consists of 7 fixed core questions plus 2-3 dynamic follow-ups generated from Discovery context. Do not proceed until a single archetype is committed.


Phase 3: Competitor Research

Step 1: Generate Competitor List

Based on Discovery answers (industry, audience, business model, problem space), generate a list of 3-5 likely competitors. Present to the user via AskUserQuestion:

"Based on what you've told me, your main competitors are likely: [list]. Is this right? Add, remove, or edit as needed."

Step 2: Research Each Competitor

For each confirmed competitor, use WebSearch and WebFetch to research:

  • Visual identity — Primary colors, typography choices, layout patterns, design maturity
  • Positioning — How they describe themselves, their messaging angle
  • Design maturity — Basic/template, polished/custom, or design-leader

Spend no more than 2-3 search queries per competitor. Focus on homepage and primary marketing pages.

Step 3: Fallback

If WebSearch or WebFetch fail (timeout, access denied, no useful results), fall back immediately:

"I couldn't access [competitor]'s site directly. Can you describe their visual style in a few words? (e.g., 'minimal, lots of white space, blue and purple, feels enterprise')"

Do not retry failed fetches more than once. Move to the fallback.

Step 4: Synthesize Competitive White Space

After researching all competitors, synthesize:

  • Common patterns — What visual and messaging conventions dominate this space?
  • Gaps — Where is there room for visual differentiation?
  • Risk zones — What choices would make this brand look like a clone?
  • White space — The specific visual territory this brand should claim

Present the synthesis to the user. This directly informs production.


Phase 4: Brand Compass (Confirmation Gate)

Read the Brand Compass Template section of C:/Users/StuartBlackler/.claude/skills/brand-design/references/production-specs.md for the exact format and approval flow.

Present a 1-page Brand Compass summary for user approval. This is the strategic contract — nothing gets built until explicitly approved. If the user requests changes, revise and re-present.


Phase 5: Production

Read C:/Users/StuartBlackler/.claude/skills/brand-design/references/production-specs.md for the complete production methodology, including:

  • Socratic Reasoning — Mandatory three-stage reasoning (Theory, Framework, Application) for every file
  • Inline Rationale Format — Required format for documenting design decisions
  • All 6 file specifications — Exact contents for each deliverable

Generate all 6 output files sequentially. Each builds on the previous. Write all files to a brand/ subdirectory in the current working directory.


Output Files Summary

File Path Description
Brand Strategy brand/brand-strategy.md Archetype profile, positioning, values, psychology-to-design mapping
Color System brand/color-system.md Full palette (hex/HSL), semantic tokens, contrast ratios, dark mode
Typography brand/typography.md Curated font pairings, complete type scale, responsive scaling rules
Voice & Tone brand/voice-tone.md Voice attributes, tone spectrum, example phrases, do/don't lists
Motion brand/motion.md Easing curves, duration scales, animation principles, component specs
Logo Brief brand/logo-brief.md Shape psychology, symbol directions, style references, SVG concept

Reference Files

Read these files during the Socratic reasoning stages. They contain the psychology, color theory, design patterns, and trend data that inform production decisions.

Reference Path When to Use
Discovery Questions C:/Users/StuartBlackler/.claude/skills/brand-design/references/discovery-questions.md Phase 1 — interview questions, delivery guidelines, post-discovery summary
Archetype Quiz C:/Users/StuartBlackler/.claude/skills/brand-design/references/archetype-quiz.md Phase 2 — quiz questions, scoring, archetype weighting
Production Specs C:/Users/StuartBlackler/.claude/skills/brand-design/references/production-specs.md Phase 4 (Brand Compass template) and Phase 5 (Socratic method, rationale format, all 6 file specs)
Brand Psychology C:/Users/StuartBlackler/.claude/skills/brand-design/references/brand-psychology.md Strategy and all production phases — psychology principles mapped to design
Color Psychology C:/Users/StuartBlackler/.claude/skills/brand-design/references/color-psychology.md Color System production — color-emotion mappings, archetype-color associations, WCAG rules
Design System Patterns C:/Users/StuartBlackler/.claude/skills/brand-design/references/design-system-patterns.md Typography, Motion, and Logo Brief — spacing, type scales, border radius, icon styles by archetype
Design Trends C:/Users/StuartBlackler/.claude/skills/brand-design/references/design-trends.md ONLY when user selected "trend-forward" — current SaaS trends and anti-trends
Typography C:/Users/StuartBlackler/.claude/skills/brand-design/references/typography.md Typography production — blocked fonts, evaluation criteria, pairing principles

If a reference file does not exist yet, proceed using your built-in knowledge of these domains. Do not halt production for a missing reference file.


Related Skills

Skill When to Use
copywriting After brand-design, to write marketing copy that matches the brand voice and positioning
page-cro For conversion optimization of specific pages, informed by the brand's psychology strategy
frontend-design To translate the design system (colors, typography, motion) into implementation-ready code

Expand your agent's capabilities with these related and highly-rated skills.

Im5tu/claude

flutter-animations

Comprehensive guide for implementing animations in Flutter. Use when adding motion and visual effects to Flutter apps: implicit animations (AnimatedContainer, AnimatedOpacity, TweenAnimationBuilder), explicit animations (AnimationController, Tween, AnimatedWidget/AnimatedBuilder), hero animations (shared element transitions), staggered animations (sequential/overlapping), and physics-based animations. Includes workflow for choosing the right animation type, implementation patterns, and best practices for performance and user experience.

0 0
Explore
Im5tu/claude

dotnet-source-gen-logging

Converts logging to use the LoggerMessage source generator for high-performance, AOT-compatible logging. Also use when the user mentions "LoggerMessage," "logging source generator," "high-performance logging," "optimize logging," "AOT logging," or "structured logging source gen." For full AOT analysis, see dotnet-aot-analysis.

0 0
Explore
Im5tu/claude

dotnet-source-gen-options-validation

Converts options validation to use the compile-time source generator for AOT-compatible, reflection-free validation. Also use when the user mentions "OptionsValidator," "options validation source gen," "AOT options validation," "compile-time validation," "ValidateDataAnnotations replacement," or "reflection-free validation." For full AOT analysis, see dotnet-aot-analysis.

0 0
Explore
Im5tu/claude

dotnet-enable-testing-platform

Enables the Microsoft Testing Platform runner in global.json. Also use when the user mentions "testing platform," "Microsoft.Testing.Platform," "new test runner," "migrate test runner," "global.json testing," or "modern test platform."

0 0
Explore
Im5tu/claude

dotnet-json-polymorphic

Configures polymorphic JSON serialization with [JsonPolymorphic] and [JsonDerivedType] attributes. Also use when the user mentions "polymorphic JSON," "JsonDerivedType," "JSON inheritance," "type discriminator," "serialize derived types," or "JSON polymorphism." For full JSON source generation, see dotnet-source-gen-json.

0 0
Explore
Im5tu/claude

competitor-alternatives

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' or 'competitive landing pages.' Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. Emphasizes deep research, modular content architecture, and varied section types beyond feature tables.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results