Skills概述

概述

Skills发布于2025年10月，于2025年12月作为开放标准

Skills的作用是为agent添加一个技能包，这个技能包是一个包含其能力规划（prompt）、经验（resource）、技能（scripts）的整合技能包

Skills单看起来与MCP很像，但是实际上二者是有很大区别的：

MCP就是一个单纯的逻辑，以及这段逻辑的用途描述，大模型可以直接使用这段逻辑。Skills里面的script与MCP的作用类似，但是Skills中海包含了一段约束（prompt，Skills.md）。可以理解为，Skills是厨师岗位操作手册，包含厨师该干什么，不能干什么，要怎么干；而MCP则是技能，例如炒菜技能、蒸鱼技能。

Skills执行逻辑

当 Agent 运行某个 Skill 时，就会：

以 SKILL.md 为第一指引
结合任务情况，判断何时需要调用代码脚本（scripts）、翻阅参考文档（ref.）、使用素材资源（assets）
通过“规划-执行-观察”的交错式反馈循环，完成任务目标

因此，Skills安装后是动态加载的的，安装的Skills不会像一个服务一样直接启动在内存里面，而是ai发现要用哪个，才去加载哪个

当用户的需求是做一盘红烧排骨，agent可以加载厨师Skills，变成一个五星大厨，结束后又变回通用agent；用户又要写代码时，agent又可以加载程序员Skills，变成一个高级开发工程师

官方称为渐进式披露，有效地管理背景信息：

发现：启动时，代理只会加载每个可用技能的名称和描述，仅足以知道何时可能相关
激活：当任务与技能描述相符时，智能体会将完整的SKILL.md指令解读到上下文中
执行：代理程序按照指令执行，可根据需要加载引用的文件或执行捆绑代码

这种方法既能保证代理快速响应，又能让他们根据需要获取更多上下文信息

开发Skills

Skills项目结构

Skills现在是开放标准，因此开发也有一套标准，结构如下：

my-skill/

-- SKILL.md # 核心指令：触发条件、任务流程、执行指引，必备，最简单的Skills项目可以只包含一个SKILL.md

-- scripts/ # 可执行代码：ai可以直接运行的固定脚本

-- references/ # 参考文档：给ai学习的技术规范、api文档、专业指南

-- assets/ # 素材资源：包括模板（ai拿来改改使用的）、案例（ai可以参考的历史案例）等

安装现有的Skills

可以到开源三方Skills市场下载Skills：https://skillsmp.com/zh

ClaudeCode安装Skills

把Skills项目下载到本地，以最外层目录存放在项目的/.claude/skills/目录下即可，也可以放到全局目录～/.claude/skills/下，给所有项目共享

安装完成后要重启ClaudeCode

Cursor安装Skills

借助开源工具openSkills即可

首先安装node.js的LTS版本：https://nodejs.org/

先安装openSkills

npm install -g openskills

安装官方skills库

# 安装到项目
openskills install anthropics/skills

# 安装到全局
openskills install anthropics/skills --global

想要安装特定的skill，可以参考如下，以skill-creator为例：

npx openskills read skill-creator

在根目录下创建AGENTS.md，然后同步技能库到md文件

openskills sync

按照它的提示，使用方向键选择，使用空格勾选，如何回车选择要同步的skills

使用skill-creator开发skills

安装官方Skills skill-creator可以辅助skill开发

这样，就可以直接让agent协助创建skill了，例如：“创建skill，能帮我检查代码中的bug”

这种方式做出来的 skill，会默认是xx.skill格式，会与 zip 或文件夹格式略有区别。是 skill-creator 创建的 skill 压缩格式

按照skill开放协议开发手撸skills

SKILL.md

Frontmatter

前言是必填的，其中包括name和description

---
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
...

name和description分别表示该Skills的名称以及描述何时使用，是在SKILL.md文件最开头的必选项

name的约束条件包括：

不能出现大写字符
不能以符号开头
不能出现连续符号

description的约束条件包括：

不多于1024字符
应该描述skills的作用以及何时使用
应包含有助于agent识别相关任务的关键词

除了name和description，还有其他可选项：

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents.
license: Apache-2.0
metadata:
  author: example-org
  version: "1.0"
---

属性	是否必填	约束条件
license	否	许可证名称或捆绑许可证文件的引用。
compatibility	否	最多 500 个字符。说明环境要求（目标产品、系统软件包、网络访问等）。
metadata	否	任意键值映射，用于添加元数据。
allowed-tools	否	技能可使用的预先批准工具列表，以空格分隔。（实验性功能）

bodyContent

对于Skills的正式说明，没有格式限制，类似于写prompt，有助于agent有效完成任务即可

scripts目录

用于存放agent可以执行的代码，其中的脚本要求：

要么自身包含所有的脚本代码，要么清楚地在Skills.md中指明依赖关系
要包含有用的错误信息
优雅地处理极端情况

支持语言建议选用Python、bash、javascript

references目录

用于存放agent查阅的文档和案例，包含的文件建议包括：

REFERENCE.md：详细技术参考文档
FORMS.md：表单模板或结构化数据格式
行业特定文件finace.md、legal.md等

assetes目录

用于存放静态资源

模板文件：给agent进行套用和修改
图片、图表、示例
数据文件、查找表、模式

遵循渐进式披露的原则

Frontmatter：约100字符，一定要带上name和description，因为这两个属性是启动时默认加载的，让agent知道有哪些skills可用
SKILL.md：文件整体不超过5000字/500行，因为agent在激活SKILL时，会直接将整个SKILL.md加载完成；不要把所有规范全都丢进SKILL.md，可以使用文件引用格式，将他们引用到资源文件中
资源文件：按需加载scripts/、references/、assets/中的文件

文件引用的格式

See [the reference guide](references/REFERENCE.md) for details.

Run the extraction script:
scripts/extract.py

验证

使用skills-ref参考库来验证技能：

skills-ref validate ./my-skill

目录CONTENT

Skills开发