跳转到使用指南
design-system作者 nextlevelbuilder

Design System Skill.

一个用于品牌和设计系统工作的 Claude Code 和 Codex skill:三层设计 token、组件规范和幻灯片生成。

  • Brand & Design Systems
  • 设计系统
nextlevelbuilder/ui-ux-pro-max-skill · .claude/skills/design-system/SKILL.mdSKILL.md
--- name: design-system description: Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing/typography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations. --- ## When to Use ## Token Architecture ## Script Paths ## Quick Start ## Component Spec Pattern ## Scripts
从上游文件读取的前置内容和章节标题,2026-09-14 · 完整内容共 7,414 字符

01 功能说明

design-system skill 在 Claude Code 和 Codex 中做什么

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

生成三层设计 token 架构(primitive → semantic → component)、组件规格,以及符合品牌规范的演示幻灯片。Primitive token 定义原始值,例如 --color-blue-600。Semantic token 按用途为其取别名(--color-primary)。Component token 指定每个组件的具体用法(--button-bg)。

该 skill 提供用于 CSS 变量、Tailwind 主题集成的生成与校验脚本,以及一个基于 BM25 搜索的上下文幻灯片系统,覆盖 15 种版式结构、25 种布局,以及 Duarte 情感曲线(sparkline)。所有幻灯片必须导入 design-tokens.css 并只能使用 CSS 变量。数据可视化需要 Chart.js。支持通过 Pexels 和 Unsplash 获取图片。

它产出什么

  • Token 校验报告,用于识别源代码中应引用 token 却写成硬编码值的部分
查看示例提示词 ↗

工作方式

  1. 01
    加载 Token 架构参考文档

    该 skill 会在生成或校验 token 之前加载 references/token-architecture.md,以确立三层 token 结构。

  2. 02
    从 JSON 配置生成 CSS

    使用 JSON 配置文件运行 generate-tokens.cjs,输出一个以 CSS 变量形式呈现三层 token 结构的 CSS 文件。

  3. 03
    按目标搜索幻灯片策略

    通过 search-slides.py 使用 BM25 搜索,从 slide-strategies.csv 中查找匹配的版式结构、情绪曲线和数据节奏点,可按领域(文案或图表)以及上下文位置进行过滤。

  4. 04
    应用上下文决策流程

    解析目标后,查询 slide-layout-logic.csv 获取布局与 break_pattern 标记,查询 slide-typography.csv 获取字号层级,查询 slide-color-logic.csv 获取色彩处理方式,查询 slide-backgrounds.csv 获取图片分类。

  5. 05
    使用设计 token 生成 HTML

    创建幻灯片 HTML,导入 assets/design-tokens.css,所有样式均使用 var(),包含用于图表的 Chart.js,并添加来自 slide-animations.css 的导航与动画类。

  6. 06
    验证 Token 合规性

    运行 slide-token-validator.py,检查生成的幻灯片 HTML 是否完全使用 CSS 变量,且不包含任何硬编码的颜色、字体或间距值。

02 找到适合场景

何时使用 design-system Skill

当工作是此类品牌与设计系统工作时,在 Claude Code 或 Codex 中使用 design-system skill。适用范围和限制来自该 skill 自己的文件。

适合场景

  • 创建具有三层架构的设计 token 系统,用于主题切换和组件自定义
  • 定义组件状态规范,包括悬停、激活和禁用变体
  • 生成符合品牌规范的演示文稿幻灯片,具有上下文版式选择和情绪曲线规划
  • 使用组件 token 将设计规范转换为 Tailwind 主题配置
  • 通过系统化的间距与字号层级实现设计到代码的交接

了解边界

  • 不允许使用硬编码的颜色、字体或间距值;所有样式必须使用来自 design-tokens.css 的 CSS 变量

需要提供的信息

  • 品牌指南文档docs/brand-guidelines.md 提供品牌标识、语调和色彩定义,用于指导基础 token 的提取。
  • 用于验证的源目录供 validate-tokens.cjs 扫描的项目目录路径,用于查找应使用 token 而非硬编码的值。

03 Skill 内部

design-system Skill 为 Claude Code 和 Codex 定下的规则

