技能

Agent Plugins 直接采用 Agent Skills 规范，不会重新定义技能格式。Agent Plugins 只规定在插件内发现技能的位置，以及如何隔离失败。

目录布局

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

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 服务器等独立组件不受影响。