Agent skill

Brand Kit Design Tokens

by plugin87 in plugin87/ux-ui-agent-skills

Builds a from-scratch brand design system as three-tier DTCG tokens plus one theme.css with light and dark modes, checked against WCAG contrast rules.

MITAuto-check passedFrontend & Design

Install Brand Kit Design Tokens

skills CLI
$ npx skills add plugin87/ux-ui-agent-skills --skill brandkit -a claude-code

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

GitHub CLI
$ gh skill install plugin87/ux-ui-agent-skills brandkit --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/plugin87/ux-ui-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/brandkit .claude/skills/brandkit && 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
brandkit
GitHub stars
1.5k
Token cost
~809 tokens
SKILL.md length
286 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Builds a from-scratch brand design system as three-tier DTCG tokens plus one theme.css with light and dark modes, checked against WCAG contrast rules.

  • Works in 5 steps: Brief Inference (mandatory) — name the… → Primitives — generate the brand color… → Semantic layer — map roles to… → …
  • Starting a new product that needs a brand palette and type system from scratch
  • SKILL.md covers Steps and Verification (definition of…
  • Calls python3, npx and npm

What it does

The skill starts by checking that the full kit is installed, not only the skill folders that `npx skills add` copies. If files are missing it says so, points you to `npx ux-ui-agent-skills init` or the plugin install, and stops. Then it infers a brief covering industry, audience, one mood adjective and motion depth, and picks an anchoring archetype.

From there it generates an 11-shade brand color ramp in OKLCH plus a neutral ramp, maps them to semantic roles for actions, text, surfaces, borders and feedback, and designs dark overrides rather than inverting colors. It adds a Major Third type scale, a 4px spacing scale, radius tiers, elevation and motion timings, then emits DTCG token JSON and a single `theme.css` with `[data-theme="dark"]` overrides. Three Python scripts verify the result: token validity, contrast in both themes and theme variable references.

When your agent uses it

  • Starting a new product that needs a brand palette and type system from scratch
  • Creating a themeable token kit with light and dark modes
  • Replacing scattered hardcoded colors with one shared theme file

Example prompts

  • “Create a brand design system for a meditation app with calm, warm tones.”
  • “Generate DTCG tokens and a theme.css for our logistics dashboard, light and dark.”
  • “Build a color and type foundation for a fintech startup and verify WCAG contrast.”

Requirements

  • The ux-ui-agent-skills kit installed, not only the skill folders
  • Python 3 for the validation scripts

Workflow steps

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

  1. Brief Inference (mandatory) — name the industry, audience, the one mood adjective, and motion depth…
  2. Primitives — generate the brand color ramp in OKLCH (11 shades, consistent chroma) + a neutral ramp; verify the 500 shade ≥ 4.5:1 on white…
  3. Semantic layer — map roles to primitives: action.primary/-hover/destructive, text.{primary,secondary,on-action,link}…
  4. Scales — Major Third type scale + composite text styles, 4px spacing scale, radius tiers, elevation, and…
  5. Emit the DTCG ${CLAUDE_SKILL_DIR}/../../../tokens/*.json (3-tier) + a single theme.css (the one shared source, [data-theme="dark"]…

What it can do on your machine

Read from SKILL.md and the folder at commit 14f8d44. 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

    Shell commands in SKILL.md call:

    • python3
    • npx
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npx and npm, which can reach the network depending on how they are called.

    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.

Context cost

Brand Kit Design Tokens loads about 809 tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 286 words of instructions outside code blocks.

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

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 plugin87/ux-ui-agent-skills at commit 14f8d44, republished under its MIT licence (© plugin87). 286 words, ~809 tokens.

Download SKILL.mdSave it as .claude/skills/brandkit/SKILL.md (or your agent's skills folder).
name
brandkit
description
Generate a complete, accessible brand design system from a brief — primitive → semantic → component DTCG tokens (color, type, spacing, radius, shadow, motion), light + dark, plus a single theme.css — verified for WCAG. Use when the user wants a from-scratch brand/design foundation, a new palette + type system, or a themeable token kit for a product.
disable-model-invocation
true

Skill: Brand Kit

Step 0 — is the kit here? This skill reads files from the kit. Check once: ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING On KIT_MISSING only the skill folders were installed, which is what npx skills add does. Say so plainly, point the user at npx ux-ui-agent-skills init or the plugin install, and stop. Do not guess the contents of a file you could not open.

Stand up the foundation (one token system everything renders from) before any screen. Get this right and every page stays consistent and themeable from one place.

Steps

  1. Brief Inference (mandatory) — name the industry, audience, the one mood adjective, and motion depth (${CLAUDE_SKILL_DIR}/../../../taste/design-taste.md → Brief Inference). Pick an anchoring archetype from ${CLAUDE_SKILL_DIR}/../../../taste/aesthetic-systems.md.
  2. Primitives — generate the brand color ramp in OKLCH (11 shades, consistent chroma) + a neutral ramp; verify the 500 shade ≥ 4.5:1 on white (text) and 600 ≥ 3:1 (UI) per .claude/rules/tokens-and-color.md → Color Generation.
  3. Semantic layer — map roles to primitives: action.primary/-hover/destructive, text.{primary,secondary,on-action,link}, surface.{page,card,raised}, border.{default,strong}, feedback.{success,warning,error,info} — and the dark overrides (designed, not inverted).
  4. Scales — Major Third type scale + composite text styles, 4px spacing scale, radius tiers, elevation, and ${CLAUDE_SKILL_DIR}/../../../tokens/motion.json-style durations/easings.
  5. Emit the DTCG ${CLAUDE_SKILL_DIR}/../../../tokens/*.json (3-tier) + a single theme.css (the one shared source, [data-theme="dark"] overrides). Optionally feed the token-build pipeline (token-build skill) for other platforms.

Verification (definition of done)

  • python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_tokens.py — valid JSON, all aliases resolve.
  • python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_contrast.py — required text/action/border pairs pass WCAG AA in light AND dark; border.strong ≥ 3:1.
  • python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_theme_refs.py — every component var(--…) resolves to the theme.
  • One theme, no per-page palettes; destructive = danger token (not primary); zero hardcoded values.

Output is a verified token foundation — the measurable part is provable (run npm run verify). Brand "feel" still benefits from a human review against ${CLAUDE_SKILL_DIR}/../../../taste/design-taste.md.

© plugin87, 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 .claude/skills/brandkit of plugin87/ux-ui-agent-skills.

Open the folder on GitHubat commit 14f8d44

Compare with similar skills

Brand Kit Design Tokens 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 Kit Design Tokens compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brand Kit Design Tokens this skillplugin87/ux-ui-agent-skills1.5k—~809Automated safety check: PassMIT
Material Design 3 UI/UX Guideskydashnet/material-design-3-ui-skill130—~3kAutomated safety check: PassMIT
UI Design Systemtry-works/role-model117—~5kAutomated safety check: PassMIT
Design Systemborghei/Claude-Skills874—~3kAutomated safety check: PassMIT
Applying UI Design Systemtelagod/code-abyss244—~538Automated safety check: PassMIT
Chakra UI v3 Builderchakra-ui/chakra-ui41k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Material Design 3 UI/UX Guide

    skydashnet/material-design-3-ui-skill

    Guides designing, reviewing or implementing interfaces that follow Google's Material Design 3 system: semantic tokens, component states, adaptive layout and accessibility.

    130 GitHub stars~3k tokensUpdated 6 days ago
    Frontend & DesignAuto-check passed
  • UI Design System

    try-works/role-model

    React UI component systems with TailwindCSS + Radix + shadcn/ui.

    117 GitHub stars~5k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Design System

    borghei/Claude-Skills

    Design tokens, light/dark theming, and WCAG contrast validation for HTML documents and decks, compiled into one inlinable CSS bundle.

    874 GitHub stars~3k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Applying UI Design System

    telagod/code-abyss

    Frontend UI design system selector and implementation guide covering Glassmorphism, Liquid Glass (Apple-style), Neubrutalism, and Claymorphism.

    244 GitHub stars~538 tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Chakra UI v3 Builder

    chakra-ui/chakra-ui

    Builds responsive, accessible Chakra UI v3 components and layouts, sets up Chakra in new or existing projects, and designs themes with tokens, semantic tokens and recipes.

    41k GitHub stars~3.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed

More from plugin87/ux-ui-agent-skills

All 23 skills in this repo
  • Data-Dense Dashboard Designer

    plugin87/ux-ui-agent-skills

    Lays out dense analytics or trading-terminal screens in banded sections with hand-drawn SVG charts, instead of a wall of identical stat cards.

    1.5k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • UI Component Spec Designer

    plugin87/ux-ui-agent-skills

    Writes a complete UI component spec with anatomy, variants, sizes, eight interaction states, design-token mapping and accessibility notes before or alongside code.

    1.5k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Design Project Scaffold

    plugin87/ux-ui-agent-skills

    Creates a new design-product project from the kit's product-design template, then installs the engine folders and the Playwright dependency that the quality gates need.

    1.5k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Accessibility Audit

    plugin87/ux-ui-agent-skills

    Audits a UI or design against WCAG 2.2 and ARIA patterns and returns findings with the criterion, severity and a specific fix for each.

    1.5k GitHub stars~542 tokensUpdated today
    Auto-check passed
  • Apply Aesthetic

    plugin87/ux-ui-agent-skills

    Applies a chosen visual direction, an archetype or one of 138 named design systems, by remapping design tokens, then checks contrast before it finishes.

    1.5k GitHub stars~597 tokensUpdated today
    Auto-check passed
  • Design Code for Any Framework

    plugin87/ux-ui-agent-skills

    Generates complete, accessible, token-driven UI component code for a chosen framework such as React with Tailwind, SwiftUI, Vue, Flutter or Jetpack Compose.

    1.5k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about Brand Kit Design Tokens

What does Brand Kit Design Tokens do?

Builds a from-scratch brand design system as three-tier DTCG tokens plus one theme.css with light and dark modes, checked against WCAG contrast rules. The skill starts by checking that the full kit is installed, not only the skill folders that `npx skills add` copies. If files are missing it says so, points you to `npx ux-ui-agent-skills init` or the plugin install, and stops.

When should I use Brand Kit Design Tokens?

Brand Kit Design Tokens fits situations like: starting a new product that needs a brand palette and type system from scratch; creating a themeable token kit with light and dark modes; replacing scattered hardcoded colors with one shared theme file.

How do I install Brand Kit Design Tokens in Claude Code?

Run `npx skills add plugin87/ux-ui-agent-skills --skill brandkit -a claude-code`. Or copy the skill folder (.claude/skills/brandkit in plugin87/ux-ui-agent-skills) into .claude/skills/brandkit in your project. Claude Code loads it when a task matches its description.

How do I install Brand Kit Design Tokens in Codex?

Run `npx skills add plugin87/ux-ui-agent-skills --skill brandkit -a codex`. Or copy the skill folder (.claude/skills/brandkit in plugin87/ux-ui-agent-skills) into .agents/skills/brandkit in your project. Codex loads it when a task matches its description.

Can I use Brand Kit Design Tokens 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 plugin87/ux-ui-agent-skills --skill brandkit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brandkit, .gemini/skills/brandkit, .github/skills/brandkit and .opencode/skills/brandkit in your project.

What does Brand Kit Design Tokens need to run?

Going by SKILL.md and its folder, Brand Kit Design Tokens needs the command-line tools its instructions call (python3, npx and npm). Our summary lists: The ux-ui-agent-skills kit installed, not only the skill folders; Python 3 for the validation scripts.

Does Brand Kit Design Tokens access the network?

SKILL.md contains no URLs. Its commands use npx and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Brand Kit Design Tokens 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 Kit Design Tokens use?

Brand Kit Design Tokens is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brand Kit Design Tokens use?

About 809 tokens (SKILL.md is roughly 3.2k 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 Kit Design Tokens?

Skills that share tags, products or a category with Brand Kit Design Tokens: Material Design 3 UI/UX Guide (skydashnet/material-design-3-ui-skill, 130 stars), UI Design System (try-works/role-model, 117 stars), Design System (borghei/Claude-Skills, 874 stars) and Applying UI Design System (telagod/code-abyss, 244 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brand Kit Design Tokens?

plugin87 (a GitHub user) maintains it in plugin87/ux-ui-agent-skills, which has 1,543 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 7, 2026.

Source: plugin87/ux-ui-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.