SKILL.md 为 Agent 设定的 8 条具体指令、默认值与限制——文件中真正改变结果的部分。

  1. 切勿在组件中使用原始十六进制颜色

    组件必须始终通过 CSS 变量引用 token,绝不能直接硬编码颜色值。

  2. 所有幻灯片必须导入 design-tokens.css

    每个幻灯片 HTML 文件都必须导入 assets/design-tokens.css 作为唯一真实来源,并对所有样式属性使用 var()。

  3. 使用 Chart.js 进行数据可视化

    图表必须使用 Chart.js(4.4.1 或更高版本)渲染,而不是仅用 CSS 实现的条形图或其他方式。

  4. 脚本路径相对于 SKILL.md 所在目录

    像 scripts/generate-tokens.cjs 这样的脚本路径是相对于包含 SKILL.md 的目录,而非项目根目录。

  5. 使用 HSL 格式控制透明度

    Token 值应使用 HSL 颜色格式,以便在不重复定义 token 的情况下调整透明度。

  6. 在 1/3 与 2/3 位置设置节奏转折

    高质量演示文稿在“现状”(挫败感)与“愿景”(希望)情绪之间交替,节奏转折点按照 Duarte sparkline 方法,计算在整套幻灯片的 1/3 和 2/3 位置。

  7. 幻灯片必须聚焦于说服力

    所有生成的幻灯片都必须包含导航(键盘方向键、点击、进度条),内容居中对齐,并聚焦于说服或转化目标。

  8. 记录每个 token 的用途

    每个 token 定义都必须包含说明文档,解释其在系统中的预期用途。

04 投入使用

在 Claude Code 或 Codex 中安装 design-system

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 design-system 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill --skill design-system

用于 .claude/skills/design-system/SKILL.md 的通用 skills CLI 形式;具体仓库可能会记录其自有路径。

为 Skill 分配第一个品牌和 design-system 工作任务

使用你自己的内容和约束调整此提示,然后在 Claude Code 或 Codex 中运行它。

Example prompt
/slides:create "10-slide investor pitch for ClaudeKit Marketing"

来源:SKILL.md 示例(原文照录)。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 确认已包含 Chart.js 脚本标签,且图表使用 Chart.js 构造函数而非纯 CSS 渲染
  • 检查组件规范是否遵循状态表格模式,包含 default、hover、active 与 disabled 列
  • 查看 assets/designs/slides/claudekit-pitch-251223.html 中的参考实现,核对功能完整性

在 OpenDesign 中通过它 SKILL.md 里的链接导入 design-system:Plugins → Add → Skill → Import from link,然后在顶栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Skill 文件
.claude/skills/design-system/SKILL.md 验证时记录的内容校验和;提交 7f69fed
License
MIT 来自 LICENSE;SKILL.md 显示"MIT"。
仓库星标数
127,450 GitHub 快照于 2026-09-14 拍摄,针对整个 nextlevelbuilder/ui-ux-pro-max-skill 仓库,该仓库在此目录中包含 7 个 skill。不是 design-system 的评分或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 适用场景设计 token、组件规范、CSS 变量、间距比例、设计到代码交付、Tailwind 配置、幻灯片生成
  2. Token 架构三层结构:原始值(primitive)、语义用途别名(semantic)、组件专用 token,并附带 CSS 变量示例
  3. 脚本路径脚本路径相对于 SKILL.md 所在目录;文件访问以项目根目录为工作目录
  4. 快速开始用于从 JSON 配置生成 token,并在源码目录中校验 token 使用情况的命令
  5. 参考文档七份参考文件,涵盖架构、primitive/semantic/组件 token、规范、状态、变体、Tailwind 集成
  6. 组件规范模式用于在 default、hover、active、disabled 状态下定义组件属性的表格结构
  7. 脚本五个脚本:token 生成、校验、BM25 幻灯片搜索、幻灯片 token 校验、图片获取
  8. 模板具备三层 token 结构的初始 JSON 模板
  9. 集成从品牌中提取 primitive,将组件 token 提供给 Tailwind;依赖 brand 与 ui-styling skill
  10. 幻灯片系统使用设计 token、Chart.js、情境化决策 CSV、BM25 搜索生成符合品牌规范的演示文稿
  11. 唯一事实来源品牌指南、design-tokens.json 与 .css、slide-animations.css 定义了所有幻灯片样式
  12. 幻灯片搜索(BM25)按目标搜索幻灯片模板,支持领域筛选与情境参数(位置、总数、上一情绪)
Skill 自身的描述
「token 架构、组件规范和幻灯片生成。三层 token(基础→语义→组件)、CSS 变量、间距/排版比例、组件规范、战略性幻灯片创建。用于设计 token、系统化设计、符合品牌的演示文稿。」

SKILL.md 的 front-matter 描述。完整文件约 7,414 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 design-system skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

哪些 Agent 应该使用此 skill?

该 skill 指定 ui-ux-designer 和 frontend-developer 作为主要 Agent。它与 brand skill(用于从品牌色彩和字体中提取 primitive)以及 ui-styling skill(用于将组件 token 输入 Tailwind 配置)集成。

Design System

在真实品牌和 design-system 工作任务上运行 design-system。

下载 OpenDesign,从其 SKILL.md 链接导入 design-system,粘贴上述提示,在结果前阅读计划。

终端
npx skills add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill --skill design-system

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows