Agent Skills


一、Agent Skills 出现的背景

一句话理解大模型智能体向专业化、高效化发展时，Agent Skills 作为一套规范、轻便的能力扩展方案，已成为解决工具调用混乱、上下文冗余等核心问题的关键——让智能体从「泛泛回应」升级为「精准帮忙」。
定义：Agent Skills 是用于扩展智能体能力的规范方案，本质是可复用、可自由组合的最小能力模块。通过统一文件结构，智能体可按需加载、灵活调用，精准适配特定场景。
由来：由开发 Claude 的 Anthropic 率先研发。2025 年 10 月以实验功能上线，同年 12 月成为跨平台开放标准并开源，随后被 Cursor、VS Code Copilot 等平台采用，逐步形成行业生态。
核心痛点（传统工具调用常见问题）：
  • 上下文冗余、判断负担重
  • 工具无法复用、缺乏统一标准
核心特点：
特点说明
原子化每个技能是最小能力模块，可单独使用、自由组合
规范化所有技能遵循统一文件格式，保证兼容复用
按需加载仅在需要时加载技能完整信息，不浪费上下文——与传统工具调用的核心区别

二、相比传统工具的优势

与传统方式相比，Agent Skills 有两大优势：节省 token 资源、减轻智能体判断负担。
  1. 三层渐进式披露（节省 token）#Claude Code 官方明确的核心功能：将技能信息分为三层，按需逐步加载，既不遗漏关键步骤，也不浪费上下文。第一层 · 元数据：YAML 前置信息，仅技能名称、用途等摘要；智能体启动时只加载这部分，几乎不占资源。第二层 · 技能主体：完整 SKILL.md，仅在判断与当前任务相关时加载详细步骤和规则。第三层 · 附加文件：如 .py 工具、参考文档，仅在做复杂操作（如执行 SQL、处理数据）时才加载或运行。
  2. 第一层 · 元数据：YAML 前置信息，仅技能名称、用途等摘要；智能体启动时只加载这部分，几乎不占资源。
  3. 第二层 · 技能主体：完整 SKILL.md，仅在判断与当前任务相关时加载详细步骤和规则。
  4. 第三层 · 附加文件：如 .py 工具、参考文档，仅在做复杂操作（如执行 SQL、处理数据）时才加载或运行。
  5. 减轻判断负担#传统方式中，智能体要面对功能杂乱、可能重复的工具集合，执行时还要费力筛选。Agent Skills 将能力拆成独立小技能，每个只负责单一功能，无重复冗余；执行时只需精准调用对应技能，上下文更清晰，任务更准、更快。
传统方式 vs Agent Skills：
对比项传统方式Agent Skills
加载时机无论是否有用，提前加载全部完整信息按需分层加载（元数据 → 主体 → 附加）
Token易浪费、拖慢响应按需加载，减少重复与冗余
工具形态功能杂乱、可能重复原子化小技能，单一职责
判断负担需费力筛选合适工具精准调用对应技能，负担小

三、配置地狱

Anthropic 推出 Agent Skills 时，核心理念是“写一次，到处使用”，开发者编写一次技能配置，就能在不同 Agent 平台上复用。但现实是，各家平台的目录规范各不相同：
平台Skills 目录
Codex.codex/skills
Claude.claude/skills
Gemini.gemini/skills
这意味着开发者要在多个平台使用同一套 Skills，就得在不同目录间复制文件、创建符号链接，或者写同步工具。原本承诺的“写一次”，变成了维护多份配置、管理一堆软链接。GitHub Issue #15 里有人说得很直接：“我们在技术层面（工具、通信）实现了标准化，但在语义层面（指令、上下文）没做到。这是个问题。”
从倡议到落地，只用了一周2026 年 2 月 3 日，OpenAI 的 Alexander Embiricos 在推特上发起倡议：所有 Agent 统一读取 .agents/skills 目录，用户不用再为每个 Agent 管理独立文件夹。推文写道：“今天我们为 Codex 启用了 .agents/skills。目标是逐步废弃 .codex/skills。“主要平台的响应速度很快：Anomaly 的 dax 直接回复“done”，附上 OpenCode 的 PR 链接；微软 Copilot CLI 在 0.401 版本支持自动加载；谷歌 Gemini CLI 提交代码变更；Cursor 也表示在下个版本跟进。从提议到主流平台响应，不到一周。

工具层的过渡方案#

Vercel 团队推出的 skills.sh 提供了一个过渡期的解决方案：
npx skills add vercel-labs/agent-skills
原理很直接：将 Skill 下载到 .agents/skills/，检测系统中的 AI 工具（Claude、Cursor、Windsurf 等），在各工具的 Skills 目录创建指向 .agents/skills/ 的软链接。开发者只需维护一份源文件，所有工具实时同步。这也是小编之前写过的《为什么我劝你使用 skills.sh 管理 skills》，对于它的使用可以转战这篇文章。随着平台原生支持 .agents/skills，软链接这种过渡方案会逐渐退出，但 skills.sh 的方案默认就是在 .agents 目录下，所以软链接方案会被淘汰，但 skills.sh 仍然好用。将来，你可以直接把 Skills 放在 .agents/skills 下，让所有平台自动识别，也可以继续使用 skills.sh。

四、Agent Skills 规范说明#

核心规范：每个技能对应一个独立文件夹，文件夹内必须包含一个 SKILL.md 文件。该文件是技能的核心，包含 YAML 前置信息（元数据） 和 Markdown 指令 两部分，共同明确技能的功能、触发条件和执行步骤，二者缺一不可。这也是实现「三层渐进式披露」和按需加载的基础。
skill/employees/ ├── SKILL.md  # 技能核心文件（包含元数据+详细指令） └── scripts/  # 附加脚本文件夹（三层结构的第三层）     ├── execute_sql.py  # SQL执行脚本（复杂操作时调用）     └── __pycache__/  # 脚本缓存（自动生成，无需手动创建）

参考链接与第三方网站

  • 文档与导航Claude 官方 Skills 文档 ：最权威的 Agent Skills 规范与功能说明。Agent Skills（claudecn） ：面向中文用户的解读与示例，更贴近国内使用场景。Agent Skills（agentskills.io） ：社区维护的 Skills 导航站，按场景浏览和搜索技能。SkillsHunt ：支持标签与热度筛选的技能发现与搜索平台。
  • Claude 官方 Skills 文档 ：最权威的 Agent Skills 规范与功能说明。
  • Agent Skills（claudecn） ：面向中文用户的解读与示例，更贴近国内使用场景。
  • Agent Skills（agentskills.io） ：社区维护的 Skills 导航站，按场景浏览和搜索技能。
  • SkillsHunt ：支持标签与热度筛选的技能发现与搜索平台。
  • 工具与仓库Skills.sh ：命令行技能管理工具，一条命令即可安装 / 更新 Skills。Vercel Skills ：Vercel 团队维护的示例技能仓库，偏 Web / 全栈场景。baoyu-skills ：本项目作者维护的实战技能合集，适合直接拿来用。ClawHub Skills ：ClawHub 平台的技能市场与发现页。Skill Creator ：Anthropic 官方提供的技能模板与创建向导。
  • Skills.sh ：命令行技能管理工具，一条命令即可安装 / 更新 Skills。
  • Vercel Skills ：Vercel 团队维护的示例技能仓库，偏 Web / 全栈场景。
  • baoyu-skills ：本项目作者维护的实战技能合集，适合直接拿来用。
  • ClawHub Skills ：ClawHub 平台的技能市场与发现页。
  • Skill Creator ：Anthropic 官方提供的技能模板与创建向导。
  • 合集网站：快速使用agent-skills.md ：收录 6000+ 高频常用技能，强调开箱即用、上手快。Skills Directory ：来自 Reddit 社区的技能推荐与整理，更像口碑榜单，适合对比评价后再决定安装。SkillsMP ：聚合 GitHub 上超过 11 万个开源技能，适合「全网搜技能」和溯源到原始仓库。Agent Skills Me ：人工精选的小而精技能集，适合不想自己筛选太久的用户。SkillStore ：中文友好，并强调做过安全审查，适合团队或合规敏感场景。Skills.sh 热门技能页 ：关注热门趋势技能，支持一键安装，适合快速尝鲜。
  • agent-skills.md ：收录 6000+ 高频常用技能，强调开箱即用、上手快。
  • Skills Directory ：来自 Reddit 社区的技能推荐与整理，更像口碑榜单，适合对比评价后再决定安装。
  • SkillsMP ：聚合 GitHub 上超过 11 万个开源技能，适合「全网搜技能」和溯源到原始仓库。
  • Agent Skills Me ：人工精选的小而精技能集，适合不想自己筛选太久的用户。
  • SkillStore ：中文友好，并强调做过安全审查，适合团队或合规敏感场景。
  • Skills.sh 热门技能页 ：关注热门趋势技能，支持一键安装，适合快速尝鲜。
  • 源码仓库：工程实现Awesome Claude Skills ：精选的 Claude Skills 清单与资源索引，覆盖 Claude.ai / Claude Code / Claude API 场景。Ultimate Agent Skills Collection ：终极大杂烩，汇总大量不同来源的技能项目，更像一个「总目录」，适合深挖与扫货。Vercel Agent Skills ：前后端结合的示例仓库，适合参考如何在 Web / 全栈应用里集成 Skills。Antfu Skills ：由 Antfu 维护的实践仓库，代码风格统一、工程化好，适合学习高质量个人实践。Anthropic Skills ：Anthropic 官方的技能实现仓库，适合参考「官方最佳实践」。Awesome Agent Skills ：社区维护的优质技能索引库，「awesome 系」风格，可作为导航入口。
  • Awesome Claude Skills ：精选的 Claude Skills 清单与资源索引，覆盖 Claude.ai / Claude Code / Claude API 场景。
  • Ultimate Agent Skills Collection ：终极大杂烩，汇总大量不同来源的技能项目，更像一个「总目录」，适合深挖与扫货。
  • Vercel Agent Skills ：前后端结合的示例仓库，适合参考如何在 Web / 全栈应用里集成 Skills。
  • Antfu Skills ：由 Antfu 维护的实践仓库，代码风格统一、工程化好，适合学习高质量个人实践。
  • Anthropic Skills ：Anthropic 官方的技能实现仓库，适合参考「官方最佳实践」。
  • Awesome Agent Skills ：社区维护的优质技能索引库，「awesome 系」风格，可作为导航入口。
延伸阅读 · Agent Skills 终极指南想要系统了解推荐技能、最新资讯和实战案例，可查看专题页：《Agent Skills 终极指南：快速入门、推荐技能、最新资讯与实战案例 ｜ The Definitive Guide to Agent Skills: Quick Start, Recommended Skills, Latest News, and Practical Case Studies》
👉 点击跳转到 Awesome Agent Skills
Rocky Rocky
大约 2 个月前
6

扫描下方二维码手机阅读文章