跳转到使用指南
interface-design作者 Dammyjay93

Interface Design Skill.

Claude Code 和 Codex 的 UI 设计 skill:专注工艺的界面设计,适用于仪表板、管理面板、SaaS 工具和设置页面。

  • Web & UI
  • UI 代码
Dammyjay93/interface-design · .claude/skills/interface-design/SKILL.mdSKILL.md
--- name: interface-design description: Craft-first interface design for dashboards, admin panels, SaaS apps, tools, settings pages, data interfaces, and interactive products. Use when designing, building, reviewing, auditing, or refining product UI where visual craft, layout hierarchy, tokens, states, visual direction, or design-system consistency matter. Not for marketing pages, landing pages, campaigns, or brand-only work. --- ## Scope ## One focal point per view ## Type scale is a ratio, and weight beats size ## Density is a decision, expressed in px ## Spatial rhythm — breathe unevenly ## Proportions speak
从上游文件读取的前言和章节标题(2026-09-14)· 完整内容 29,304 字符

01 功能说明

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

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

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

以 skill 自身的术语

一门以工艺为先的学科,用于构建产品界面——仪表盘、管理面板、SaaS 应用、工具、设置页面、数据界面——并做出顶级设计团队会做的决策。它要求在写代码之前先明确 brief:使用者是谁、他们前来完成的那一个动作是什么,以及界面应该给人带来怎样的、有实际意义的感受。

由此展开领域探索(domain、色彩世界、signature、被拒绝的默认方案),基于比例构建字号体系,让字重和颜色承担层级区分,确定一个明确的深度策略,使用语义化 token 而非硬编码字面量,并处理打磨与动效细节——等宽数字、同心圆角、亚 300ms 时长、高频操作不加动画。明确不适用于落地页、营销站点、campaign 或纯品牌工作。

它产出什么

  • 一份 Suggest + Ask 提案,列出 Domain、Color world、Signature、Rejecting 和 Direction。
  • 在有渲染工具的情况下,以内联方式渲染样本——调色板色块、以实际字体呈现的字号体系、堆叠的层级卡片、以真实组件呈现的 signature;实现本身仍落地到代码库中。
  • 一份保存的 .interface-design/system.md,记录方向、深度策略、层级决策和重复出现的组件模式,仅在用户确认同意后才写入。
查看示例提示词 ↗

工作方式

  1. 01
    撰写工作 brief

    在写任何代码之前,先回答清楚:使用者是谁、他们要完成的动作是什么、界面应该呈现什么感觉——除非方向需要确认,否则保持简洁。

  2. 02
    探索产品领域

    在提出方向之前先产出四项内容:至少 5 个 domain 概念、5 个以上取自产品所处物理世界的颜色、一个 signature 元素,以及 3 个应当拒绝的显而易见的默认方案。

  3. 03
    提出并确认方向

    以一个列出 Domain、Color world、Signature、Rejecting 和 Direction 的 Suggest + Ask 区块开场,然后在开始构建前确认方向是否合适。

  4. 04
    尽可能渲染样本

    如果当前会话具备内联可视化渲染工具,就以真实组件的形式展示调色板、字号体系、层级步骤和 signature,而不是用文字描述;否则退回到代码形式。

  5. 05
    基于现状构建,再进行验证

    检查应用、token、组件模式和 system.md,修改实现,在可用的情况下运行 build、类型检查或测试,然后在桌面和移动端宽度下进行可视化验证。

  6. 06
    主动提出保存这些模式

    任务完成后,主动提出记录方向、深度策略、层级决策和重复出现的组件模式,以便后续会话保持一致。

02 找到适合场景

何时使用 interface-design Skill

当工作是此类 UI 设计时,在 Claude Code 或 Codex 中使用 interface-design skill。适用范围和限制来自该 skill 的文件。

适合场景

  • 产品 UI 工作:仪表盘、管理后台、SaaS 应用、工具类产品、设置页面和数据界面。
  • 审查、审计或优化现有产品 UI,而不仅仅是构建新界面。
  • 全新界面、大型改版以及方向模糊的情况,此时可以先做一轮视觉参考再进入代码。
  • 在新工作中,确保现有 system.md 所声明的价值观得到遵守。

了解边界

  • 落地页、营销站点、campaign 和纯品牌工作,该文件会将其转交给营销或前端设计 skill 处理,而非自行处理。
  • 生成的图像素材仅覆盖空状态插图和纹理——绝不包括图标、logo 或图表。
  • 原生的 select 和日期输入框无法自定义样式,因此必须用 headless 基础组件替换,而不是手写实现。
  • 内联渲染是有条件的:在 CI、无头 Agent 或纯终端环境中没有可视化组件,此时 skill 会退回到代码、token 和书面提案。

需要提供的信息

  • 人物、动作与感觉Brief 必须用有意义的措辞说明谁打开这个界面、他们要完成什么、以及它应该给人怎样的感觉;如果无法确定,skill 会提出一个简明的问题或给出一个负责任的假设并继续推进。
  • 现有代码库会检查现有应用、设计 token、组件模式以及 .interface-design/system.md,以便复用现有的控件和样式,而不是重新发明。
  • 用于重绘的截图如果有可用的图像生成工具,可以在编写任何代码之前,将一张现有截图转化为更强的版本。

