Designer Skills开发者指南如何编写高质量Skill深入解析SKILL_TEMPLATE架构与目录结构【免费下载链接】designer-skillsDesigner Skills Collection: agentic skills, commands, and plugins for design — from research to systems, UI, interaction, and delivery.项目地址: https://gitcode.com/gh_mirrors/de/designer-skillsDesigner Skills是一个为 AI 智能体Agent时代打造的开源设计技能集合designer-skills项目包含 241 个 skills 和 91 个 commands覆盖用户研究、设计系统、UI、交互到交付的完整设计流程。本文面向新手贡献者手把手讲解如何编写高质量 Skill从项目目录结构、SKILL_TEMPLATE.md 模板架构到 frontmatter 校验规则和官方质量清单一篇讲透。一、先搞懂概念Skill 是名词Command 是动词 在动手写之前必须先分清项目的两大核心构件这是整个架构的地基构件本质角色存放位置Skill领域知识单元名词教会 AI 某项设计知识如如何定义设计 Token插件/skills/技能名/SKILL.mdCommand工作流动词把多个 Skill 串起来完成完整任务插件/commands/动词.md用官方的话说你日常主要调用 Commands而 Skills 在它们底层运行。 例如 /design-research:discover 一条命令就会依次调用 persona、empathy map、journey map 三个 Skill跑完整个用户研究发现周期。 写 Skill 前先问自己这是知识还是流程是知识就写 Skill是流程就写 Command。二、项目目录结构你的新 Skill 该放哪项目按「插件plugin→ skills/commands」两层组织每个插件对应一个设计领域。整体结构如下designer-skills/ ├── SKILL_TEMPLATE.md # Skill 写作模板本文主角 ├── COMMAND_TEMPLATE.md # Command 写作模板 ├── CONTRIBUTING.md # 贡献指南与质量清单 ├── scripts/ │ └── lint-frontmatter.py # frontmatter 自动校验脚本 ├── design-research/ # 用户研究插件12 skills 4 commands │ ├── skills/ │ │ └── interview-script/ │ │ └── SKILL.md │ └── commands/ │ └── discover.md ├── design-systems/ # 设计系统插件11 skills 3 commands ├── ux-strategy/ # UX 策略插件 ├── ui-design/ # UI 设计插件19 skills ├── interaction-design/ # 交互设计插件22 skills ├── prototyping-testing/ # 原型与测试插件 ├── design-ops/ # 设计运营插件 ├── designer-toolkit/ # 设计师工具箱插件 └── visual-critique/ # 视觉评审插件关键规则一个 Skill 对应一个目录目录名必须与 frontmatter 中的name完全一致且只能使用 kebab-case小写字母、数字、连字符。比如新增一个卡片分类法Skill路径就是design-research/skills/card-sort/SKILL.mdfrontmatter 里写name: card-sort。命名不匹配校验脚本会直接报错。三、深入解析 SKILL_TEMPLATESkill 文件的骨架架构 SKILL_TEMPLATE.md 是编写任何 Skill 的起点它把整个文件拆成了 5 个功能区块每个区块都有明确的职责区块位置职责与写法要求frontmatter文件开头L16-L19name与description两个必填字段description 必须是一句话说明技能教什么、何时适用且不超过 120 字符H1 标题# Skill Title用 Title Case标题式大小写如 Interview Script角色声明紧跟 H1 的一句话You are an expert in …要具体而非宽泛——写表单错误处理专家而不是设计专家What You Do第一个 H22–4 句话说明 Agent 激活此技能后产出什么、做什么决策、以及不做什么核心原则 H2 区块中间主体共 2–4 个 H2 区块每个区块必须编码一条可被应用判断而不是罗列事实Best Practices结尾 H2至少包含一条不要做什么的反模式说明模板里还有两条容易被忽略的细节规则层级控制小节最多嵌套到 H3H2 → H3不要再往深嵌套表达工具选择对比两种方案用表格描述先后顺序用有序列表。frontmatter 实际长这样取自真实的 design-token Skillname: design-token description: Define and organize design tokens (color, spacing, typography, elevation) with naming conventions and usage guidance.四、frontmatter 校验规则让 linter 替你把关 ✅项目自带 scripts/lint-frontmatter.py每次提交前运行一次即可自动检查所有 Skill 和 Command 文件python3 scripts/lint-frontmatter.py它对SKILL.md的检查项见 L70-L107文件必须以---开头并包含完整的 frontmatter 块name字段必须存在且非空description字段必须存在且非空name的值必须与所在目录名完全一致name必须是 kebab-case正则[a-z][a-z0-9-]*;正文必须包含至少一个 H1 和一个 H2。对commands/*.md则额外要求argument-hint字段必须使用方括号占位符格式如[product or feature to research]。发现错误时脚本会输出ERROR 文件路径:行号: 原因并汇总报错数量。全部通过则输出类似OK — 97 skills and 30 commands passed all frontmatter checks.的绿色信号。五、质量清单Skill 通过 5 项测试才算高质量 ⭐CONTRIBUTING.md 定义了官方的质量门槛可以当自查清单用#测试项判断标准1linter 通过运行脚本零报错2description 是完整句子同时说清覆盖什么和何时适用 120 字符3What You Do 足够具体说出具体产出物。✔ 设计事务性邮件的确认策略✘ 帮忙做邮件设计4每个 H2 教一个判断读者学完应能把该原则迁移到新场景而非背诵事实5Best Practices 至少一条不要做反模式往往是全文价值最高的一行看一个正面案例interview-script 不仅定义了脚本结构开场→热身→核心探索→收尾还用一张对比表格教 Agent如何避免诱导性提问——这正是教判断而非背事实的典范写法。六、进阶一步顺手把配套 Command 也写了 如果你的 Skill 能串联成工作流不妨参考 COMMAND_TEMPLATE.md 补一个 Command。核心规则四条步骤数 3–7 步少于 3 步只是 Skill 调用的包装多于 7 步说明职责过载每步必须点名一个 Skill格式为 Do X usingskill-nameskill禁止跨插件引用interaction-design里的 Command 只能引用interaction-design的 Skill描述 Output 要具体说清楚产出的工件名称和结构而不是含糊的一份规格文档。参考 /design-research:discover4 个步骤逐一点名user-persona、empathy-map、journey-map三个 Skill结尾用自然语言建议后续命令完全符合规范。七、贡献流程与常见坑位速查表 先开 Issue新 Skill/Command 必须先讨论方案没有对应 Issue 的 PR 会直接被关详见 CONTRIBUTING.md一次 PR 只改一个东西保持 PR 聚焦同一次提交更新插件 manifestSkill 和它的插件声明必须一起提交删除模板里的所有 HTML 注释提交前清理!-- ... --提交前跑 linter这是最低成本的质量保险。⚠️ 最常见的三个坑目录名和name不一致、description 超 120 字符、Command 跨插件引用 Skill——全部会被 linter 拦下养成提交前跑一次脚本的习惯就不会踩雷。写在最后Designer Skills 项目的理念是把设计品味写成 AI 能读懂的判断——每个 Skill 都不是知识的堆砌而是一组可执行的设计决策。当你按 SKILL_TEMPLATE.md 的骨架填入具体判断并通过 linter 与质量清单的双重检验时你就写出了一个真正Agent 可用的高质量 Skill。祝你的第一个 PR 顺利合入【免费下载链接】designer-skillsDesigner Skills Collection: agentic skills, commands, and plugins for design — from research to systems, UI, interaction, and delivery.项目地址: https://gitcode.com/gh_mirrors/de/designer-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考