Appearance
Agent Skills 总览
将专业知识封装为 AI Agent 可动态加载的可移植能力包——从概念、价值定位到核心设计哲学的系统介绍。
什么是 Agent Skills
Agent Skills 是一种轻量级开放标准，用于为 AI Agent 扩展专门化能力。它将特定领域的知识和工作流封装成可移植、支持版本控制的文件夹，Agent 可以在需要时加载并执行其中的指令。
从本质上讲，一个 Skill 就是一个包含 SKILL.md 文件的文件夹。这个文件包含最少 name 和 description 两个元数据字段，以及告诉 Agent 如何执行特定任务的指令。Skill 还可以捆绑脚本、参考材料、模板和其他资源。
解决的核心问题
AI Agent 的能力在迅速提升，但它们通常缺乏做好真实工作所需的上下文：
- 领域专业知识 — 如何审查法律合同、如何构建数据管道、如何执行安全审计
- 组织专属惯例 — 内部 API 的调用模式、代码规范、审批流程
- 非显而易见的边界情况 — 某个端点返回 200 不代表服务健康，某张表的软删除需要额外过滤
Skills 通过将这些知识打包成可移植、支持版本控制的文件夹，让 Agent 按需加载，从而解决了这一矛盾。
主要价值
领域专业能力
将专业化知识——从法律审查流程到数据分析管道、从演示文稿格式规范到安全合规检查——封装为可复用的指令和资源。Agent 无需专门训练就能执行这些任务。
可重复的工作流
将多步骤任务转化为一致、可审计的程序。无论是数据库迁移、代码审查还是报告生成，Skills 确保每次执行都遵循相同的标准。
跨产品复用
一次构建，多处运行。同一个 Skill 可以在 Claude.ai、Claude Code、Cursor、VS Code、OpenAI Codex 等任意兼容客户端上运行，无需为每个平台单独适配。
堆叠组合
多个 Skill 可以组合使用处理复杂工作流。Claude 会根据当前上下文自动判断需要哪些 Skill，无需手动选择。
核心设计原则
渐进式披露（Progressive Disclosure）
Agent Skills 采用三层加载机制，让 Agent 可以同时持有数十个 Skill 而不占用过多上下文：
- 元数据（~100 tokens） — 启动时加载所有 Skill 的
name和description，仅用于判断相关性 - 指令（< 5000 tokens 推荐） — 任务匹配时加载完整
SKILL.md体 - 资源（按需） —
scripts/、references/、assets/中的文件仅在需要时加载
这种设计确保了上下文窗口的高效利用，避免了一次性加载所有 Skill 导致的 token 浪费。
纯文本、可版本控制
Skills 是纯 Markdown + YAML 文件，天然适合 Git 管理。团队可以：
- 通过 Pull Request 审查 Skill 变更
- 使用 Git 分支管理不同版本
- 在 CI/CD 中验证 Skill 格式
- 通过 skills.sh 等工具分发和安装
从真实 expertise 出发
最有效的 Skills 源于真实的专业经验，而不是 LLM 的通用知识。创建 Skill 的最佳方式是：
- 先与 Agent 完成一个真实任务，记录每一步和每一次纠正
- 提取其中的可复用模式，封装成 Skill
- 在真实任务中测试并迭代优化
使用场景举例
内置工作流
各平台通常提供一些内置 Skill 处理常见任务：
- 创建带公式的 Excel 表格、带品牌样式的 PowerPoint
- 分析和可视化数据
- 文件格式转换
公司专属 Skill
将组织的知识封装起来，让团队成员获得一致结果：
- 应用品牌规范或偏好的文档格式
- 金融服务领域的预构建 Skill（如 DCF 建模、可比公司分析）
- 医疗保健文档或合规流程
个人工作流
为个人工作方式创建定制化 Skill：
- 自定义笔记系统
- 个人开发工作流
- 研究分析方法
与其他技术的关系
| 技术 | 关系 | 说明 |
|---|---|---|
| Function Calling / Tool Use | 互补 | Function Calling 是 Agent 调用外部工具的通用机制，Skills 是在此基础上封装的领域专属知识 |
| Model Context Protocol (MCP) | 互补 | MCP 是 AI 应用与外部系统的标准化连接协议，Skills 是给 Agent 的指令包，二者常常结合使用 |
| Prompt Engineering | 基础 | Skills 本质上是结构化的、可复用的提示工程，将一次性的 prompt 转化为持久化的能力 |
| AI Agents | 上层 | Skills 是 AI Agent 架构的重要组成部分，解决 Agent 的上下文和专业化能力问题 |
历史与发展
- 2025 年 — Anthropic 提出 Agent Skills 并开源发布，最初主要服务于 Claude Code 和 Claude.ai
- 2025 年下半 — Cursor 在 2.4 版本中原生支持 Skills，并提供了从传统规则和斜杠命令的迁移工具
- 2026 年 — OpenAI 在 Codex 和 API 文档中正式支持 Skills，并在 Agents SDK 中集成
- 2026 年 — Google 发布官方 google/skills 仓库，提供 Cloud、Gemini API 等领域的官方 Skill
- 持续扩展 — 已有 30+ 平台支持，社区生态快速成长
延伸阅读
- SKILL.md 格式规范 — 完整的文件格式与字段定义
- 生态与平台支持 — 各大平台实现差异与社区生态
- 创建与使用最佳实践 — 如何写出高质量的 Skill
- agentskills.io — 官方标准网站