Taste Skill 新手教程

Taste Skill 新手教程

给你的 AI Agent 装上「设计品味」:让 Cursor CLI、Claude Code、Codex 生成的前端页面告别紫色渐变加三张等宽卡片的模板脸。本教程以 Cursor CLI 为主线,带装、带例子、带踩坑。

GitHub 源项目 13 个技能 npx 一键安装 MIT 开源

1这是什么

一句话:taste-skill 是一套便携式 Agent Skills,把「设计品味」写成 AI 能读懂并执行的指令文件。

官方的副标题叫 The Anti-Slop Frontend Framework for AI Agents(反平庸前端框架)。它解决的不是「会不会写代码」,而是「写出来的 UI 一股 AI 味」:居中大标题、紫色渐变、三张一模一样的功能卡、假到出戏的 99.99% 数据。装上它之后,agent 在动手写界面前会先推断设计方向、设定风格参数,交付前还会跑一遍自查清单。

13个技能(10 个实现类 + 3 个图像类)
3个风格拨盘(布局 / 动效 / 密度)
80+兼容 agent(Cursor / Claude Code / Codex 等)
v2当前主版本(experimental,v1 保留)

它不做什么

不是组件库

不提供任何可 npm 安装的 UI 组件,产出的是代码与设计决策,不是依赖包。

不是设计系统

不定义官方色板或字体。相反,它会优先对接 Fluent、Carbon、shadcn 这类既有系统。

不碰业务逻辑

只管界面层的布局、排版、动效、间距。后端、状态管理、数据流一概不介入。

图像技能不出码

imagegen / brandkit 三个技能只生成参考图,要落地还得多装一个 image-to-code。

2为什么需要

先想想:你平时是怎么跟 agent 描述「页面要好看」的?大概率是下面三种之一,而它们都不太管用。

常见做法实际结果
在 prompt 里手写一大段审美要求每次开新会话都要重写;约束太长,模型抓不住重点,转头还是紫渐变。
把设计规范文档丢进上下文几千 token 的规范里,关键禁令被稀释,agent 「读了但没执行」。
换更强的模型模型再强,默认审美偏差是一样的,slop 只是换了个更精致的版本。

taste-skill 的核心洞察是:品味不该写在 prompt 里,该写成技能文件。它的规则不是拍脑袋定的,仓库的 research/ 目录里沉淀了系统性研究(如 100 AI Design Tells),把「AI 味」逐条拆成可检查的禁令;再配上三个可调拨盘和交付前的 pre-flight 自检,把「好看」从玄学变成流程。

SKILL.md 是一种可移植的指令文件:agent 在匹配场景时自动加载,平时不占上下文。这正是「技能」与「规则文件」最大的区别:按需触发,而不是常驻。

3核心流程

五步:装技能 → agent 加载 → 推断方向 → 按设计系统出码 → 自检交付。

关键在第 3 步:agent 不会上来就写代码,而是先读你的 brief,输出一行 Design Read(「我把这个需求理解为:面向 XX 受众的 XX 页面,走 XX 风格」),模糊时最多只问你一个澄清问题,然后才开工。这个「先读题再动笔」的协议是 v2 新增的。

4安装

统一入口是一条 npx 命令,CLI 会把技能装到你机器上各个 agent 的技能目录。

# 全量安装(13 个技能全装,推荐先跑这条看看清单)
npx skills add https://github.com/Leonxlnx/taste-skill

# 只装主技能(v2,install name 是 design-taste-frontend)
npx skills add https://github.com/Leonxlnx/taste-skill --skill "design-taste-frontend"

# 依赖旧版行为的项目,锁定 v1
npx skills add https://github.com/Leonxlnx/taste-skill --skill "design-taste-frontend-v1"

# 安装前先看仓库里有哪些技能可选
npx skills add https://github.com/Leonxlnx/taste-skill --list

几点说明:

  • CLI 会自动检测你机器上装了哪些 agent(Cursor、Claude Code、Codex 等),一个都没检测到时会让你手动勾选装给谁。
  • 默认装到项目级目录,随仓库提交、团队共享;加 -g 装到用户级,所有项目通用。
  • 重跑同一条命令即可升级到最新版(install name 不变,v2 已是默认)。
  • 也可以完全手动:把任意 SKILL.md 复制进项目,或者直接粘进对话框。
v2 目前标记为 experimental。生产项目求稳可以直接装 design-taste-frontend-v1,两者 install name 不同,可共存对比。

