Skill 实战教程：从安装到看见效果（完整实例）

做完本教程，你应该能亲眼看到：

1. 磁盘上出现 SKILL.md，例如 .cursor/skills/<技能名>/SKILL.md
2. 用「会命中 description」的话术提问时，输出变成 固定小节 + 检查清单（而不是三句闲聊）
3. 对比实验：卸掉 Skill 后再问同一问题，结构明显变散

Skill 提供「怎么做」的流程；读库 / 开浏览器是 MCP 的活。本例用代码审查类 Skill，任意 Skill 换安装命令即可。

实例目标

对一小段有意写烂的代码做一次「按 Skill 规范」的审查，并看到固定输出结构（问题分级、建议改法、是否可合并等）。

准备练习代码

mkdir -p ~/Documents/demo-skill && cd ~/Documents/demo-skill

创建 buggy.ts：

export function sum(a: any, b: any) {
  // TODO: fix later
  console.log("debug", a, b)
  return a + b
}

export function getUser(id) {
  return fetch("/api/user/" + id).then((r) => r.json())
}

用 Cursor 打开该目录。

在 AgentHub 找 Skill

打开 /skills，搜索 code review、pr、审查、测试 等，选一个带清晰 description 与完整 SKILL.md 的条目（官方或高星优先）。

打开目标 Skill 详情页 → 安装区任选一种方式：

方式 A｜Skills CLI（推荐）

npx skills add owner/repo@skill-name

方式 B｜手动

1. mkdir -p .cursor/skills/code-review
2. 将详情页的 SKILL.md（或 GitHub raw / zip）放入该目录
3. 若有 scripts/、references/，一并复制

方式 C｜curl / zip

部分条目提供一键下载解压命令，目标目录仍是 .cursor/skills/<技能名>/。

装完后检查：

ls .cursor/skills/*/SKILL.md

应能看到至少一个 SKILL.md，然后 Cmd+Shift+P → Reload Window。

用编辑器打开 SKILL.md，对照下图理解「元数据」和「正文」的分工：

例如 description 写着 Review pull requests and TypeScript code… 或「部署前检查」时：

• 容易触发：「请审查 buggy.ts」「帮我做 code review」「这份 PR 能合吗」
• 不容易触发：「今天天气怎么样」「把这段翻译成英文」

可选：补中文关键词

若怎么问都不走流程，可在 description 中增加「代码审查、评审、CR」，保存后 Reload，再用中文提问。

不要删掉正文里的步骤与输出格式——那正是「效果」的来源。

在 Cursor Agent 对话中 @ 引用 buggy.ts（或把文件加到上下文），发送：

提示词 A｜命中审查 Skill

请按已安装的代码审查 Skill，对 buggy.ts 做完整审查。严格遵守 Skill 中的输出格式与检查项，不要只用三句话敷衍。

期望效果 A（结构因 Skill 而异，但通常包含）：

• 摘要 / Summary
• 按严重级别列出问题（Critical / Major / Minor，或 高 / 中 / 低）
• 对 any、缺少类型、console.log、错误处理等给出具体建议
• 明确的「是否建议合并 / 下一步」

若输出极其随意、没有固定小节：未 Reload、路径不对，或话术没命中 description。

提示词 B｜对比实验（强烈建议做）

1. 暂时把 .cursor/skills 改名为 .cursor/skills.bak，Reload
2. 用完全相同的提示词再问一次
3. 对比两次回答的结构稳定性与检查覆盖面
4. 再改回 skills 目录并 Reload

你会明显感到：有 Skill = 可复用的审查口径；无 Skill = 每次看模型心情。

提示词 C｜显式点名（可选）

启用 code-review Skill（或你的技能名），按其 SKILL.md 执行。

AgentHub 上每个 Skill 详情页都可按下面验收：

1. 安装后磁盘上有 SKILL.md
2. 用 description 里的关键词造句提问
3. 输出呈现 Skill 正文中的步骤 / 模板
4. 移走目录后再问 → 输出变散（证明确实生效）

按类型怎么验收

需要「读仓库 / 查 GitHub issue」时，再搭配 MCP：见 MCP 实战教程、Skill 和 MCP 怎么选。

Claude Code

• 用户级：~/.claude/skills/<技能名>/SKILL.md
• 项目级：.claude/skills/<技能名>/SKILL.md

从 AgentHub 复制 Claude Code Tab 的 curl / CLI 命令即可。会话里可用 /skills 查看已加载列表，再用同样的 buggy.ts 审查话术验证。

OpenClaw / ClawHub

见 OpenClaw / ClawHub 技能安装；装完后仍用「结构化输出 + 对比实验」验收。

更短说明：Cursor 安装 Agent Skill、Claude Code 安装 Agent Skill。

任意 Skill 详情页侧栏都会链到本文，按同一套标准从「复制安装」走到「看见效果」。