关于 brandkit
brandkit 是用于在制作页面前建立共享设计令牌基础的 Skill。它指导颜色、语义角色、尺度、深色主题覆盖与令牌输出,并提供对比度和引用校验。
主要功能
- 01推断受众、行业与视觉方向
- 02生成 OKLCH 色阶和中性色阶
- 03定义语义令牌及深色主题覆盖
- 04建立字体、间距、圆角与动效尺度
- 05输出 DTCG 令牌文件和 theme.css
- 06校验令牌与对比度
适用场景
- 01为项目建立共享令牌基础
- 02配置浅色与深色主题值
- 03在制作页面前生成可复用设计尺度
- 04检查令牌引用和 WCAG 对比度
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ plugin87/ ux-ui-agent-skills --skill brandkit安装后在 Claude Code 中输入/brandkit确认已加载。
详细介绍
技能:品牌套件
步骤 0:套件在这里吗? 此技能会读取套件中的文件。请检查一次:
ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING仅当出现KIT_MISSING时,才表示只安装了技能文件夹,这是npx skills add的行为。请明确说明这一点,指引用户使用npx ux-ui-agent-skills init或安装插件,然后停止。不要猜测无法打开的文件 内容。
在绘制任何页面之前,先搭建基础体系(所有内容都从中渲染的一套令牌系统)。把这一步做好,每个页面都能从一个地方保持一致并支持主题化。
步骤
- 简报推断(必做):确定行业、受众、一个情绪形容词和动效深度(
${CLAUDE_SKILL_DIR}/../../../taste/design-taste.md→ 简报推断)。从${CLAUDE_SKILL_DIR}/../../../taste/aesthetic-systems.md中选择一个作为基调的原型。 - 基础值:使用 OKLCH 生成品牌色阶(11 个色阶,色度一致)和中性色阶;根据
${CLAUDE_SKILL_DIR}/../../../.claude/rules/tokens-and-color.md→ 颜色生成,验证 500 色阶在白色背景上的对比度 ≥ 4.5:1(文本),600 色阶 ≥ 3:1(UI)。 - 语义层:将角色映射到基础值(
action.primary/-hover/destructive、text.{primary,secondary,on-action,link}、surface.{page,card,raised}、border.{default,strong}、feedback.{success,warning,error,info}),并设计深色模式覆盖值(而非简单反转)。 - 比例:Major Third 字体比例 + 复合文本样式、4px 间距比例、圆角层级、海拔,以及符合
${CLAUDE_SKILL_DIR}/../../../tokens/motion.json风格的时长/缓动曲线。 - 输出:生成 DTCG
${CLAUDE_SKILL_DIR}/../../../tokens/*.json(三层)+ 单个theme.css(唯一共享来源,包含[data-theme="dark"]覆盖值)。也可选用令牌构建流水线(token-build技能)支持其他平台。
验证(完成标准)
python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_tokens.py:JSON 有效,所有别名都能解析。python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_contrast.py:所需的文本/操作/边框组合在浅色和深色模式下均符合 WCAG AA;border.strong≥ 3:1。python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_theme_refs.py:每个组件中的var(--…)都能在主题中解析。- 一个主题,不按页面定义调色板;destructive 使用 danger 令牌(而非 primary);不使用硬编码值。
输出是经过验证的令牌基础体系:可测量的部分有据可证(运行
npm run verify)。品牌“感觉”仍建议由人工对照${CLAUDE_SKILL_DIR}/../../../taste/design-taste.md进行审查。
评论
支持 Markdown