Communitygithub.com

iamk3nnyt/claude-skills

从参考站点或粘贴的HTML中提取视觉系统(颜色角色、排版比例、间距比例、圆角、阴影、按钮/卡片/眉毛元素解剖结构、色调),并将其映射到当前项目的现有令牌上,生成一个简短的令牌表。当用户分享参考(“让它看起来像<站点>”、“按照这种风格”、URL或HTML粘贴)并在重新设计前使用。

claude-skills 是什么?

这个技能旨在帮助AI代理(如Claude Code)在重新设计项目时,从用户提供的参考站点或粘贴的HTML中系统性地提取视觉设计系统。它通过自动化捕获参考的视觉样式(包括颜色角色、排版、间距、圆角、阴影以及按钮、卡片等组件的结构),然后将其映射到当前项目的现有设计令牌上,生成一个对比表格,清晰列出每个设计角色的参考值、当前项目令牌值以及建议的更改(保留、调整或新增)。该技能支持多种平台(如Claude Code、Cursor、Codex等),通过读取项目的CSS变量(如`app/globals.css`中的`@theme`/`:root`)、Tailwind配置或主题文件来获取现有令牌。它遵循严格的设计规则,例如优先调整现有令牌而非新增,检查对比度(文本≥4.5:1,UI≥3:1),并在最终代码更改前要求用户审核令牌表,确保设计决策透明且可追溯。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamk3nnyt/claude-skills/tree/HEAD/skills/design-ref

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

设计参考

参考:$ARGUMENTS

1. 捕获参考

URL: 使用共享工具包在1440和375宽度下截图,然后读取样式表:

node ${CLAUDE_SKILL_DIR}/../ui-audit/scripts/audit.mjs <url> --widths 375,1440 --no-axe --out /tmp/design-ref/<host>

通过--inject拉取计算后的样式,或使用一次性CDP脚本导入${CLAUDE_SKILL_DIR}/../ui-audit/scripts/cdp.mjs(launch() → navigate() → evaluate())。对body、h1–h3、p、a、button、主CTA、卡片、眉毛/kicker元素、输入框和页脚进行getComputedStyle采样。收集font-family/size/weight/line-height/letter-spacing、color、background、border-radius、box-shadow、padding和gap。

粘贴的HTML/邮件: 将其保存到/tmp/design-ref/ref.html,使用render-html.mjs渲染,并直接读取内联样式。

2. 提炼系统

  • 颜色角色: 画布、表面、墨水、柔和墨水、强调色、强调色墨水、边框、成功/警告。给出十六进制值以及每种颜色出现的位置。
  • 排版: 字体家族(如果字体需要许可,给出最接近的免费替代品)、缩放步进的px/行高/字重/字间距,以及大小写(眉毛元素是否大写并增加字间距?)。
  • 间距: 实际使用的节奏(例如8/16/24/40/64)、章节内边距和卡片内边距。
  • 形状: 每种元素类别的圆角值、阴影配方和边框粗细。
  • 解剖结构: 按钮(高度、内边距、圆角、字重、图标)、卡片、眉毛元素和主角布局。
  • 色调: 3个形容词加上文案的特点(短句?第二人称?数字?)。

3. 映射到项目上(不要分叉)

读取项目的令牌(app/globals.css中的@theme/:root、tailwind.config或主题文件)及其现有组件。生成:

角色参考值当前项目令牌建议
强调色#FF5A1F--color-brand #…保留 / 调整值 / 新的(需说明理由)

规则:

  • 在新增令牌之前优先调整现有令牌。每个新增令牌都需要一行理由。
  • 品牌锁定的项目不触碰:徽标、项目已有的品牌颜色以及已经许可或正在使用的字体。
  • 检查每个建议的强调色在画布上以及墨水在表面上的对比度(文本≥4.5:1,UI≥3:1)。
  • 如果项目保持Figma文件与代码同步,则令牌更改在同一任务中放入Figma。

退出标准

  • 令牌表完成,每行标记为保留、调整或新增。
  • 已检查建议对的对比度。
  • 尚未更改代码。那是design-pass阶段,在用户同意表格之后进行。
  • 给用户一句总结,并在下方附上表格。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能