Agent Skills Index
Agent Skills Index 是发布方维护的真实 SKILL.md package 目录；开放规范定义单个 skill package，但没有规定通用的网站发现 URL。
Agent Skills Index
Agent Skills Index 是发布方维护的 Agent Skills 目录，帮助用户和兼容的 agent runtime 判断有哪些 package、能完成哪些任务，以及从哪里安装。
“Skills index”可以作为实用的文档名称，但它不是通用 Web 标准。开放的 Agent Skills specification 规范了含必需 SKILL.md 的单个 skill 目录，并没有规定 /.well-known/agent-skills 之类的固定 URL，也没有定义所有 crawler 都支持的 link relation。
一个 Skill Package 包含什么
最小结构是一个带 SKILL.md 的目录：
site-audit/
├── SKILL.md
├── scripts/ # 可选执行脚本
├── references/ # 可选详细资料
└── assets/ # 可选模板或资源
SKILL.md frontmatter 必须包含 name 与 description。Description 不只要说明“做什么”，还要说明“什么时候使用”，因为兼容 client 可能先读取 metadata，再决定是否加载完整 instructions。
可选字段和目录可以加入 license、compatibility、scripts、references 与 assets，但它们不能替代正常权限检查和产品文档。
有用的目录应该展示什么
| 字段 | 价值 |
|---|---|
| Skill name | 与 package 目录和必需 metadata 对应 |
| 支持的结果 | 描述用户任务，而不是模糊部门名称 |
| Inputs | 明确 URL、文件或账户上下文 |
| 读写行为 | 说明工作流是否会改变状态 |
| Authentication | 说明访问要求但不暴露秘密 |
| Compatible runtime | 避免夸大 client 支持 |
| Package URL 与版本 | 让用户安装并审查准确 artifact |
| Owner 与 review date | 明确维护责任 |
只收录真实存在并经过测试的 package。装满“计划能力”的目录只是营销文案，不是可操作 index。
Skill、API、MCP 与 A2A 的区别
- Agent Skill： 面向兼容 runtime 的可复用 instructions 和配套材料。
- OpenAPI description： HTTP operations 的机器可读 contract。
- MCP server： 通过 MCP 暴露的实时 tools 与 resources。
- A2A Agent Card： 接受 agent-to-agent 交互的 A2A server metadata。
- 面向人的文档： 解释行为、政策与支持边界的依据。
Skill 可以调用 API 或 MCP tool，也可以说明何时联系 A2A agent，但不能替代这些接口。
发布工作流
- 选择一个已经能工作的明确用户结果。
- 写清激活条件、inputs 和限制。
- 保持核心 instructions 精简，把深度放进聚焦的 references。
- 声明副作用、认证、依赖和确认门槛。
- 使用官方 reference tooling 验证 package 结构。
- 在每一个声称支持的 runtime 中实际测试。
- 发布 package 与目录页，并写明 owner 和 review date。
公开 package 中绝不能包含 credentials、私有 endpoints、客户数据或隐藏的管理指令。
SEO 与发现边界
发布 skill 不会自动让页面被收录、提高排名，也不能保证搜索或答案引擎采用。目录页仍应使用普通技术 SEO：可抓取 HTML、稳定 URL、合理内链和清楚说明。
实施指南见网站如何暴露可复用 Agent Skills。相关概念包括 API Catalog SEO、MCP Server Card 与 A2A Agent Card。
验证清单
- 每一个目录项都指向真实 package。
- Directory name 与
namemetadata 一致。 - Description 同时说明任务与使用条件。
- Scripts 记录依赖与失败行为。
- 副作用和确认要求清楚可见。
- Compatibility 声明已在对应 runtime 测试。
- Owner 与 review date 仍然有效。
一手来源
问答
Agent Skills 规范定义了网站级 index URL 吗？
没有。规范定义的是单个 skill package 的结构与 metadata。公开目录可以帮助发现 package，但 URL 与发现方式取决于 client 或发布方。
Agent Skill 就是 API 吗？
不是。Skill 打包 instructions，以及可选的 scripts、references 和 assets；它可以使用 API，但不能替代 API contract 或授权层。
发布 skills 会提高 SEO 排名吗？
没有公开文档支持这一结论。只有当 skill 能让受支持的 agent 更可靠地完成真实任务时才值得发布。