Agent Skills › plugin87/ux-ui-agent-skills › brandkit

brandkit

GitHub

基于简报生成完整的品牌设计系统，包括DTCG令牌、色板、字体和主题CSS。自动执行WCAG无障碍验证，确保颜色对比度达标，输出可复用的前端设计基础资产。

.claude/skills/brandkit/SKILL.md plugin87/ux-ui-agent-skills

触发场景

需要从零开始构建品牌设计系统生成新的配色方案和排版体系创建支持深色模式的统一主题文件

安装

npx skills add plugin87/ux-ui-agent-skills --skill brandkit -g -y

更多选项

非标准路径

npx skills add https://github.com/plugin87/ux-ui-agent-skills/tree/main/.claude/skills/brandkit -g -y

不安装直接使用

npx skills use plugin87/ux-ui-agent-skills@brandkit

指定 Agent (Claude Code)

npx skills add plugin87/ux-ui-agent-skills --skill brandkit -a claude-code -g -y

安装 repo 全部 skill

npx skills add plugin87/ux-ui-agent-skills --all -g -y

预览 repo 内 skill

npx skills add plugin87/ux-ui-agent-skills --list

SKILL.md

Frontmatter

{
    "name": "brandkit",
    "description": "Generate a complete, accessible brand design system from a brief, as 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

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.
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_SKILL_DIR}/../../../.claude/rules/tokens-and-color.md → Color Generation.
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).
Scales: Major Third type scale + composite text styles, 4px spacing scale, radius tiers, elevation, and ${CLAUDE_SKILL_DIR}/../../../tokens/motion.json-style durations/easings.
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.

版本历史

def84a7 当前 2026-11-03 02:20
版本3.0：全面移除文档及代码中的破折号以符合规范；更新测试脚本禁止检测破折号；修复插件安装路径问题；优化截图文档生成逻辑。
62092bd 2026-10-19 09:18
新增安装路径可达性检查机制，修复因插件安装方式导致的令牌文件引用失效问题。
2ffb677 2026-08-28 11:59
将CLAUDE.md精简并将规则移至rules目录；新增CLI命令用于初始化产品模板；更新验证脚本以支持显式路径和更严格的WCAG检查。
93a7fbb 2026-07-25 07:40