工作原理
Agent Skills 协议定义了智能体与技能交互的简单生命周期：
1. 发现 (Discovery)
启动时，智能体仅加载每个可用技能的轻量级元数据（名称和描述）。这保持了上下文窗口的清洁和高效。
2. 激活 (Activation)
当用户的请求匹配某个技能的描述时，智能体通过读取技能定义文件中的完整指令集来“激活”它。
3. 执行 (Execution)
智能体遵循技能提供的分步指令，其中可能涉及运行代码、处理文件或调用外部 API。
目录结构
技能以简单的目录结构组织。每个技能都在自己的文件夹中，并且需要一个正确的 `SKILL.md` 文件。
文件结构
skill-name/
└── SKILL.md # Required: The main definition file
└── scripts/ # Optional: Helper scripts (Python, Node, etc.)
└── references/ # Optional: Text files for RAG
└── assets/ # Optional: Images or templatesSKILL.md 标准
每个技能的核心都是一个 `SKILL.md` 文件。它结合了用于元数据的 YAML Frontmatter 和用于指令的人类可读 Markdown。这种“双重受众”格式既服务于 AI 智能体，也服务于人类开发者。
SKILL.md
---
name: pdf-processing
description: Extract text and tables from PDF files.
---
# PDF Processing
## When to use this skill
Use this skill when the user needs to work with PDF files...
## How to extract text
1. Use `pdfplumber` for text extraction...为什么使用 Agent Skills?
自文档化
给智能体的指令就是给开发者的文档。
可移植
技能只是文件。它们易于版本控制、分享和编辑。
通用
适用于任何支持该规范的 LLM 和 Agent 框架。
安全
沙箱执行和显式权限范围。
开始探索
准备好看看能做什么了吗？浏览市场，发现数百个社区贡献的技能。