一句话理解
Skill 就是你写给 AI 的"操作手册"——一个 Markdown 文件,告诉 AI 遇到某类任务时该怎么做。
Skills 是 Anthropic 提出的 Agent Skills 开放标准,Claude Code、Claude.ai、Cursor 等工具均支持,不是某个产品独有的。
它解决什么问题
- 每次新开聊天都要重复解释项目背景、流程、规范 → 写成 Skill,AI 自动读取
- 复杂工作流怕 AI 遗漏步骤 → 写成 Skill,AI 按步骤执行
- 团队协作中希望 AI 行为一致 → Skill 放进项目仓库,所有人共享
核心机制
你发消息 → AI 根据 description 判断是否相关 → 相关则自动读取 SKILL.md → 按指令执行
不需要手动选择,AI 自动匹配触发,也可以指定使用哪些 Skill。
文件结构
skill-name/
├── SKILL.md # 必须,主文件(建议 < 500 行)
├── reference.md # 可选,详细参考
└── scripts/ # 可选,辅助脚本
SKILL.md 格式:
---
name: skill-name
description: 做什么 + 什么时候触发
---
# 标题
## 具体指令
...
存放位置(以 Cursor 为例)
| 位置 | 路径 | 范围 |
|---|---|---|
| 个人 | ~/.cursor/skills/skill-name/ | 所有项目可用 |
| 项目 | .cursor/skills/skill-name/ | 仅当前项目,可提交到 Git |
~/.cursor/skills-cursor/是内置 Skill 目录,不要往里面写。其他平台路径有所不同:Claude Code 通过
/plugin命令安装,Claude.ai 在设置中上传,API 通过接口传入。
description 怎么写(决定 AI 能否正确触发)
# 好:明确说了做什么 + 什么时候用
description: 审查代码质量和安全性。当用户提交 PR 或要求 Code Review 时使用。
# 差:太笼统,AI 不知道什么时候该用
description: 帮助处理代码。
Skill vs Rule 怎么选
| Skill | Rule(.cursor/rules/) | |
|---|---|---|
| 加载方式 | 按需读取(AI 判断相关时) | 始终注入 / 按文件类型自动注入 |
| 适合 | 特定任务流程、领域操作手册 | 编码规范、语言偏好、项目约定 |
| 举例 | "部署流程"、"数据库迁移步骤" | "用中文回复"、"使用 tabs 缩进" |
简单规则:每次对话都要遵守的 → Rule;特定任务才需要的 → Skill。
用来缓解上下文限制
Skill 不能扩大上下文窗口,但能高效利用它:
- 把长对话中摸索出的经验提炼成 Skill,新对话直接复用
- 用精炼的预写内容替代重复的沟通,省出空间给真正的问题
类比:每次上课都从头讲背景 → 把背景写成教材,上课直接进入正题。
快速创建一个 Skill
直接告诉 AI:"帮我创建一个 Skill,用来做 XXX",AI 会自动调用内置的 create-skill 技能引导你完成。
参考资源
Anthropic 官方开源了大量 Skill 示例,涵盖创意设计、开发技术、企业工作流、文档处理等场景,可以直接参考或作为自定义 Skill 的起点:
- 官方 Skills 仓库:github.com/anthropics/…(80k+ Stars)