513 个技能怎么选

每个技能只做一件事。实现类输出代码,图像类只出参考图。

实现类(输出代码)

技能文件夹install name干什么用
taste-skilldesign-taste-frontend主技能 v2:读 brief 推断设计语言,调三拨盘,带 pre-flight 自检。新手从这里起步。
taste-skill-v1design-taste-frontend-v1原版 v1,保留给依赖旧行为的项目。
gpt-tasteskillgpt-tasteGPT / Codex 严控变体:布局差异更大、GSAP 更强、anti-slop 更激进。
image-to-code-skillimage-to-code图像优先流水线:生成参考图 → 分析 → 实现前端。
redesign-skillredesign-existing-projects审计现有项目 UI,修复布局 / 间距 / 层级。先审计再动手。
soft-skillhigh-end-visual-design「平静的贵感」:柔对比、大留白、premium 字体。
output-skillfull-output-enforcement强制完整输出,禁止占位注释和「此处省略」。
minimalist-skillminimalist-ui编辑器风产品 UI(Notion / Linear 那一路)。
brutalist-skillindustrial-brutalist-ui瑞士字体网格、硬朗工业风、实验性布局。
stitch-skillstitch-design-tasteGoogle Stitch 兼容,支持可选的 DESIGN.md。

图像类(只出图)

技能文件夹install name干什么用
imagegen-frontend-webimagegen-frontend-web网站参考帧:hero、landing、多 section 构图。
imagegen-frontend-mobileimagegen-frontend-mobile移动端屏幕与流程的参考帧。
brandkitbrandkit品牌板:logo 方向、配色、字体、应用样例。
官方选择指南:从 design-taste-frontend 起步;依赖原版装 v1;要严控装 gpt-taste;改版用 redesign;定好方向后再换 soft / minimalist / brutalist 这类风格专精版。

6Cursor CLI 实战

本章是全文重点:从安装到三个完整例子,全部围绕 Cursor CLI 展开。

6.1 把技能装进 Cursor

skills CLI 给 Cursor 的安装路径是固定的:项目级装到 .agents/skills/(随仓库提交,团队共享),全局级装到 ~/.cursor/skills/(本机所有项目可用)。

# 方式一:装进当前项目(默认,项目级)
cd ~/projects/my-app
npx skills add https://github.com/Leonxlnx/taste-skill -a cursor

# 方式二:装到全局,所有项目都能用(个人开发机推荐)
npx skills add https://github.com/Leonxlnx/taste-skill -a cursor -g -y

# 只装主技能 + 全局(最常用的组合)
npx skills add https://github.com/Leonxlnx/taste-skill --skill "design-taste-frontend" -a cursor -g -y
  • -a cursor:明确指定装给 Cursor(不加的话 CLI 按自动检测结果走,可能会问你要装给谁)。
  • -g:全局;-y:跳过确认直接装。
  • 默认用 symlink 复用文件,想装成独立副本加 --copy。

装完验证一下文件确实落位:

# 项目级装在这
ls .agents/skills/

# 全局装在这
ls ~/.cursor/skills/
# 应该能看到 design-taste-frontend/SKILL.md 等目录

6.2 Cursor CLI 里怎么触发

Cursor 的 agent 会扫描技能目录里的 SKILL.md,根据 frontmatter 的 description 判断当前任务是否命中。命中前端 / UI 场景时自动生效,平时不占上下文。两种触发姿势:

  • 自动触发:直接描述前端任务即可,比如「给我的产品做个落地页」,命中 description 就会带上技能。
  • 显式点名(推荐):在 prompt 里写明 follow the design-taste-frontend skill,确保技能被加载,避免该触发时没触发。
技能没生效时按三步排查:① 确认装到了正确路径(见 6.1 的 ls 验证);② 确认 SKILL.md 的 frontmatter 是合法 YAML;③ 重开一次 Cursor CLI 会话再试。

6.3 实战一:从零生成落地页

场景:给精品咖啡品牌做一个新落地页。在 Cursor CLI 会话里输入:

follow the design-taste-frontend skill.

给我的精品咖啡品牌 Bloom Roastery 做一个落地页。
受众是城市白领,走温暖、有质感、克制的方向:
布局常规一点(DESIGN_VARIANCE 6),动效克制(MOTION_INTENSITY 3),
信息密度放低,多留白(VISUAL_DENSITY 3)。