03 Skill 内部

interface-design Skill 给 Claude Code 和 Codex 的规则

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

  1. 运行编码前 Checkpoint

    在编写任何 UI 代码之前,即使是很小的改动,也要说明意图、层次、色板、深度、表面、字体和间距——并能说出每一项的理由。

  2. 先用原生,再用基础组件,最后才手写

    平台已经提供 button 或 link 时,绝不用带 onClick 的 div 来代替;像 select、combobox、dialog、popover、tooltip、tabs 和 date picker 这样的有状态控件,应来自经过验证的无头(headless)基础组件。

  3. 用 Token,而非硬编码字面值

    将样式绑定到语义化 token——如 bg-card、border-border、text-muted-foreground——而不是 bg-white、border-gray-200 或 text-gray-500,后者会破坏主题化和深色模式。

  4. 按比例递进字号,而非凭感觉

    选定一个比例并按其递进:密集或沉静的 UI 用约 1.2,多数产品 UI 用 1.25,富有表现力的界面用 1.333,从 14 到 16px 的正文字号开始,并按间距网格四舍五入为整数像素。

  5. 只选定一种深度策略并坚持

    选择纯边框、细阴影、分层阴影或表面色变化中的一种,并在全局保持一致;混用多种策略被列为应避免事项。

  6. UI 动效时长控制在 300ms 以内

    按钮按下 100 到 160ms,tooltip 和 popover 125 到 200ms,下拉菜单 150 到 250ms,使用自定义 ease-out,而不是较弱的内置曲线或 ease-in。

  7. 重复性操作不加动画

    每天执行 100 次以上的操作——键盘快捷键、命令面板——完全不加动画,因为这会让它们显得缓慢;modal、drawer 和 toast 仍应使用标准动画。

  8. 绝不从缩放为零开始做动画

    入场动画从缩放 0.95、透明度 0 开始,因为没有什么是从无到有出现的。

04 投入使用

在 Claude Code 或 Codex 中安装 interface-design

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

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

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

Terminal
npx skills add https://github.com/Dammyjay93/interface-design --skill interface-design

用于 .claude/skills/interface-design/SKILL.md 的通用 skills CLI 形式;仓库也可能自行记录其路径。

给 Skill 一个首次 UI 设计任务

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

Starter prompt
Build the settings page for [product], a SaaS tool. [The person] opens it to [task], and it should feel [feel], not like a generic admin panel. Our tokens and components live in [existing design system], so reuse those. The focal element is [focal element], and it needs loading, empty and error states.

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

检查首次结果

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

  • 替换测试——把字体换成常见字体,把布局换成标准模板;无论换到哪里都感觉不出差异的地方,就是你默认使用的部分。
  • 眯眼测试——眯起眼睛看;层次仍应清晰可辨,且不应有任何元素显得突兀刺眼。
  • 签名测试——指出五个具体元素来说明签名感体现在哪里;整体感觉不算数。
  • Token 测试——把 CSS 变量朗读出来,问问它们究竟属于这个产品的世界,还是属于任意项目。
  • 在内联渲染工具、本地浏览器或桌面与移动宽度的截图中查看结果。
  • 在展示任何内容之前,先修复重叠、破损的间距、空状态、无法阅读的文本、缺失的素材以及泛化的构图。

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

05 开源、可追溯

来源、许可与验证

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

Skill 文件
.claude/skills/interface-design/SKILL.md 验证时记录的内容校验和;提交 2f9be32
License
MIT 来自 LICENSE。
仓库星标数
5,692 GitHub 快照拍摄于 2026-09-14,针对整个 Dammyjay93/interface-design 仓库。不是 interface-design 的评分或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 适用范围用于仪表盘、管理面板、SaaS 应用、工具、设置页面;不适用于落地页或营销类工作。
  2. 意图优先先回答:这是给谁用的、他们必须完成什么、应该有什么感觉。
  3. 产品领域探索先产出领域概念、色彩世界、一个签名特征,以及 3 个被拒绝的默认方案。
  4. 在可能的地方渲染出来在提出方案、构建组件或做评审时,按条件渲染示例,同时把推理过程保留在文字中。
  5. 视觉 H
Skill 自身的描述
"为仪表板、管理面板、SaaS 应用、工具、设置页面、数据界面和交互式产品提供精工优先的界面设计。当设计、构建、审查、审计或优化产品 UI 时使用,适用于视觉精工、布局层次、token、状态、视觉方向或设计系统一致性重要的场景。不适用于营销页面、落地页、活动页或纯品牌工作。"

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

Interface Design

在真实 UI 设计任务上运行 interface-design。

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

终端
npx skills add https://github.com/Dammyjay93/interface-design --skill interface-design

OpenDesign 桌面客户端

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

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

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

支持 macOS 与 Windows