Agent Skills 快速入门

14 阅读2分钟

一句话理解

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 怎么选

SkillRule(.cursor/rules/
加载方式按需读取(AI 判断相关时)始终注入 / 按文件类型自动注入
适合特定任务流程、领域操作手册编码规范、语言偏好、项目约定
举例"部署流程"、"数据库迁移步骤""用中文回复"、"使用 tabs 缩进"

简单规则:每次对话都要遵守的 → Rule;特定任务才需要的 → Skill。

用来缓解上下文限制

Skill 不能扩大上下文窗口,但能高效利用它:

  • 把长对话中摸索出的经验提炼成 Skill,新对话直接复用
  • 用精炼的预写内容替代重复的沟通,省出空间给真正的问题

类比:每次上课都从头讲背景 → 把背景写成教材,上课直接进入正题。

快速创建一个 Skill

直接告诉 AI:"帮我创建一个 Skill,用来做 XXX",AI 会自动调用内置的 create-skill 技能引导你完成。

参考资源

Anthropic 官方开源了大量 Skill 示例,涵盖创意设计、开发技术、企业工作流、文档处理等场景,可以直接参考或作为自定义 Skill 的起点: