告别模糊认知！一文读懂 Agent Skills 的概念与用法Agent Skills是Agent的技能工具包，用于帮助

Agent Skills是什么

Agent Skills是Agent的技能工具包，用于帮助Agent规范化执行任务。

简单来说，Skills将Prompt给规范化。

一个基础的Skills文件结构包含：

在项目命令行执行命令，npx skills add <skills名>，如：

npx skills add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practices

之后就会出现如下步骤：

安装成功之后，就会出现两个文件夹：.agents 和 .cursor：

.agents：指的是安装在项目里的skill实体内容存放处
.cursor：给cursor读取用的skill目录
- 如果选择的是符号链接的方式，那么这里的文件是符号链接到.agents的同一份内容
- 如果选择的是是复制的方式，那么这里就是单独的复制内容

此时无需过多操作，直接正常用cursor，就可以了，cursor会自动根据场景使用skills

相比于传统的Prompt解决了三大痛点：

元数据 ：指的是skills入口文件中，最上面---符号包裹的部分

指令漂移：指的是prompt随着对话轮次的增加被稀释，让Agent忘记初始的规则

SOP精准注入：指的是当Agent匹配到该skills时，会将SKILL.md全部传给Agent，让Agent按照文件中的规则去执行任务

用状态机替代话术约束：指的是在skills中执行任务时通过严格的状态流转来按步骤执行任务，而不是基于话术约束告诉它不要做

Agent Skills的核心原理是渐进式披露机制；

渐进式披露机制本质上是用动态上下文管理替代静态全量塞入，可以用一个公式解释一下：

渐进式披露机制 = 按任务需求分层加载信息，闲置时仅存目录，触发时翻正文

渐进式披露机制在Agent Skills应用中的三大核心层：

层级	加载内容	何时加载	Token 消耗	作用
L1：元数据层	`SKILL.md` 的 YAML 头（`name` + `description`）	会话启动时	少量	构建“技能目录”，供 `Agent` 意图匹配
L2：指令层	完整 `SKILL.md`（Markdown 正文）	任务匹配时（如用户说“优化 Next.js 页面”）	中量	注入 `SOP` 流程，确保指令精准生效
L3：资源层	`scripts/` 脚本、`reference/` 文档	执行需要时（如 `Skill` 中写“加载 `rules/async-parallel.md`"）	按需动态加载	避免闲置资源占用上下文

为什么是渐进式呢？有四大特征：

特征	说明	价值
分阶段	信息按“目录→正文→附录”逐步展开	避免信息过载
按需触发	仅当任务匹配/执行需要时加载下一层	`Token` 消耗 ↓90%+
系统管控	由 `Cursor Runtime` 强制调度（非 `Agent` 自主决定）	杜绝“模型偷懒跳过步骤”
可验证	每层加载有明确触发条件	流程透明、可审计

以这次作demo的remotion-best-practices举例画一个流程图：

skills的机制是革命性的：