一、先装一个热门的(10 分钟出效果)
第一次装 Skill 别挑太复杂的,从社区最火的合集开始最能建立手感。两个典型选择:
- anthropics/skills(官方示例集):Claude 官方出品的示例 Skill,结构规范、注释清晰,适合「看标准写法」。
- obra/superpowers(社区最火):给编程代理的一套「超能力」工作流,覆盖调试、规划、测试,star 数十万。
安装路径因客户端而异,以项目 README 为准。以支持 Skill 市场的客户端为例,大致流程是:
# 以 Claude Code 为例(各客户端命令不同,看所用项目的 README) /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@obra-superpowers-marketplace
核心检查点:装完输入
help 或列出已装技能,能看到新 Skill 出现在可用列表里,才算真的生效。
二、验证它真的生效(关键一步)
很多人装完发现 AI 没用上技能,往往不是没装上,而是没触发。三个验证方法按成本排序:
- 直接点名:在对话里明确说「用 XX Skill 处理这件事」——最直接的触发方式。
- 给任务场景:不说技能名,只说需求。让 AI 自己判断该不该调用——这才是技能设计的本意。
- 看行为变化:对比同一个任务「装 Skill 前后」的输出差异(比如周报从「一段话」变成「结构化四段」)。
翻车点提醒:很多 Skill 是按「任务匹配」触发的,如果你给的任务明显不在它的职责里,AI 不会调用它——这是正常行为,不是装失败了。
三、写你自己的第一个 SKILL.md
一个 Skill 就是一个文件夹,最小结构只有三部分:
my-skill/ ├── SKILL.md # 必填:给 AI 的说明书(人也能看懂) ├── scripts/ # 可选:辅助脚本 └── assets/ # 可选:模板/参考文件
用下次写周报举例如下:
--- name: weekly-report # 技能名(调用 ID) description: 生成结构化周报。当用户要求整理周报时使用。 --- # 输出要求 1. 分四段:本周进展 / 数据与产出 / 问题与风险 / 下周计划 2. 每段 3-5 条,用「动作 + 结果」句式 3. 结尾给 2 个可量化下月目标
把这段放进 SKILL.md,description 别写太泛(越具体越容易被触发)。测试时同样分两种:直接点名 + 给场景。
四、常见翻车点速查
- 装了但没效果:先验证是否已列出;再确认任务匹配;最后看 README 有没有额外依赖(比如需要 API key)。
- SKILL.md 写太泛:description 一句话说不清用途,AI 就很难在关键时刻想起它。
- 期望过载:一个 Skill 只教一件事。想干三件事就拆三个文件夹。
- 忽略测试:写完不测 = 白写。至少当场跑一次「点名调用」,确认输出符合预期。
想深入写法细节,可接着读SKILL.md 写法详解(10 个模板);想对比 Skill 和 MCP 的边界,看Skill vs MCP 一文。