预期发生的事:agent 先输出一行 Design Read 复述理解,声明三个拨盘取值,然后按 React / Tailwind 的默认架构出码,最后跑 pre-flight 清单。不会发生的事:它不会问你「要用什么配色」这类能从 brief 推断的问题;也不会产出居中 hero 加紫色渐变的模板脸。

拨盘可以直接写在 brief 里覆盖默认值,这是最实用的控制手法:想要「常规一点的布局」不用解释半天,写 DESIGN_VARIANCE 6 就够了。

6.4 实战二:改造现有项目的 UI

场景:项目已经能跑,但界面是「AI 味重灾区」。装上重设计技能:

npx skills add https://github.com/Leonxlnx/taste-skill --skill "redesign-existing-projects" -a cursor -g -y

然后在项目里让 agent 先审计、后动手:

follow the redesign-existing-projects skill.

audit the UI of this project first: list what to preserve vs overhaul,
then fix layout / spacing / hierarchy. Don't touch business logic.

这个技能的协议是 audit-first:先给出「保留 vs 重做」清单,你确认后它才改代码,避免一上来把你的品牌色全冲掉。

6.5 实战三:先出图、再写码

场景:想先看到效果再实现。装两个技能配合使用:

npx skills add https://github.com/Leonxlnx/taste-skill --skill "imagegen-frontend-web" -a cursor -g -y
npx skills add https://github.com/Leonxlnx/taste-skill --skill "image-to-code" -a cursor -g -y

prompt 里按 README 建议把流水线声明出来:

follow the skill: generate images, then analyze, then code.

给 Bloom Roastery 落地页生成 3 张不同方向的桌面端参考帧,
我选定后分析构图与配色,再实现成代码。

参考帧也可以用 ChatGPT Images 这类外部生成器出:先用图像技能的提示词拿到帧图,再把图喂给 Cursor CLI 里的编码 agent 实现。图像技能与实现技能是解耦的,随便搭配。

6.6 日常管理

npx skills list        # 列出项目级 + 全局已装技能
npx skills list -g     # 只看全局
npx skills find taste  # 在技能生态里按关键词搜索
npx skills ls -a cursor -g   # 只看 Cursor 全局装了什么

升级就是重跑安装命令(install name 不变,原地覆盖为最新)。想卸载直接删对应技能目录即可。

7三个拨盘

v2 的核心配置就三个 1-10 的旋钮,装在技能文件顶部,brief 里也能临时覆盖。

拨盘默认拨到 1拨到 10
DESIGN_VARIANCE 布局实验性8完美对称、居中干净不对称、艺术化混乱
MOTION_INTENSITY 动效深度6几乎静态,只有 hover电影感、物理动效、磁吸
VISUAL_DENSITY 信息密度4画廊式大留白驾驶舱式数据密集

不在 brief 里写拨盘时,技能会按内置规则从你的描述词推断:

brief 里的关键词VARIANCEMOTIONDENSITY
minimalist / clean / calm / Linear 风5-63-42-3
premium / Apple 味 / luxury7-85-73-4
trust-first / 政务 / 公共部门3-42-34-5
变量名必须用原名(DESIGN_VARIANCE / MOTION_INTENSITY / VISUAL_DENSITY),写成 LAYOUT_VARIANCE 之类的自造别名技能不认。

8反 slop 禁令

技能的「品味」来自一条条可检查的禁令。挑最有代表性的几类感受一下严格程度。

类别禁令(节选)
Em-dash(最严重)— 全文零容忍,出现在任何位置即自检不通过;en-dash 作分隔符也禁,日期范围用普通连字符(2018-2026)。
视觉禁霓虹外发光、禁纯黑 #000000、禁过饱和强调色、禁自定义鼠标指针。
排版Inter 不作默认字体、禁超大 H1;衬线体只用于编辑类 / 奢侈品语境。
布局禁三张等宽功能卡横排、禁数学上完美均匀的间距。
内容禁假人名(Jane Doe)、禁假完美数据(99.99%)、禁空话动词(Elevate / Seamless)、禁占位品牌名(Acme / Nexus)。
生产味痕迹禁版本标签(V0.6 / BETA)、禁章节编号眉题(001 · Capabilities)、禁 Scroll to explore 提示、禁装饰性状态圆点。
资源禁手绘 SVG 图标(用 Phosphor / Radix 等图标库)、禁用 div 拼假截图、禁失效图床(用 picsum.photos/seed/)。

