文章目录
- 何为[Agent Skills](https://agentskills.io/home)
-
- 为什么需要?
- Skills能启用什么功能?
- Skills是什么
-
- Skills文件夹结构
- SKILL.md 文件格式
-
- 格式要求
- 主要优势
- 注意事项
- 如何验证配置是否正确
- 如何Working?
- Skills 与其他功能的区别
- 核心优势
- 如何获取skills
-
- 官方开源库
- 第三方 Skills 市场与合集
- 如何安装skills
- SKILL.md示例
- 如何落地
- 技能积累
- 参考
Agent Skills 正在重新定义我们与 AI 的协作方式。它不再要求我们成为高明的 “提示词巫师”,而是鼓励我们成为技能架构师。
通过将专业知识封装成标准化的 Skills,构建一个更加模块化、高效且可靠的 AI 应用生态。未来,一个强大的 AI 智能体,不再仅仅取决于它底层模型的大小,更取决于它装备了怎样一套强大的 “技能工具箱”。
Agent Skills 的强大之处在于其精妙的结构设计,它通常包含三个核心层级:
- 元数据层(Metadata):位于 SKILL.md 文件的 YAML 头部,包含技能的名称和描述。
- 指令层(Instructions):位于 SKILL.md 文件的 markdown body部分,定义了完成任务的具体步骤、逻辑流程、思考链(Chain of Thought)以及何时调用工具
- 资源与代码层(Resources & Code):位于Skill文件夹的可选目录中,包括 Python 脚本、API 调用代码、模板文件或大型参考文档。
Agent Skills 的出现,通过如下手段解决智能体应用中的几个关键瓶颈:
- 渐进式披露(Progressive Disclosure):告别上下文臃肿
- Skill的指令:弥补模型短板,引入“确定性”
- Skills 遵循“高内聚,低耦合”的设计原则:一次构建,就可以像插件一样,在不同的智能体项目中复用,解决了智能体开发中的模块化与可移植性问题


何为Agent Skills
Agent Skills:
- 是一种轻量级、开放的格式,用于扩展LLM Agent能力:专业知识和工作流程。详见:agentskills
- 是包含指令、脚本和资源的文件夹,LLM Agent可以发现并使用它们来更准确、更有效地做事。
Agent Skills 格式最初是由Anthropic开发,作为一个简单、开放标准发布。 目前被越来越多的代理产品采用。该标准对来自更广泛生态系统的贡献是开放的。
- 它标志着 AI 从单纯的“对话伙伴”向“自动化执行代理”的重大转变。
- 就像是给 AI 安装的“技能包”或“培训手册”。它允许你将复杂的、重复性的工作流程(如公司品牌规范、代码审查标准、财务报告模板)打包成可复用的指令,让 Claude 能够自动、可靠地完成任务,而无需你每次都重复提醒。
为什么需要?
- 代理的能力越来越强,但通常没有可靠地完成实际工作所需的上下文。
- Skills允许Agent访问程序知识以及公司、团队和用户特定的上下文,并可以根据需要加载这些上下文
- 拥有一组技能的Agent可以根据正在处理的任务扩展Agent的能力
- Skills构建与积累:
- 对Skills作者:Skills一次构建,多个agent都可使用
- 对支持Skills的Agent: 让终端用户为Agent提供开箱即用的新功能
- 对团队和企业:在可移植的、版本控制的软件包中获取组织知识。
Skills能启用什么功能?
- Domain expertise: 将专业知识封装到可重复使用的指令
- New capabilities: 赋予Agent新的功能
- Repeatable workflows:将多步骤任务转换为一致且可审计的工作流。
- Interoperability【互操作性】: 在不同技能兼容的Agent产品中重用相同的技能。
Skills是什么
Skills文件夹结构
一个Skill 是一个包含SKILL.md文件及脚本、资源的文件夹
- 核心文件 :核心文件:SKILL.md ,是一个 Markdown 文件,里面包含了 YAML 格式的元数据(如名称、描述)和具体的执行步骤、示例
- 其它文件:Skill捆绑的脚本、模板和参考资料
- 自动触发:Skills 最聪明的地方。你不需要手动去点击启用某个 Skill。Agent 会扫描你所有的 Skills,当它判断你的当前请求与某个 Skill 的描述匹配时,会自动加载并执行它
my–skill/
├── SKILL.md # Required: instructions + metadata
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
└── assets/ # Optional: templates, resources
可选的目录:
- scripts/: 包含可供agent调用的可执行脚本,要求如下,通常支持java,python,javascript语言
- Be self-contained or clearly document dependencies
- Include helpful error messages
- Handle edge cases gracefully
- references/: 包含agent可以在需要时读取的附加文档, agent 按需加载这些文件,因此更小的文件意味着更少的上下文使用。
- REFERENCE.md – Detailed technical reference
- FORMS.md – Form templates or structured data formats
- Domain-specific files (finance.md, legal.md, etc.)
- assets/: 静态资源文件
- Templates (document templates, configuration templates)
- Images (diagrams, examples)
- Data files (lookup tables, schemas)
SKILL.md 文件格式
格式要求
每一项技能都始于一个SKILL.md文件,包含 YAML frontmatter and Markdown instructions:
- Frontmatter (required)
- 必须的信息
- name: 短标识符
- description: 何时使用此Skill
- 可选的
- license
- compatibility
- metadata
- allowed-tools
- 必须的信息
- Body content
- Markdown主体包含实际的指令,在结构或内容上没有特定的限制。
- Recommended sections:
- Step-by-step instructions
- Examples of inputs and outputs
- Common edge cases
–––
name: pdf–processing
description: Extract text and tables from PDF files, fill forms, merge documents.
–––
# PDF Processing
## When to use this skill
Use this skill when the user needs to work with PDF files...
## How to extract text
1. Use pdfplumber for text extraction...
## How to fill forms
...
Frontmatter的属性
| name | Yes | Max 64 characters. Lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen. |
| description | Yes | Max 1024 characters. Non-empty. Describes what the skill does and when to use it. |
| license | No | License name or reference to a bundled license file. |
| compatibility | No | Max 500 characters. Indicates environment requirements (intended product, system packages, network access, etc.). |
| metadata | No | Arbitrary key-value mapping for additional metadata. |
| allowed-tools | No | Space-delimited list of pre-approved tools the skill may use. (Experimental) |
主要优势
- Self-documenting: A skill author or user can read a SKILL.md and understand what it does, making skills easy to audit and improve.
- Extensible: Skills can range in complexity from just text instructions to executable code, assets, and templates.
- Portable: Skills are just files, so they’re easy to edit, version, and share.
注意事项
- 保持 SKILL.md 在500行以内,将详细的参考资料放在单独的文件中
- 当引用Skill中的其他文件时,使用来自Skill根目录的相对路径:如scripts/extract.py、references/REFERENCE.md
- 保持文件引用比SKILL.md深一层, 避免嵌套引用
如何验证配置是否正确
- Use the skills-ref reference library 来验证Skill的配置是否有效
如何Working?
使用渐进式披露【progressive disclosure】来有效地管理上下文
这种方法使Agent保持快速,同时使它们能够根据需要访问更多上下文。 
Skills 与其他功能的区别
| 核心作用 | 教会 Claude “如何做” 一件事(内部流程、规范) | 让 Claude “去做” 一件事(调用外部数据、执行动作) | 用户手动触发的快捷指令 |
| 触发方式 | AI 驱动(自动发现和加载) | 由 AI 决定调用 | 用户驱动(需输入 /xxx) |
| 主要用途 | 标准化工作流、品牌指南、代码规范 | 搜索网络、读取本地文件、执行代码 | 快速执行特定预设任务 |
| Token 消耗 | 极其高效(仅在需要时加载详情) | 每次调用都会产生消耗 | 视具体命令而定 |
核心优势
如何获取skills
获取 Claude Skills 的途径主要有官方开源库、第三方市场以及自己创建三种
官方开源库
Anthropic 官方开源的 Skills 集合,包含处理 Word、PDF、Excel、PPT 的核心工具,以及创意开发类工具。
- GitHub 仓库地址: 🔗 https://github.com/anthropics/skills
- 包含内容:
- document-skills:官方文档处理底层能力(docx, pdf, pptx, xlsx)。
- example-skills:创意与开发工具(如创建 Slack GIF、Web 测试、品牌指南等)。
第三方 Skills 市场与合集
除了官方库,社区中也有许多高质量的 Skills 整理。
- Claude Skills 官方市场(第三方运营): 🔗 https://skillsmp.com/zh/
- 说明:这里可以找到各种特定用途的 Skills,支持下载后直接拖入 Claude 使用。
- Awesome Claude Skills (ComposioHQ): 🔗 https://github.com/ComposioHQ/awesome-claude-skills
- 说明:精心策划的 Skills 合集,适合寻找特定功能。
- Superpowers (obra): 🔗 https://github.com/obra/superpowers
- 说明:面向开发者的高级 Skills,涉及 AWS CDK、D3.js 等。
- Awesome Claude Prompts (langgptai): 🔗 https://github.com/langgptai/awesome-claude-prompts
- 说明:虽然主要是 Prompt,但也是很好的灵感来源,适合从 Prompt 过渡到 Skill。
如何安装skills
获取链接后,具体的安装方法取决于你使用的平台(如 OpenCode) OpenCode 在设计上就考虑了与 Claude 生态的互通,它支持直接使用为 Claude 编写的 Skills opencode从以下位置加载skills:
- Project config: .opencode/skill/<name>/SKILL.md
- Global config: ~/.config/opencode/skill/<name>/SKILL.md
- Project Claude-compatible: .claude/skills/<name>/SKILL.md
- Global Claude-compatible: ~/.claude/skills/<name>/SKILL.md
详细参见:# opencode 有关Agent Skills的文档
SKILL.md示例
详见: pptx code-reviewer.md frontend-design
如何落地
落地时不能战术勤奋,战略懒惰。
要想真正让 Skill 落地,必须一把手站出来: 因为短期效率下降,会出错。
- 流程要重塑:谁来承担混乱期的风险?
- 考核要变:AI 干了80%的活,员工的绩效怎么算?
- 组织要改:不需要那么多初级执行岗了,人去哪?
等待的代价比试错更大,当你的竞争对手已经把高手的经验固化成 Skill,实现了 AI 自驱动开发,你就彻底出局了
如何落地:
- 找敢死队:挑3-5个爱折腾的小伙伴,别一上来就全员铺开,那是找死
- 定小目标: 解决实际痛点问题,要具体,要痛
- 闭门造车:允许效率下降,允许搞砸,进行不断试错
- 复盘迭代:每周坐下来看,哪个 Skill 真的有用?哪个是伪需求?
- 固化推广:把验证有效的,沉淀下来,推广到其他组。
说明:图片来自参考链接
技能积累
- 知识资产化
- 资深经验显性化沉淀
- 私域知识积累
- 加速个性化应用
- 垂直行业深度定制
- 场景适配更精准、落地速度显著提升
- AI第二大脑
- 个人生产力外挂
- 人机协同增强
- 持续积累价值
- 技能库不断丰富
- 跨场景复用效率提升、资产增值

参考
- # 全网疯传Claude Skills?我赌2个月后,90%的公司全烂尾


