Agent skill

Brand Design

by EliasOulkadi in EliasOulkadi/shokunin

Generate brand guidelines, design systems with design tokens (W3C format), creative direction (SCAMPER, Design Thinking, TRIZ), and design briefs with scope and success criteria.

MITAuto-check passedFrontend & Design

Install Brand Design

skills CLI
$ npx skills add EliasOulkadi/shokunin --skill brand-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install EliasOulkadi/shokunin brand-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/EliasOulkadi/shokunin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.pack/skills/brand-design .claude/skills/brand-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brand-design
GitHub stars
114
Token cost
~3k tokens
SKILL.md length
1,200 words
Files
1
Skills in repo
49
Repo updated
First seen
Licence
MIT

At a glance

Generate brand guidelines, design systems with design tokens (W3C format), creative direction (SCAMPER, Design Thinking, TRIZ), and design briefs with scope and success criteria.

  • Works in 9 steps: Project overview: what and why (2-3… → Problem statement: "[User] cannot [goal]… → Objectives: SMART → …
  • Tasks that involve Logo and visual identity
  • SKILL.md covers Workflow: Brand / Design…, Error Handling, Brand Guidelines and Design System Audit Checklist, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brand Design is an agent skill from EliasOulkadi/shokunin. Generate brand guidelines, design systems with design tokens (W3C format), creative direction (SCAMPER, Design Thinking, TRIZ), and design briefs with scope and success criteria.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: opencode

It sits in Frontend & Design, covering Logo and visual identity, Brand strategy and identity and Design systems. The repository describes itself as: 職人 Shokunin 62 AI agent skills for OpenCode, Claude Code, Cursor, Windsurf. ChromaDB memory, MCP servers, declarative self-updates. Multi-model, open source, zero cost. The licence is MIT.

When your agent uses it

  • Tasks that involve Logo and visual identity
  • Tasks that involve Brand strategy and identity
  • Tasks that involve Design systems

Example prompts

  • “/brand-design”

Requirements

  • Compatibility (from SKILL.md): opencode

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Project overview: what and why (2-3 sentences)
  2. Problem statement: "[User] cannot [goal] because [barrier]"
  3. Objectives: SMART
  4. Target audience: demographics, behaviors, goals, pain points, anti-audience
  5. Scope: what's in and explicitly out
  6. Deliverables: format, quantity, specs, revision rounds
  7. Timeline: phases, milestones, review points, buffer
  8. Success criteria: testable, with metrics and targets
  9. Constraints: budget, technology, brand, legal, timeline

What it can do on your machine

Read from SKILL.md and the folder at commit 4c68e5b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Brand Design loads about 3k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 1,200 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from EliasOulkadi/shokunin at commit 4c68e5b, republished under its MIT licence (© EliasOulkadi). 1,200 words, ~2,967 tokens.

Download SKILL.mdSave it as .claude/skills/brand-design/SKILL.md (or your agent's skills folder).
name
brand-design
description
Generate brand guidelines, design systems with design tokens (W3C format), creative direction (SCAMPER, Design Thinking, TRIZ), and design briefs with scope and success criteria.
compatibility
opencode
triggers
brand guidelines, style guide, design brief, creative brief, campaign concept, brand identity, visual identity, design system, creative direction, brand…
negatives
UI component design patterns, landing page layout, responsive design, icon set creation, color palette generation
license
MIT
metadata.workflow
productivity
metadata.audience
developers
metadata.version
3.0.0

Brand Design Skill v3.0

Brand identity, design systems, creative direction, and project briefs.


Workflow: Brand / Design System Creation

Follow this numbered process. Do not skip steps.

StepActionOutput
1Gather inputs: brand story, competitors, audience research, technical constraintsBrief document
2Define brand strategy: positioning, personality (3-5 adjectives), tone of voiceBrand strategy doc
3Build color system: primary, neutral, semantic palettes + WCAG AA checksColor tokens + palette
4Select typography: headline/body pairing, scale, line-height, responsive sizingTypography tokens
5Define spacing, radius, shadow, motion tokens (W3C format)Design tokens JSON
6Create logo variations + usage guidelinesLogo guidelines
7Apply to 3+ touchpoints: web, print, social, or environmentalApplication mockups
8Run design system audit (see checklist below)Audit report
9Document anti-patterns and error statesError + anti-pattern docs
10Stakeholder review + alignment sign-offApproved design system v1.0

Error Handling

ErrorCauseFix
Color contrast fails WCAG AALuminance ratio < 4.5:1 for textDarken or lighten until ratio passes. Use contrastRatio in tokens.
Token mismatch across platformsFigma tokens != code tokensSingle source of truth: W3C JSON. Export from design tool.
Typography scale gapsMissing intermediate sizesBuild scale with modular scale (1.25 or 1.333 ratio).
Logo illegible at min sizeToo much detail in iconUse simplified lockup or separate wordmark + icon variants.
Design brief scope creepUnclear out-of-scope listExplicit "what's NOT included" section. Reference during reviews.
Stakeholder disagreementNo clear decision authorityIdentify single approver in brief. Escalate to DRI.
Campaign fails originality axisCliché or derivative ideaForce 5+ directions. Run through SCAMPER/TRIZ. Reference culture, not competitors.

Brand Guidelines

A complete brand system has 9 sections: brand story, logo, color, typography, spacing, imagery, voice, application, anti-patterns.

Color Palette

Primary (2-4 colors, 60%+ of touchpoints):

RoleHexUsage
Primary#1B365DHeadlines, primary buttons
Accent#F5BD47CTAs, highlights

Neutral (grays for UI):

NameHexUsage
Dark#080808Headings
Mid#666666Body text
Light#E0E0E0Borders
Surface#F5F5F5Backgrounds

Semantic: Success #2ECC71, Warning #F39C12, Error #E74C3C, Info #3498DB

Design Tokens (W3C Format)
json
{
  "color": {
    "primary": { "$value": "#1B365D", "$type": "color" },
    "accent": { "$value": "#F5BD47", "$type": "color" },
    "surface": { "$value": "#F5F5F5", "$type": "color" }
  },
  "spacing": {
    "xs": { "$value": "4px", "$type": "dimension" },
    "sm": { "$value": "8px", "$type": "dimension" },
    "md": { "$value": "16px", "$type": "dimension" },
    "lg": { "$value": "32px", "$type": "dimension" }
  },
  "borderRadius": {
    "sm": { "$value": "4px", "$type": "dimension" },
    "md": { "$value": "8px", "$type": "dimension" },
    "full": { "$value": "9999px", "$type": "dimension" }
  }
}
Typography
ElementWeightSizeLine Height
Display H1Boldclamp(2.5rem,5vw,4.5rem)1.1
H2Boldclamp(1.75rem,3vw,2.5rem)1.2
H3Semiboldclamp(1.25rem,2vw,1.75rem)1.25
BodyRegular1rem (16px)1.6
CaptionRegular0.75rem1.4

Body text minimum 16px. Line length 45-75 chars. Contrast min 4.5:1 (WCAG AA).

Font Pairing Examples:

StyleHeadlineBody
Premium editorialPlayfair DisplaySource Sans Pro
Modern SaaSInterInter
Creative agencySynePlus Jakarta Sans
LuxuryCormorant GaramondProxima Nova
Logo Guidelines
  • Variations: primary, secondary, icon (32x32), wordmark
  • Clear space = height of "H" on all sides
  • Min size: 80px digital, 1.5in print
  • Never stretch, recolor, rotate, add effects, or use on low-contrast backgrounds
Tone of Voice
DimensionRule
Personality3-5 adjectives (e.g. confident, warm, precise)
VocabularyUse "we/you". Avoid "one/our users"
FormalityCasual for social, formal for investor comms
HumorIn social/email. Never in legal, support, or crisis

Design System Audit Checklist

  • All colors have hex/RGB/HSL values and usage guidelines
  • Typography scale covers 6+ sizes with line-height
  • Spacing scale (4/8/16/24/32/48/64px)
  • Component library matches design tokens
  • Dark mode variants defined
  • Accessibility: all color combos pass WCAG AA 4.5:1
  • Icons: consistent stroke width, corner radius, size grid
  • Shadow/elevation system defined
  • Motion: duration, easing, reduced-motion alternative
  • Form elements: all states (default, hover, focus, error, disabled)
  • Breakpoints match design tool
  • Figma component properties mapped to code props

Production Checklist

Before shipping any design system or brand guidelines:

CheckCriteriaOwner
Color parityHex values match exactly between Figma + code + docsDesign + Dev
Token exportW3C JSON exported and imported into codebaseDesign
Font licensingAll typefaces have valid web + print licensesProd Mgr
Logo rasterizationVector + PNG + favicon exported at all required sizesDesign
Accessibility auditAutomated + manual passes (axe, color contrast, keyboard nav)QA
Dark modeAll colors have dark mode variants, no hardcoded valuesDesign
Responsive breakpointsLayout tested at mobile, tablet, desktopDev
Motion reducedprefers-reduced-motion respected for all animationsDev
Component statesAll interactive elements defined: default, hover, focus, active, error, disabledDesign
Figma dev handoffComponents published with props, variants, and descriptionsDesign

Creative Direction

Ideation Methodologies
MethodologyBest for
SCAMPERProduct innovation, rebranding
Design ThinkingHuman-centered problem solving
TRIZ (40 principles)Technical problem solving
BisociationConnecting two unrelated frameworks
Synectics (analogies)Creative campaigns
SITInnovation with constraints
Blue Ocean StrategyMarket differentiation
Show full SKILL.md (492 more words)Show less
Campaign Architecture
LevelTimeframeWhat
Brand platform3-5 yearsPositioning
Campaign themeAnnualWhat we say this year
Creative executionsPer assetHow we bring it to life
Tactical adaptationsPer channelHow it works in this medium
Campaign Idea Evaluation (5-axis)
AxisPassingFail
Originality (1-10)7+Below 5
Relevance (1-10)8+Below 6
Impact (1-10)7+Below 5
Feasibility (1-10)6+Below 4
Durability (1-10)6+Below 4

Score min 3 axes at 7+ to proceed.


Design Brief

Structure
  1. Project overview: what and why (2-3 sentences)
  2. Problem statement: "[User] cannot [goal] because [barrier]"
  3. Objectives: SMART
  4. Target audience: demographics, behaviors, goals, pain points, anti-audience
  5. Scope: what's in and explicitly out
  6. Deliverables: format, quantity, specs, revision rounds
  7. Timeline: phases, milestones, review points, buffer
  8. Success criteria: testable, with metrics and targets
  9. Constraints: budget, technology, brand, legal, timeline
Stakeholder Alignment Questions
  1. Who has final approval?
  2. What's the single most important metric?
  3. What can we deprioritize if scope shrinks?
  4. Who are we NOT designing for?
  5. What are the non-negotiables (legal, brand, technical)?

Anti-Patterns

Anti-PatternWhy It FailsFix
No single-minded propositionMessage dilutes, audience confusedForce one idea. Kill the rest.
Problem stated as solutionBrief prescribes fix instead of framing the real issueDescribe the problem, not the fix
Vague success criteriaCannot measure success or failureDefine specific, testable criteria with targets
No constraints givenDesign that looks great but can't be built or shippedAdd budget, tech, timeline constraints upfront
Too many stakeholdersDesign by committee produces mediocrityIdentify single DRI per decision type
Skipping audience insightDesign solves wrong problemResearch first. Find a non-obvious truth.
Chasing trendsLooks dated in 6 months, no differentiationReference culture, not competitors
Falling in love with first ideaBiased evaluation, better solutions missedForce 5+ directions before selecting
Designing for yourselfEnd-user needs subordinated to designer preferencesUser test with real audience segments
No error states definedUI breaks silently, bad UXDefine error, empty, loading states for every component

Design Token Architecture

json
{
  "color": {
    "primary": { "value": "#1B365D", "type": "color" },
    "primary-light": { "value": "#2D5A8A", "type": "color" }
  },
  "spacing": {
    "xs": { "value": "4px", "type": "spacing" },
    "sm": { "value": "8px" }, "md": { "value": "16px" }, "lg": { "value": "24px" }
  },
  "typography": {
    "heading": { "value": { "fontFamily": "Charter", "fontWeight": 500, "fontSize": "clamp(32px,5vw,56px)" } }
  }
}

Export as W3C Design Token format for Figma Tokens plugin, Style Dictionary, or token-transformer.

Figma-to-Code Handoff

  1. Dev Mode: inspect spacing (8px grid), colors (variables), typography (named styles)
  2. Export assets: SVG for icons, PNG @2x for raster
  3. Component mapping: FigmaComponent → ReactComponent documented before build
  4. Responsive: Figma frames at 375px (mobile), 768px (tablet), 1440px (desktop)

Sources

  • Pentagram — brand identity project standards
  • NASA Graphics Standards Manual
  • Stripe Brand Guidelines
  • W3C Design Tokens Format
  • IDEO design thinking methodology
  • Ogilvy "On Advertising"
  • Design Council UK "Double Diamond"
  • NN Group "How to Write a Design Brief"
  • Figma Design Tokens plugin

Checklist

  • Skill loads without errors in the AI agent
  • YAML frontmatter is valid (description, compatibility, audience)
  • Workflow section provides clear step-by-step instructions
  • Error handling section covers common failure modes
  • All referenced files (references/, scripts/, assets/) exist
  • Skill triggers correctly for intended use cases
  • No broken links or missing resources

© EliasOulkadi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .pack/skills/brand-design of EliasOulkadi/shokunin.

Open the folder on GitHubat commit 4c68e5b

Compare with similar skills

Brand Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brand Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brand Design this skillEliasOulkadi/shokunin114—~3kAutomated safety check: PassMIT
DesignOhh-889/skyroc7959 repos~3.1kAutomated safety check: PassMIT
Cavekit Design SystemJuliusBrussee/caveman-code942—~4.5kAutomated safety check: PassMIT
Replica DesignJakeschincariol/replica-skill1.4k—~994Automated safety check: PassMIT
Brand SystemsHermeticOrmus/LibreUIUX-Claude-Code112—~2.3kAutomated safety check: PassMIT
Shadcn Tailwind UILiarMTTT/TavernWeave154—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Design

    Ohh-889/skyroc

    Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations…

    795 GitHub starsUsed in 9 repos~3.1k tokens
    Frontend & DesignAuto-check passed
  • Cavekit Design System

    JuliusBrussee/caveman-code

    How to write and maintain DESIGN.md as the visual specification layer for Cavekit projects.

    942 GitHub stars~4.5k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Replica Design

    Jakeschincariol/replica-skill

    Rebuilds an app's design system for a clone: colour roles, type scale, spacing, radius, shadows and every component with its states, as design tokens plus component specs, with original assets…

    1.4k GitHub stars~994 tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • Brand Systems

    HermeticOrmus/LibreUIUX-Claude-Code

    Brand identity building blocks: positioning, personality, archetypes, logo systems, color palettes, type pairing, voice, and guidelines documentation.

    112 GitHub stars~2.3k tokensUpdated 6 days ago
    Frontend & DesignAuto-check passed
  • Shadcn Tailwind UI

    LiarMTTT/TavernWeave

    Build, restyle, or review accessible React interfaces that use shadcn/ui, Radix UI primitives, and Tailwind CSS.

    154 GitHub stars~1.7k tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed
  • Form Brand

    jeremylongshore/tons-of-skills-marketplace

    A skill your agent uses when asked to create a brand identity, define visual design direction, generate a color palette or type system, build a style guide, or establish the look and feel for a…

    2.8k GitHub stars~2.1k tokensUpdated yesterday
    Frontend & DesignAuto-check: notes

More from EliasOulkadi/shokunin

All 49 skills in this repo
  • CI CD

    EliasOulkadi/shokunin

    Design CI/CD pipelines for GitHub Actions, GitLab CI, and CircleCI with matrix builds, test sharding, caching, Docker layer caching, OIDC auth, deployment strategies (rolling, blue-green, canary)…

    114 GitHub stars~3.4k tokensUpdated 6 days ago
    Auto-check: notes
  • Component Forge

    EliasOulkadi/shokunin

    Build production-grade components for React, Vue 3, and Svelte 5 with all states (loading, empty, error, success, idle), TypeScript strict, WCAG 2.2 accessibility, server components (RSC), and…

    114 GitHub stars~3.6k tokensUpdated 6 days ago
    Auto-check: notes
  • DB Admin

    EliasOulkadi/shokunin

    PostgreSQL database administration — backup/restore (pgdump, PITR, WAL archiving), health monitoring (connections, bloat, cache hit ratio, dead tuples), connection pooling (PgBouncer), replication…

    114 GitHub stars~2k tokensUpdated 6 days ago
    Auto-check: notes
  • DB Sculptor

    EliasOulkadi/shokunin

    Design database schemas with Prisma/Drizzle, PostgreSQL index strategy (B-tree, GIN, GiST, BRIN, Hash), query optimization (EXPLAIN ANALYZE), migration safety (expand/contract, zero-downtime), and…

    114 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check: notes
  • Docker

    EliasOulkadi/shokunin

    Optimize Docker images with multi-stage builds, distroless bases, BuildKit cache mounts, multi-arch builds, compose watch, security hardening (non-root, seccomp, capabilities drop), and…

    114 GitHub stars~3.8k tokensUpdated 6 days ago
    Auto-check: notes
  • Error Handler

    EliasOulkadi/shokunin

    Design error handling, structured logging, and observability with OpenTelemetry (traces, metrics, logs), error classification, recovery patterns (retry with jitter, circuit breaker, bulkhead…

    114 GitHub stars~3.6k tokensUpdated 6 days ago
    Auto-check: notes

Questions about Brand Design

What does Brand Design do?

Generate brand guidelines, design systems with design tokens (W3C format), creative direction (SCAMPER, Design Thinking, TRIZ), and design briefs with scope and success criteria. Brand Design is an agent skill from EliasOulkadi/shokunin. Generate brand guidelines, design systems with design tokens (W3C format), creative direction (SCAMPER, Design Thinking, TRIZ), and design briefs with scope and success criteria.

When should I use Brand Design?

Brand Design fits situations like: tasks that involve Logo and visual identity; tasks that involve Brand strategy and identity; tasks that involve Design systems.

How do I install Brand Design in Claude Code?

Run `npx skills add EliasOulkadi/shokunin --skill brand-design -a claude-code`. Or copy the skill folder (.pack/skills/brand-design in EliasOulkadi/shokunin) into .claude/skills/brand-design in your project. Claude Code loads it when a task matches its description.

How do I install Brand Design in Codex?

Run `npx skills add EliasOulkadi/shokunin --skill brand-design -a codex`. Or copy the skill folder (.pack/skills/brand-design in EliasOulkadi/shokunin) into .agents/skills/brand-design in your project. Codex loads it when a task matches its description.

Can I use Brand Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add EliasOulkadi/shokunin --skill brand-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brand-design, .gemini/skills/brand-design, .github/skills/brand-design and .opencode/skills/brand-design in your project.

What does Brand Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Brand Design is instructions for the agent only. Compatibility (from SKILL.md): opencode.

Does Brand Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Brand Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Brand Design use?

Brand Design is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brand Design use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Brand Design?

Skills that share tags, products or a category with Brand Design: Design (Ohh-889/skyroc, 795 stars), Cavekit Design System (JuliusBrussee/caveman-code, 942 stars), Replica Design (Jakeschincariol/replica-skill, 1.4k stars) and Brand Systems (HermeticOrmus/LibreUIUX-Claude-Code, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brand Design?

EliasOulkadi (a GitHub user) maintains it in EliasOulkadi/shokunin, which has 114 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 5, 2026.

Source: EliasOulkadi/shokunin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.