> ## Documentation Index
> Fetch the complete documentation index at: https://agentskills.ooos.top/llms.txt
> Use this file to discover all available pages before exploring further.

# 什么是 skills？

> Agent Skills 是一种轻量级、开放的格式，用于通过专业知识和工作流程扩展 AI agent 的能力。

从本质上讲，一个 skill 是一个包含 `SKILL.md` 文件的文件夹。该文件包括元数据（至少包含 `name` 和 `description`）和指导 agent 如何执行特定任务的说明。Skills 还可以打包脚本、模板和参考资料。

```directory theme={null}
my-skill/
├── SKILL.md          # 必需：说明 + 元数据
├── scripts/          # 可选：可执行代码
├── references/       # 可选：文档
└── assets/           # 可选：模板、资源
```

## Skills 如何工作

Skills 使用**渐进式披露**来高效管理上下文：

1. **发现**：在启动时，agents 仅加载每个可用 skill 的名称和描述，仅此足以了解何时可能相关。

2. **激活**：当任务与 skill 的描述匹配时，agent 将完整的 `SKILL.md` 说明读入上下文。

3. **执行**：agent 遵循说明，根据需要可选择加载引用的文件或执行捆绑的代码。

这种方法使 agents 保持快速，同时按需提供更多的上下文访问。

## SKILL.md 文件

每个 skill 都从一个包含 YAML frontmatter 和 Markdown 说明的 `SKILL.md` 文件开始：

```mdx theme={null}
---
name: pdf-processing
description: 从 PDF 文件中提取文本和表格，填写表单，合并文档。
---

# PDF 处理

## 何时使用此 skill
当用户需要处理 PDF 文件时使用此 skill...

## 如何提取文本
1. 使用 pdfplumber 进行文本提取...

## 如何填写表单
...
```

以下 frontmatter 必须位于 `SKILL.md` 的顶部：

* `name`：一个简短的标识符
* `description`：何时使用此 skill

Markdown 正文包含实际说明，对结构或内容没有特定限制。

这种简单格式有一些关键优势：

* **自文档化**：skill 作者或用户可以阅读 `SKILL.md` 并了解其功能，使 skills 易于审核和改进。

* **可扩展**：Skills 的复杂性可以从纯文本说明到可执行代码、资产和模板。

* **可移植**：Skills 只是文件，因此易于编辑、版本控制和共享。

## 下一步

* [查看规范](/specification) 以了解完整格式。
* [为您的 agent 添加 skills 支持](/integrate-skills) 以构建兼容的客户端。
* 在 GitHub 上[查看示例 skills](https://github.com/anthropics/skills)。
* 阅读[编写最佳实践](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) 以编写有效的 skills。
* [使用参考库](https://github.com/agentskills/agentskills/tree/main/skills-ref) 来验证 skills 并生成提示 XML。