---
title: 技能
description: 在固定的 skills 目录下封装 Agent Skills。
---

# 技能



Agent Plugins 直接采用 [Agent Skills 规范](https://agentskills.io/specification)，不会重新定义技能格式。Agent Plugins 只规定在插件内发现技能的位置，以及如何隔离失败。

## 目录布局 [#目录布局]

将每个技能放在 `skills/` 的直接子目录中：

```text
skills/
└── deploy/
    ├── SKILL.md
    ├── scripts/
    │   └── rollback.sh
    ├── references/
    │   └── runbook.md
    ├── assets/
    └── examples/
```

如果直接子目录中名为 `SKILL.md` 的路径解析为普通文件，该子目录就是一个已发现的技能。客户端不会递归搜索更深层的后代目录来寻找其他技能。

## 技能格式 [#技能格式]

`SKILL.md` 的 frontmatter 和指令遵循 Agent Skills 规范。技能可以包含它所需的任何其他文件和目录。`scripts/`、`references/` 和 `assets/` 是 Agent Skills 所述的常见约定，并非完整的允许列表。技能是否有效以 Agent Skills 规范为准。

## 失败隔离 [#失败隔离]

如果某个已发现的技能无效，客户端应跳过该技能，在可行时报告错误，并继续加载其他技能和组件类型。

缺少 `skills/` 时，插件仍然有效。如果该路径存在但不是目录，技能组件类型无效，但 MCP 服务器等独立组件不受影响。


---

Source: [content/docs/plugin-authors/skills.mdx](https://github.com/agentplugins/agent-plugins-site/blob/237bbf575f5843214923419f9d0933852662f4f3/content/docs/plugin-authors/skills.mdx)
Source commit: 237bbf575f5843214923419f9d0933852662f4f3

---

For a semantic overview of all documentation, see [/zh/sitemap.md](/zh/sitemap.md)

For an index of all available documentation, see [/zh/llms.txt](/zh/llms.txt)