Skills 入门与实战
我们已经在用的三个 Skills
Agent 不了解你们团队的上下文——设计规范、走查流程、提交习惯。
每次都要从头说一遍。
Skills 是打包了指令、脚本和资源的文件夹，让 Agent 在遇到特定任务时自动调用专业知识和工具。
就像给新入职的设计师一份走查 checklist——
Skill 就是给 Agent 的那份 checklist。
只不过这份手册还能附带脚本、模板、参考数据。
一个能力很强但没有记忆的实习生。
每天早上都要重新培训一遍。
点击卡片查看详情
每个 Skill 至少包含一个 SKILL.md 文件。
除此之外没有任何限制——代码、字体、图片、模板、脚本，任何 Agent 执行任务时需要的资源都可以放进来。
两部分组成：
YAML 头信息 → 告诉 Agent 什么时候用
Markdown 正文 → 被触发后遵循的指令
当 Skill 涉及更多内容时，用文件夹组织。
Agent 不会一次性加载所有文件，而是在执行过程中按需读取。
渐进式披露——先给核心信息，细节按需展开。
适合流程已经很清晰、你能直接描述出来的场景。
打开编辑器，新建一个 SKILL.md，写入 YAML 头信息和正文。
Agent 启动时扫描所有 Skill 的描述来决定调用哪个。描述不是摘要，而是触发条件。
Agent 本身很懂编程。聚焦在团队特有的规范、内部工具用法、以及 Agent 默认做不好的地方。
数据库迁移 = 窄桥加悬崖（步步规定死）；设计走查 = 开阔原野（Agent 需自行判断）。
写给 AI 看的，包含具体触发词和使用场景，不是给人看的摘要。
适合流程还不清晰、想让 Agent 帮你提炼的场景。点击步骤查看详情。
安装 Agent Browser，然后让 Agent 自主完成走查：
使用 agent browser，打开本地链接网页进行设计走查，
整理一个走查表，figma 链接：XXX
「任何 Skill 中信息密度最高的部分就是 Gotchas 部分。」
每次踩坑，把坑补进去。
试试在下方添加一条新的 Gotcha →
项目级放在项目仓库里，只有这个项目的 Agent 能用；全局级放在根目录，电脑内所有项目都能使用。
放到 .agent/skills 目录下——.codebuddy、.claude、.cursor 皆可。Skill 就是一堆文件。
提到相关触发词，Agent 自动调用对应 Skill。也可以用 / 命令强制调用。