> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-release-1-17-0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> 将单项任务及其配套文件打包为可复用的 Skill，并在工作空间内共享

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/self-host/use-dify/build/skills)。

Skill 是一次构建、重复使用的独立内容包。其中的 `SKILL.md` 包含一项任务的执行说明，并告诉 Agent 何时使用；还可加入该任务所需的参考资料和脚本。完整格式参见 [Agent Skills](https://agentskills.io/home)。

在 **Skills** 页面创建、导入和管理 Skill 库中的 Skill。

Skill 库最多可保存 500 个 Skill，并在整个工作空间内共享。发布 Skill 更新后，所有使用它的 Agent 都会采用最新版本。

Skill 可用于：

* [新 Agent 应用](/zh/self-host/use-dify/build/new-agent/build#skill)
* [Workflow 应用](/zh/self-host/use-dify/build/workflow-chatflow) 中的 [新 Agent 节点](/zh/self-host/use-dify/nodes/agent)

<Info>
  创建和管理 Skill 需要编辑及以上角色。
</Info>

## 创建 Skill

在 **Skills** 页面点击 **创建**。如需以现有 Skill 为起点，在其 **⋯** 菜单中选择 **复制**；复制已发布的 Skill 时，不包含草稿中的更改。无论采用哪种方式，系统都会打开编辑器，你可自行编写，也可通过 [Skill Builder](#使用-skill-builder-起草) 生成草稿。

在 `SKILL.md` 正文中写明 Agent 要遵循的流程，并在 frontmatter 中设置：

* **显示名称**：显示在侧边栏顶部以及 Skill 出现的各处。使用容易辨认的名称。
* **名称**：Agent 引用 Skill 时使用的唯一名称，例如 `refund-requests`。
* **描述**：Agent 通过它判断是否使用该 Skill。描述要具体。
* **元数据**：用于记录其他参考信息的自定义字段，例如 `owner: payments-team` 或 `source: https://wiki.example.com/refund-policy`。

通过文件树添加脚本、参考资料和其他配套文件。不同文件类型支持的操作如下：

* **文本和代码**（Markdown、脚本、JSON、YAML 等）：直接编辑。
* **CSV、图片和 PDF**：直接预览。
* **其他文件**：下载后查看。

### 使用 Skill Builder 起草

与 Skill Builder 对话，让它为你起草 Skill。描述使用场景或附上已有的流程文档，它会编写 `SKILL.md` 并创建配套文件，供你检查和完善。

支持以下文件类型：

| 类型         | 示例                                          |
| :--------- | :------------------------------------------ |
| PDF        | `.pdf`                                      |
| Word       | `.docx`                                     |
| Excel      | `.xlsx`                                     |
| PowerPoint | `.pptx`                                     |
| RTF        | `.rtf`                                      |
| 图片         | `.png`、`.jpg`、`.jpeg`、`.gif`、`.webp`、`.svg` |
| 文本和数据      | `.txt`、`.md`、`.csv`、`.json`、`.yaml`         |

每条消息最多附加 10 个文件：图片不超过 10 MB，其他文件不超过 15 MB。这些文件只为 Skill Builder 提供上下文，不会成为 Skill 的一部分。要将文件加入 Skill，请通过文件树添加。

## 导入 Skill

要把在其他地方构建的 Skill 加入 Skill 库，点击 **导入**，选择 `.zip` 或 `.skill` 包。包内需有 `SKILL.md`，大小默认不超过 50 MB，可通过 [`UPLOAD_SKILL_FILE_SIZE_LIMIT`](/zh/self-host/deploy/configuration/environments#upload_skill_file_size_limit) 调整。导入后，Skill 会以草稿状态加入 Skill 库，供你检查并发布。

## 为 Skill 添加标签

在 Skill 卡片或编辑器中添加标签，再按标签筛选 Skill。

## 发布和版本

更改会自动保存为草稿。发布草稿后，才能将 Skill 添加到 Agent。每次发布都会保存为一个版本，之后可重新查看或恢复。要记录版本变化，打开对应版本的 **⋯** 菜单，添加标题和说明。

<Note>
  恢复版本会替换当前草稿。发布该草稿后，它才会成为最新版本。
</Note>

## 导出 Skill

要在当前工作空间之外使用 Skill，在其卡片的 **⋯** 菜单中选择 **导出**。你会获得 Skill 最新发布版本的 `.zip` 文件。

## 删除 Skill

删除 Skill 会将它及其全部版本从工作空间和所有使用它的 Agent 中移除。删除后无法恢复；如之后可能还会用到，请先导出副本。