Claude Agent Skills

摘要： Agent Skill是Anthropic在2025年提出的AI代理构建标准，通过封装Prompt工程、知识库与执行逻辑为标准化文件（如SKILL.md），实现复杂任务的模块化管理。其核心创新是渐进式披露架构，动态加载必要规则或数据，显著降低上下文Token消耗（60%-80%）并提升指令遵循准确率。相比传统Prompt工程，Agent Skill解决了上下文污染和复用性差的问题，推动AI

造夢先森

1047人浏览 · 2026-01-13 21:45:00

造夢先森 · 2026-01-13 21:45:00 发布

文章目录

一、Agent Skills 是什么
二、Agent Skills架构
- 1.Skills 的文件结构
- 2.SKILL.md 结构
三、Agent Skills vs MCP
四、skills开源项目

一、Agent Skills 是什么

Agent Skill 是 Anthropic 于 2025 年确立的开放式 AI 代理构建标准，其本质是将复杂的 Prompt 工程、外部知识库（Reference）与执行逻辑（Script）封装为标准化的本地文件结构（如 SKILL.md）。

它的核心突破在于 渐进式披露 Progressive Disclosure 架构：模型仅在推理过程中根据意图动态挂载必要的规则片段或数据引用。

实测数据显示，在处理长链条业务流程时，该架构能将上下文 Token 消耗降低 60%-80%，同时显著提升长文本任务中的指令遵循准确率（Instruction Following Accuracy）。

引言：从“提示词工程”到“技能工程”的范式转移:

在 2023-2025 年的大模型爆发初期，开发者主要依赖“提示词工程（Prompt Engineering）”来控制模型行为。

然而，随着企业级应用向**Agentic Workflow（代理工作流）**演进，单纯依靠 System Prompt 面临着两大瓶颈：

上下文污染（Context Pollution）：为了覆盖所有边界情况，Prompt 往往长达数万 Token，导致模型注意力分散，产生“指令漂移”。
复用性极差：复杂的业务逻辑被硬编码在对话历史中，难以跨项目、跨团队迁移。
2025 年 10 月 16 日，Anthropic 推出的 Agent Skill 最初仅作为 Claude 3.7 生态下的实验性功能，旨在解决编码场景下的工具调用问题。但在 VS Code、Cursor 等 IDE 深度集成后，社区迅速意识到这是一种 解耦模型智力与业务逻辑 的通用方案。

2025 年 12 月 18 日，随着 Agent Skill 被确立为开放标准（Open Standard），它正式标志着 AI 开发进入了 技能工程Skill Engineering 的新阶段。

在这里插入图片描述

单个skill是一个目录，其中包含一个 SKILL.md 文件，该文件包含组织有序的文件夹，其中包含指令、脚本和资源，这些指令、脚本和资源为代理提供额外的功能.

Skills 的特点

自包含性：每个 Skill 是一个独立的文件夹，包含所有必要的脚本和资源
可组合性：Skills 可以相互调用和组合，形成更复杂的工作流
上下文感知：Skills 能够访问项目上下文和环境信息
声明式定义：通过 SKILL.md 文件（包含 YAML frontmatter）声明 Skill 的元数据和能力

二、Agent Skills架构

1.Skills 的文件结构

根据官方文档，一个标准的 Skill 包含以下结构：

pdf-skill/
├── SKILL.md # Skill 元数据和核心指令（必需）
├── forms.md # 表单填写指南（可选）
├── reference.md # 详细 API 参考（可选）
└── scripts/ # 实用脚本
└── extract_fields.py

2.SKILL.md 结构

在这里插入图片描述

Skills包含三种类型的内容，每种内容的加载时间各不相同：

Level 1：元数据（始终加载）
Claude启动时，Agent仅加载目录下每个skill的YAML Frontmatter，放入system prompt中。
Level 2：正文核心内容（触发加载）
如果Agent认为需要调用某个skill，它会加载完整的Markdown内容到上下文中。
Level 3：关联文件（按需加载）
Claude将根据提示按需引用关联文件（脚本、模板、参考文档等）。

SKILL.md Metadata

每个 Skill 文件夹中SKILL.md文件头部的 YAML 元数据，主要包含 name（名称）和 description（描述）。
始终加载。它们在 Agent 启动时就会被预加载到 System Prompt 中。
目的：这是技能的“目录”。它只提供了足够的信息让 Claude 知道何时应该使用这个技能。

SKILL.md Body

SKILL.md文件中除元数据外的主体部分，用Markdown编写，包含了执行任务的核心指令。
当技能被触发时。只有当 Claude 认为这个技能与当前任务相关时，它才会去“翻看”这部分内容。
目的：这是技能的“具体章节”，提供了完成任务的核心逻辑。

Resources and code (Bundled Files)

对于复杂的技能，所有信息可能无法全部容纳于一个 SKILLS.md 文件中。此时，开发者可以将额外的上下文（如参考文档、代码片段）拆分到技能目录下的其他文件中，并在 SKILLS.md 中引用它们。这些被引用的文件构成了第三个及更深层次的细节，代理仅在需要时才会导航和读取它们。

三、Agent Skills vs MCP

传统 Prompt vs. Agent Skill 架构对比
在这里插入图片描述
Agent Skills vs MCP

Agent Skill解决“怎么做事”，MCP解决“能访问什么”。它们是现代AI Agent（智能体）工作流中互补的“双引擎”，而不是替代关系。

下面的表格清晰地概括了它们最核心的区别：

对比维度	Model Context Protocol (MCP)	Skills
定位	开放标准协议	模块化能力包
目标	标准化AI与外部工具的通信	可重用工作流的封装
架构	客户端-服务器模式	文件夹+SKILLS.md结构
通信	JSON-RPC协议	渐进式加载机制
应用场景	企业级集成、多厂商互操作、侧重于远程通讯	标准化任务、团队协作、侧重于本地能力

四、skills开源项目

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

Babel幽灵注释：删节点为何删不掉注释？

Babel中"幽灵注释"问题的核心原因是注释并非节点的属性，而是通过leadingComments/trailingComments关联的独立对象。当使用path.remove()删除节点时，注释对象及其位置信息仍保留在内存中，导致生成代码时注释被错误保留或漂移。解决方案包括：1)删除前手动清空注释引用；2)用空语句替换节点；3)清除位置元数据。理解Babel"宁留勿漏"的设计哲学，按照"清注释→

2048 AI社区

Flutter 框架跨平台鸿蒙开发 - 生活中的书法练习应用开发文档

2048 AI社区

Claude Code 使用技巧

Claude Code 使用摘要 Claude Code 提供三种交互模式（默认/自动接受/计划模式），支持多种快捷键和斜杠命令管理对话、记忆和任务。用户可通过CLI启动，使用!执行Shell命令，利用Skill复用常用指令，并通过Subagents处理独立任务。记忆系统分为项目级和用户级，支持图片输入和Hooks自动化。MCP协议可扩展外部工具集成，插件系统增强功能边界。