1

一、技能作用

2

Agent Skills 是一种给兼容 Agent 提供可复用说明与资源的开放目录格式；最小 Skill 只需要包含名称、描述和任务说明的 SKILL.md。

3

二、能解决什么

4

规范解释发现、激活和执行三个阶段；可选的 scripts、references 与 assets 能携带确定性工具，同时避免启动时把全部内容塞进上下文。

5

三、推荐上手方式

6

先读概览，把规范目录树与一个官方示例对照，再创建一个只有说明的最小 Skill，最后才考虑脚本或外部依赖。

7

四、环境与前置条件

8

需要支持 Agent Skills 的客户端；该仓库是规范和文档来源，并不是一键安装的技能市场。

9

五、适合谁

10

适合想判断技能仓库是否规范，或把内部流程制作成可移植 Skill 的新手。

11

六、局限与安全边界

12

兼容该格式不代表不同客户端支持完全相同的 Hook、权限与安装方式；具体 Skill 还可能使用不同许可证。 脚本和二进制文件应按代码审查，核对外部链接，不把密钥写入 Skill，并要求删除、发布等外部操作经过明确批准。

13

七、项目与许可

14

仓库内容按 Apache-2.0 code and CC-BY-4.0 documentation 提供，具体以项目当前 LICENSE 为准。项目地址：https://github.com/agentskills/agentskills

15

把目标拆成输入、动作和输出，再逐步加入检查点。

16

保留示例、失败条件和复核标准，教程才真正可复用。

提示：先用小样例验证，再扩大到真实任务。