free-ai-lab free-ai-lab

Skill 实战上手:真装一个用起来

实战

不空谈概念:从「装一个热门 Skill」到「写出自己的 SKILL.md」的完整上手路径。

一、先装一个热门的(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 没用上技能,往往不是没装上,而是没触发。三个验证方法按成本排序:

  1. 直接点名:在对话里明确说「用 XX Skill 处理这件事」——最直接的触发方式。
  2. 给任务场景:不说技能名,只说需求。让 AI 自己判断该不该调用——这才是技能设计的本意。
  3. 看行为变化:对比同一个任务「装 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.mddescription 别写太泛(越具体越容易被触发)。测试时同样分两种:直接点名 + 给场景。

四、常见翻车点速查

  • 装了但没效果:先验证是否已列出;再确认任务匹配;最后看 README 有没有额外依赖(比如需要 API key)。
  • SKILL.md 写太泛:description 一句话说不清用途,AI 就很难在关键时刻想起它。
  • 期望过载:一个 Skill 只教一件事。想干三件事就拆三个文件夹。
  • 忽略测试:写完不测 = 白写。至少当场跑一次「点名调用」,确认输出符合预期。

想深入写法细节,可接着读SKILL.md 写法详解(10 个模板);想对比 Skill 和 MCP 的边界,看Skill vs MCP 一文