agent skills介绍

什么是SKILLS

一个 Skills 通常以一个文件夹的形式存在，里面主要装着三样东西：一份说明书（SKILL.md）、一堆操作脚本（Script）、以及一些参考资料（Reference）。

可以把一个 Skill 想象成一个打包好的“技能包”。它把完成某个特定任务所需的领域知识、操作流程、要用到的工具、以及最佳实践全都封装在了一起。当 AI 面对相应请求时，就能像一位经验丰富的专家那样，有条不紊地自主执行。

Agent Skills 在 2025 年 12 月正式成为开放规范，目前已有包括 Claude、Cursor、VS Code、GitHub Copilot、OpenCode等主流AI开发工具宣布兼容支持。

Skill 的架构原理：渐进式加载

为了平衡效果和效率，Skill 设计了一套聪明的三层分级加载机制：

元数据（始终加载）

元数据就像是 Skill 的“名片”，里面有名称（name）和描述（description），是用 YAML 格式来定义的。Claude 在启动的时候，会把所有已经安装的 Skill 的元数据都加载进来，这样它就能知道每个 Skill 有什么用、什么时候该用。因为元数据很轻量，所以你可以安装很多 Skill，不用担心把上下文占满。

说明文档（触发时加载）

SKILL.md 文件的正文就是说明文档，里面有工作流程、最佳实践和操作指南。只有用户的请求和 Skills 元数据里的描述相符时，Claude 才会用 bash 指令读取这份文档，把内容加载到上下文里。这种“触发式加载”能保证只有相关的详细指令才会消耗 Token。

资源与代码（按需加载）

Skills 还能打包一些更深入的资源，比如更详细的说明文档（forms.md）、可执行脚本（.py）或者参考资料（像 API 文档、数据库结构等）。Claude 只有在需要的时候，才会通过bash去读取或执行这些文件，而且脚本代码本身不会进入上下文。这样一来，Skills 就能捆绑大量信息，几乎不会增加额外的上下文成本。

如何编写skill

以claude code工具为例

1、安装skill-creator

skill-creator是一个元技能，用来帮助你快速创建和管理其他 Claude Code 技能。安装后，你只需用自然语言描述需求，它就能自动生成符合规范的SKILL.md文件和相关目录结构。

方式1：命令安装

安装官方技能库

/plugin marketplace add anthropics/skills

安装技能包：市场添加成功后，接着输入以下命令来安装技能包。

/plugin install example-skills@anthropic-agent-skills

安装完成后重启claude code

方式2：手动安装

下载skill（通过git 或者去github上下载）

 git下载：git clone https://github.com/anthropics/skills.git
 github下载：访问https://github.com/anthropics/skills 
 下载压缩包

将 skill-creator 文件夹复制到 Claude Code 放置在cluade用户级或项目级技能目录下（如果其他skill也需要也可以基于需求复制放置）

2、编写skill

使用skill-creator编写一个每次编写.py文件都在开头加上author和时间

/skill-creator 创建一个 Python 脚本生成 skill：每次编写 Python 脚本时，在文件开头自动添加 # author: axing 和 # datetime: {当前时间}。当前时间通过调用 datetime.ts 脚本获取，输出格式为 datetime:2026年04月12日 15:30:45，只提取冒号后的时间值。时间格式为中文年月日时分秒。