简介
介绍
Skills是Anthropic推出的模块化能力包系统,通过渐进式披露机制实现按需加载,大幅提升Token效率。 skills是模块化的能力包,包含指令、脚本和资源,可以让Claude在需要时自动加载和使用。
Skills是封装了特定技术任务的标准化可复用模块,本质是将技术场景中的最佳实践、工作流、工具调用逻辑,固化为可被AI Agent或开发工具一键加载、调用的配置单元(常见格式如skill.md、YAML配置)。其核心价值在于解决技术场景中的重复开发、流程不规范、Prompt调试繁琐三大痛点——不用你每次处理同类任务,都重复编写脚本、调试参数、梳理流程,加载对应Skill就能直接执行。
模块化:Skills是一个个独立的文件夹,每个Skill做一件事
能力包: 每个Skill文件夹里可以包含:
- SKILL.md(核心指令文件,必需)
- scripts/(可执行脚本,可选)
- references/(参考文档,可选)
- assets/(模板和资源,可选)
自动加载
Claude会根据你的任务描述,自动判断需要哪个Skill,然后加载
不使用skills时需要审校文章时:
“帮我审校这篇文章。注意检查事实准确性,去掉AI味的表达,比如’不是…而是…'这种套话,把长句拆成短句,段落不要太长,像手机屏幕3-5行这样,加粗不要太多,每200-300字1-2处就够了,还要检查是否像真人在说话…”使用skill时,提前把规则写到skill里,会自动识别:
“帮我审校这篇文章”渐进式披露机制
渐进式披露机制:(Progressive Disclosure)是 Skills 系统的核心设计思想,简单来说就是: AI Agent 先只看”目录”,确定需要后,再加载完整”章节”。是一种按需加载知识的策略,目的是解决 AI 模型的”上下文窗口有限”这个根本瓶颈。
说白了就是只给 Agent 看 Skills 的名字和简短描述(几十 tokens)上下文清爽;Agent 快速判断需要哪个 Skill;然后 按需加载完整内容
渐进式披露机制分为三级:
- 第一级别 元数据: 启动时加载,只需要skills名称和一句话描述,消耗几十token,让Claude知道有哪些Skills可用,什么时候该用哪个。 内容:SKILL.md文件开头的YAML部分,就两个字段:name和description。
---
name: ai-proofreading
description: 系统化降低AI检测率,增加人味。使用场景:审校文章、降低AI味、初稿完成后。
---- 第二级别 指令:触发时加载,任务匹配该skills时加载,需要
skill.md完整内容,详细的操作指南,消耗几百至几千token,告诉Claude具体怎么做 - 第三级别 资源:引用时加载,需要执行具体操作时;需要脚本,资源文件,token消耗数量几乎无限,脚本执行后只有输出进入上下文,代码本身不占Token。提供确定性的执行能力和详细的参考资料
Skills vs MCP vs Subagent
MCP让Claude能碰到外部系统。Skills告诉Claude碰到之后怎么用。Subagent是派一个人出去干活。
MCP(Model Context Protocol)MCP的核心价值是连接。它解决的问题是”Claude能访问什么数据”。
Skills Skills的核心价值是程序化知识。它解决的问题是”Claude应该怎么做”。
Subagent Subagent的核心价值是并行执行和上下文隔离。它解决的问题是”怎么处理复杂的多步骤任务”。
| 维度 | MCP | Skills | Subagent |
|---|---|---|---|
| 核心作用 | 连接外部系统 | 提供程序化知识 | 并行执行任务 |
| 类比 | 发工具 | 使用手册 | 派助手 |
| Token消耗 | 高(预加载能力描述) | 低(按需加载) | 高(独立会话) |
| 技术门槛 | 需要写代码、配服务器 | 写Markdown就行 | 需要配置 |
| 能访问外部数据 | 是 | 否 | 否 |
| 适用场景 | 需要实时数据 | 重复性工作流 | 复杂多步骤任务 |
使用场景: MCP:查询数据库,调用第三方API,读写Github等 Skills: 代码审查,文章校验,报告生成等重复性流程 Subagent: 任务复杂,需要并行执行
三者可以同时组合使用,三者是互补关系
Skills vs Workflow
skills(技能)和 workflow(工作流)是两个核心且互补的概念,二者的本质区别在于:skills是AI完成单一任务的能力单元,workflow是多skills按逻辑串联形成的任务执行链路。
对比:
| 维度 | AI Skills | AI Workflow |
|---|---|---|
| 粒度 | 细粒度,单一能力单元 | 粗粒度,多能力组合的完整流程 |
| 独立性 | 可独立调用,不依赖其他skills | 依赖多个skills,需按规则协同 |
| 复用性 | 高,可嵌入不同workflow中重复使用 | 低,通常针对特定复杂任务定制 |
| 核心目标 | 解决单一子任务 | 解决复杂完整任务 |
| 灵活性 | 能力固定,调整仅需优化自身参数 | 灵活性高,可修改skills组合或执行逻辑 |
联系
- skills是workflow的基础:没有独立可用的skills,workflow就成了“无源之水”,无法完成任何子任务。
- workflow是skills的价值放大器:单一skills的功能有限,通过workflow编排,可将多个skills的能力叠加,解决更复杂的实际问题。
- 动态适配关系:同一个skill可以被多个workflow复用;同一个workflow也可以根据需求替换不同的skills(比如将“文本摘要技能”替换为“长文精简技能”)。
skills 基本结构
一个Skill就是一个文件夹,里面至少有一个SKILL.md文件。
skill.md 示例:
---
name: hello-skill
description: A simple greeting skill. Use when user says hello or asks for a greeting.
---
# Hello Skill
When user greets you, respond with a warm, personalized greeting.
## Guidelines
- Be friendly and natural
- If user mentions their name, use it
- Keep it brief (1-2 sentences)-
YAML Frontmatter(必需) 文件必须以YAML frontmatter开头,包含两个必需字段:name 和 description name是skill的唯一标识符
- 最多64个字符
- 只能用小写字母、数字、连字符
- 不能以连字符开头或结尾
- 不能有连续的连字符 description 告诉Claude什么时候用这个Skill
- 最多1024个字符
- 要包含 做什么 和 什么时候用
- 触发关键词很重要
-
Markdown主体(可选但建议有) 是skill的详细指令,没有格式限制,但建议包含:核心目标,执行步骤,示例输入输出,注意事项等
官方建议 主体部分控制在500行以内。如果需要更多内容,放到references/目录下
- 添加脚本和参考文档(进阶) 完整skill结构:
my-skill/
├── SKILL.md # 核心指令
├── scripts/
│ └── process.py # 可执行脚本
├── references/
│ └── DETAILED_GUIDE.md # 详细参考文档
└── assets/
└── template.md # 模板资源- scripts/: 可执行脚本:当
SKILL.md中引用脚本时,Claude会执行它。脚本代码不进入上下文,只有执行结果进入 - references/ :参考文档:当任务需要更多信息时,Claude会读取这些文档。采用渐进式披露,平时不加载
- assets/ :模板和资源,比如报告模板、配置文件、样例数据
建议避免使用一个大的Skills,而是拆分为多个小的skills 优势:1. 按需加载,节省Token
2. 触发更加精准
3. 可自由组合
Skills的最佳实践
- Description决定一切:做什么(核心功能)+ 什么时候用(触发场景)+ 触发关键词
- 单一职责,每个Skill只做一件事
- 渐进式披露,核心内容放
SKILL.md,详细内容放references/。SKILL.md应该简洁,包含核心流程和最常用的指令。详细的参考资料、边界情况、深入解释,放到references/目录下。 - 脚本优于生成代码 如果一个任务可以用脚本完成,就写成脚本。
- 从简单开始,逐步迭代
Skills使用
Skills可以在多个平台使用:Claude Code、Claude API、Claude.ai。
这是最方便的平台。
- 个人级Skills:放在 ~/.claude/skills/ 目录下。所有项目都可以用。适合:通用能力,比如代码审查、文档生成。
- 项目级Skills:放在项目目录的 .claude/skills/ 下。只有当前项目可以用。适合:项目特定的规则,比如这个项目的代码规范、这个团队的工作流。
安装 从插件市场安装 或 直接下载解压到对应文件夹里
Skills 库和资源
Karpathy-Inspired Claude Code Guidelines
仓库地址:github仓库
claude 安装 此 skills : 按照官方仓库教程即可
- 启动 claude
- 添加市场
/plugin marketplace add forrestchang/andrej-karpathy-skills - 安装插件
/plugin install andrej-karpathy-skills@karpathy-skills - 重启 claude
- 运行指令查看结果
/skills可以看到安装的可用的 skills
codex 安装此 skills 方式:
- 启动 codex
- 使用命令
$Skill Installer andrej-karpathy-skills@karpathy-skills安装 - 重启 codex
- 运行
/skills,List Skills查看安装的 skills
superpowers
仓库地址: superpowers 一套完整的开发工作流Skills,包含:TDD、调试、代码审查、计划执行等,社区口碑最好的Skills库,设计理念先进
skills 仓库/资源
参考
如果这篇文章对你有帮助,欢迎分享给更多人!
部分信息可能已经过时