为什么连一个破折号都要赶尽杀绝?因为它是 LLM 生成文本里最典型、最容易被一眼识破的「指纹」。taste-skill 的思路是:slop 不是抽象概念,而是一张可以逐条排查的清单。

9交付前自检(Pre-flight)

v2 把自检写成硬性协议(原文标注 THIS IS NOT OPTIONAL),任一项不过就不许交付。

  • 过程项:Design Read 已声明?三个拨盘取值已写明?改版场景先做了审计?
  • 一致性锁:全页一个主题不中途反色;一个强调色贯穿始终;一个圆角体系。
  • 首屏纪律:Hero 必须完整装进首屏:大标题不超过两行,副文案不超过 20 词,CTA 首屏可见。
  • 可访问性:按钮对比度过 WCAG AA;动画只动 transform / opacity;尊重系统「减弱动态效果」设置。
  • 工程项:深浅双模式都要能看;移动端折叠行为明确;空态 / 加载 / 错误态都处理;用真实图片而非 div 假截图。
  • 文案自查:引用不超过三行;声称了的动效必须真的做出来;禁令清单逐条过一遍。
这份清单本身就是免费的「设计验收标准」:就算不用任何 agent,人工评审页面时按这 30 多条过一遍,也能拦下八成的 AI 味。

10FAQ / 踩坑

装了但 Cursor 好像没生效?
按三步排查:① ls ~/.cursor/skills/(全局)或 ls .agents/skills/(项目级)确认技能目录在位,里面要有 SKILL.md;② 打开 SKILL.md 确认 frontmatter 的 name / description 是合法 YAML;③ 重开一次 Cursor CLI 会话。还不行就在 prompt 里显式点名技能名强制触发。
和 .cursor/rules、AGENTS.md 是什么关系?
rules 和 AGENTS.md 是常驻上下文:每个会话都加载,适合放项目约定。技能是按需触发:命中场景才加载,适合放这种几百行的专项设计指令。taste-skill 若做成常驻规则会白白吃掉大量 token,且会污染与前端无关的任务。
v2 和 v1 怎么选?
v2 是完全重写(experimental):新增 Brief 推断、三拨盘、深色模式协议、改版协议、pre-flight 硬自检和 em-dash 全禁。新项目直接 v2;老项目行为依赖 v1 输出的,装 design-taste-frontend-v1 锁定,两个可共存。
支持 React 以外的框架吗?
支持。技能规则针对「设计意图」而非框架 API,官方 FAQ 明确 React / Vue / Svelte 都行。默认架构写的是 React / Next.js + Tailwind v4 + motion/react,你可以在 brief 里声明其他技术栈。
只想要好看的图,不要代码?
只装图像类三件套(imagegen-frontend-web / imagegen-frontend-mobile / brandkit)即可,它们只出参考图。要落地成代码再补装 image-to-code。
不想安装,能临时用一次吗?
可以。npx skills use Leonxlnx/taste-skill --skill design-taste-frontend 会把技能内容写进临时目录并输出提示文本,配合管道喂给任意 CLI agent;也可以直接把 SKILL.md 内容粘进对话框。适合先试效果再决定装不装。
收费吗?
技能本体 MIT 协议完全免费。README 里的赞助商(Kimi、Vercel 等)是开源赞助,不影响功能;页面上的 affiliate 链接是作者的收入来源,与使用无关。另外注意:官方声明该项目没有任何 token / coin,谨防仿冒。

11参考链接

以下是一手资料入口,本教程的数字与命令均出自这些原文。

资源说明
GitHub 仓库项目主仓库,README 含完整技能表与安装说明。
skills/ 目录13 个技能的 SKILL.md 原文,主技能约 15 个章节。
research/ 目录反 slop 背景研究:根因分析、修复方案、发现记录。
skills CLInpx skills 命令的来源,含 80+ agent 的路径映射表。
MIT License开源协议原文。

仓库结构

taste-skill/
├── skills/      # 13 个技能,每个一个 SKILL.md
├── research/    # 反 slop 研究(根因 / 修复 / 发现)
├── examples/    # 用 taste-skill 做出的效果截图
├── assets/      # 赞助商标等静态资源
├── scripts/     # 辅助脚本
├── skill.sh     # 安装 / 注册脚本
└── CHANGELOG.md

Taste Skill 新手教程 · 基于 Leonxlnx/taste-skill 整理