跳转到使用指南
visual-design-foundations作者 Seth Hobson

Visual Design Foundations Skill.

Claude Code 和 Codex 的品牌与设计系统 skill:排版、色彩理论、间距系统和图标设计,打造一致的视觉体验。

  • Brand & Design Systems
wshobson/agents · plugins/ui-design/skills/visual-design-foundations/SKILL.mdSKILL.md
--- name: visual-design-foundations description: Apply typography, color theory, spacing systems, and iconography principles to create cohesive visual designs. Use when establishing design tokens, building style guides, or improving visual hierarchy and consistency. --- ## When to Use This Skill ## Core Systems ## Quick Start: Design Tokens in Tailwind ## Typography Best Practices ## Color Theory ## Spacing Guidelines
从上游文件读取的 front matter 和章节标题,日期 2026-09-14 · 完整内容 7,218 字符

01 功能说明

visual-design-foundations Skill 在 Claude Code 和 Codex 中的作用

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

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

以 skill 自身的术语

该 skill 教授如何运用字体比例、色彩理论、间距系统和图标基础,构建统一且无障碍的视觉系统。它涵盖了以模块化字体比例、8 点网格间距、符合 WCAG 对比度要求的语义化色彩方案以及图标尺寸系统来建立 design token。

该 skill 提供了针对 Tailwind CSS、响应式流体字体排版、基于语义化 token 的深色模式主题,以及无障碍验证的具体实现模式。它通过定义基于比例的比例尺和可复用的 token 系统,来解决间距不统一、对比度不佳和随意使用魔法数字等常见视觉设计问题。

它产出什么

  • 以 CSS 自定义属性或 Tailwind 配置形式定义的 design token
  • 带尺寸变体的图标组件
查看示例提示词 ↗

工作方式

  1. 01
    建立模块化 design token

    定义基于比例的字体尺寸(0.75rem 到 3rem)、8 点网格间距(4px 到 64px),以及用于品牌、状态和中性色的语义化色彩 token。

  2. 02
    应用响应式字体排版

    使用带有 clamp() 的流体字体排版实现视口响应式尺寸,并将最佳阅读宽度控制在最多 65 个字符。

  3. 03
    实现无障碍色彩方案

    构建符合 WCAG 对比度要求的色彩系统:正文文字 4.5:1,大号文字与 UI 组件 3:1,并进行程序化对比度检查。

  4. 04
    创建一致的图标系统

    定义从 12px 到 32px 的图标尺寸比例,使用接受 size props 的可复用组件,并保持 flex-shrink-0 行为。

  5. 05
    使用语义化 token 设计暗色模式

    按用途而非外观命名语义化 token,从而可以通过 data attributes 切换主题,无需改动组件。

  6. 06
    保持垂直节奏

    对相邻元素应用一致的间距规则,使用既定的比例值,在整个界面中营造视觉和谐。

02 找到适合场景

何时使用 visual-design-foundations Skill

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

适合场景

  • 为新项目建立 design token
  • 创建或优化间距和尺寸系统
  • 构建无障碍色彩方案
  • 设计图标系统和视觉资产
  • 审查设计的视觉一致性

    需要提供的信息

    • 主题规范实现暗色模式或多主题系统时,关于语义化 token 策略的要求

    03 Skill 内部

    visual-design-foundations Skill 赋予 Claude Code 和 Codex 的规则

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

    1. 使用 8 点网格间距

      所有间距值必须遵循 4px 的倍数,从 0.25rem(4px)到 4rem(64px),使用既定的间距比例 token。

    2. 应用严格的行高范围

      标题应使用 1.1 到 1.3 的行高,正文文字使用 1.5 到 1.7,UI 标签使用 1.2 到 1.4,以保证良好的可读性。

    3. 将文字宽度限制在 65 个字符以内

      为正文文字设置 65ch 的 max-width,以保持最佳阅读宽度,避免在宽屏上造成视觉疲劳。

    4. 应用组件间距范围

      卡片内边距应为 16-24px,区块间距为 32-64px,表单字段间距为 16-24px,图标与文字间距为 8px,均使用间距比例。

    04 投入使用

    在 Claude Code 或 Codex 中安装 visual-design-foundations

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

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

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

    Terminal
    npx skills add https://github.com/wshobson/agents --skill visual-design-foundations

    适用于 plugins/ui-design/skills/visual-design-foundations/SKILL.md 的通用 skills CLI 形式;具体仓库可能会有自己的文档路径。

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

    按 skill 自身的术语撰写;把括号中的部分换成你的内容。

    Starter prompt
    Create a design token system for [project name] with an 8-point spacing grid, modular typography scale from 12px to 48px, and an accessible color palette including primary brand color [hex value], semantic status colors for success/warning/error, and a complete neutral gray scale. Implement both light and dark mode variants using semantic token naming. Include Tailwind configuration and verification that all text combinations meet WCAG AA contrast requirements.

    来源:依据 SKILL.md,按 skill 自身的术语撰写。

    检查首次结果

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

    • 使用程序化检查,验证所有文字与 UI 组件色彩组合是否满足 WCAG 对比度要求
    • 测试字体加载是否使用 font-display swap 以避免布局偏移
    • 确保响应式排版使用 clamp 函数在不同视口尺寸下平滑缩放

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

    05 开源、可追溯

    来源、许可与验证

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

    Repository
    github.com/wshobson/agents 分支 main
    Skill 文件
    plugins/ui-design/skills/visual-design-foundations/SKILL.md 内容校验和记录于验证时;提交 4236bb9
    License
    MIT 来自 LICENSE。
    仓库星标数
    39,635 GitHub 快照摄于 2026-09-14,针对整个 wshobson/agents 仓库,该仓库在此目录中包含 18 个 skills。不是 visual-design-foundations 的评分或使用计数。
    已由 OpenDesign 验证
    2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

    SKILL.md 内部

    1. 何时使用此 Skill列举了建立 token、构建配色方案、审查一致性、实现暗色模式等场景
    2. 核心系统通过 CSS 自定义属性定义模块化字体比例、8 点间距网格和语义化颜色 token 结构
    3. 快速开始:Tailwind 中的设计 token提供 Tailwind 配置示例,通过自定义字体、尺寸、颜色和间距值扩展主题
    4. 字体排印最佳实践涵盖字体搭配组合、使用 clamp 实现响应式流体字体,以及防止字体加载时的布局偏移
    5. 色彩理论详述 WCAG 对比度要求、深色模式实现策略,以及程序化对比度检测函数
    6. 间距指南规定组件间距范围,并演示正文内容的垂直节奏模式
    7. 图标系统定义从 12px 到 32px 的图标尺寸体系,并提供 TypeScript 图标组件实现
    8. 最佳实践七项原则,包括建立约束、记录决策、测试可访问性和使用语义化命名
    9. 常见问题列举间距不一致、对比度不足、字体过载、魔法数字以及缺乏深色模式规划等问题
    Skill 自身的描述
    "应用排版、色彩理论、间距系统和图标原则来创建连贯的视觉设计。用于建立 design tokens、构建风格指南或改进视觉层次和一致性时使用。"

    来自 SKILL.md 的前言描述。完整文件约 7,218 个字符。在 GitHub 上阅读完整文件。

    Visual Design Foundations

    在真实的品牌与设计系统工作任务中运行 visual-design-foundations。

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

    终端
    npx skills add https://github.com/wshobson/agents --skill visual-design-foundations

    OpenDesign 桌面客户端

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

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

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

    支持 macOS 与 Windows