Agent Skills 不是每个网站都要添加的一种 metadata。它是可移植 package，用来教兼容的 AI agent 如何完成一个定义明确的任务。
开放的 Agent Skills specification 以 SKILL.md 为核心。一个 skill 可以围绕它附加 instructions、scripts、references 与 assets，让 agent 只在需要时加载正确上下文。
对产品网站来说，这形成一个清楚边界：API 暴露操作，skill 则解释围绕操作的可重复工作流。
这篇扩展 Agent Skills Index 在 Agent SEO audit 中的意义：它帮助澄清能力，不承诺 AI 搜索可见度。
一个 Skill 包含什么
一个基础可移植 skill 如下：
site-audit/
├── SKILL.md
├── scripts/ # 可选：可执行 helper
├── references/ # 可选：详细文档
└── assets/ # 可选：模板或文件
SKILL.md 放长期有效的高层 instructions。规范要求 frontmatter 至少有 name 与 description；支持材料可在真正相关时再加载。
---
name: site-audit
description: Audit a public website for broken links, indexability, and canonical errors. Use when a user asks for a technical SEO review.
---
# Site audit
1. Confirm the target domain and scope.
2. Run the permitted checks.
3. Separate evidence from recommendations.
Skill 不是 API 本身。它是可复用操作指南，可以调用 API、使用 script，或引导 agent 阅读可靠 source。
Skill、API、MCP 与网站文档
| 资产 | 主要职责 | 最合适场景 |
|---|---|---|
| 网站文档 | 向人解释产品 | 产品教育与支持 |
| OpenAPI 或 API Catalog | 描述并发现 HTTP service | 对外 programmatic capability |
| MCP server | 向 MCP client 暴露 tools 和 resources | 实时 agent-tool interaction |
| Agent Skill | 打包 instructions、workflow 与可选 assets | 兼容 runtime 中的可重复工作 |
llms.txt | 提供可读内容地图 | 精选阅读与导航 |
例如电商 API 可以让 agent 读取库存；product-research skill 则可以解释该使用哪些 filter、先读哪些 policy、何时必须向用户确认。
所以 skills 靠近 API Catalog SEO、MCP Server Card 与 Auth.md 和 OAuth metadata，但不会替代它们。
不要发明网站级 Discovery 标准
Agent Skills 有开放 package 格式，但没有定义每个 agent 都必须抓取的 /.well-known/agent-skills 路径，也没有规定通用 HTML Link relation。
发布者应当：
- 遵循目标 agent runtime 的安装或 discovery 规则；
- 为客户与开发者保留人类可读文档页；
- 只有在 skill 真实且持续维护时，才链接公开仓库或发布 package；
- 不要宣称未明确支持的 client compatibility。
这比发布任意 JSON index 更稳妥。假的 discovery 文件只会让网站看似 ready，却不给 agent 任何可用内容。
一份同时帮助人和 Agent 的能力清单
如果产品有多个 skills，可在产品文档中维护一份简单 capability index：
| 字段 | 示例 |
|---|---|
| Skill name | audit-site |
| 用户结果 | 找出 indexability 与 canonical 问题 |
| Inputs | 公开 URL，可选 sitemap URL |
| 读或写？ | 只读 |
| 所需访问 | 公开页面不需要 |
| Dependencies | Bot simulator、link checker、公开文档 |
| Owner 与复查日期 | SEO platform team，每季度复查 |
这是一项文档与治理资产。不要在公开 package 里暴露私有管理动作、破坏性操作或隐藏凭证。
安全发布工作流
- 选择真实用户结果。 Skill 应解决有边界的任务，而不是替一个部门做广告。
- 写准确 description。 它既是 discovery 也是 activation 信号，要写清任务、inputs 与边界。
- 保持核心 instructions 简短。 深层 references 与大 assets 独立存放。
- 声明副作用。 说明读数据、改状态、认证需求或确认要求。
- 在目标 client 中测试。 用真正会加载该 package 的 tooling 与 runtime 验证。
- 像维护产品文档一样维护。 workflow、API、policy 或权限变化时同步更新。
Agent Skills best practices 建议 focused skills 与 progressive disclosure；过大的 instruction 文件，通常不如小而清晰的结构有用。
发布前做一次 Information-Gain 检查
公开 skill 应包含很难从通用 prompt 还原的运营知识。发布前先问：这个 package 除了“阅读网站并遵循文档”之外，增加了什么？
| 增量 | 强例子 | 弱例子 |
|---|---|---|
| Decision logic | 什么时候合并、什么时候 redirect 重复 URL | “优化 SEO” |
| Verified procedure | 精确 checks、预期 outputs 与 failure branches | 通用五步清单 |
| Reusable asset | 经过测试的 audit template 或 schema | 装饰图片 |
| Product boundary | 哪个动作需要认证或批准 | “安全使用” |
| Maintained reference | 有 version 和 owner 的字段定义 | 没有 review date 的复制概述 |
如果 package 只是复述公开文档，应先改进文档；如果确实包含工作流，就发布能够保留 decision logic 和测试证据的最小 package。
一个实用 Catalog Record
开放规范定义单个 skill package；catalog 是发布方自己负责的文档层。一个可用 record 可以是：
name: audit-indexability
outcome: Identify crawl, canonical, and noindex conflicts
package: https://example.com/skills/audit-indexability.zip
version: 1.3.0
runtime_tested: Example Agent 4.2
access: public-web-read-only
side_effects: none
owner: Technical SEO
reviewed: 2026-07-22
不要在没有 status 的情况下把 planned packages 与 tested packages 混在一起，也不要在未测试具体 runtime 和 version 时发布 compatibility badge。
维护与移除规则
API、permission model、UI、policy 或 runtime 改变时应重新 review。任务已不存在、依赖不可用或 package 无法测试时，应移除或 archive。规模更小但可靠的 catalog，比庞大且陈旧的目录更有价值。
发布前做一次 Information-Gain 检查
公开 skill 应包含很难从通用 prompt 还原的运营知识。发布前先问：这个 package 除了“阅读网站并遵循文档”之外，增加了什么？
| 增量 | 强例子 | 弱例子 |
|---|---|---|
| Decision logic | 什么时候合并、什么时候 redirect 重复 URL | “优化 SEO” |
| Verified procedure | 精确 checks、预期 outputs 与 failure branches | 通用五步清单 |
| Reusable asset | 经过测试的 audit template 或 schema | 装饰图片 |
| Product boundary | 哪个动作需要认证或批准 | “安全使用” |
| Maintained reference | 有 version 和 owner 的字段定义 | 没有 review date 的复制概述 |
如果 package 只是复述公开文档，应先改进文档；如果确实包含工作流，就发布能够保留 decision logic 和测试证据的最小 package。
一个实用 Catalog Record
开放规范定义单个 skill package；catalog 是发布方自己负责的文档层。一个可用 record 可以是：
name: audit-indexability
outcome: Identify crawl, canonical, and noindex conflicts
package: https://example.com/skills/audit-indexability.zip
version: 1.3.0
runtime_tested: Example Agent 4.2
access: public-web-read-only
side_effects: none
owner: Technical SEO
reviewed: 2026-07-22
不要在没有 status 的情况下把 planned packages 与 tested packages 混在一起，也不要在未测试具体 runtime 和 version 时发布 compatibility badge。
维护与移除规则
API、permission model、UI、policy 或 runtime 改变时应重新 review。任务已不存在、依赖不可用或 package 无法测试时，应移除或 archive。规模更小但可靠的 catalog，比庞大且陈旧的目录更有价值。
对 SEO 意味着什么
Agent Skills 可以让支持它的 agent 更稳定地使用真实产品能力，但不会让页面自动可抓取、变得 source-worthy，或获得任何 Google feature 资格。
基础工作仍要做好：
- 用 Technical SEO、导航与 sitemap 让产品页可发现。
- 只有真实公开 API 存在时，才用 API Catalog 记录它。
- 用 Bot Simulator 测试可见内容与机器访问。
- 将 Agent SEO Audit 用作 discovery review，而不是安全或采用证明。
判断标准很简单：agent 拿到 package 后，能否在不获得额外不当权限的情况下，更可靠地完成真实任务？不能，就先发布更好的文档。
Sources
- Agent Skills specification
- Agent Skills：adding client support
- Agent Skills：best practices
- Agent Skills 官方仓库
问答
Agent Skills 有标准的 well-known URL 吗？
没有。开放 Agent Skills specification 标准化的是 skill package 与 SKILL.md，不是统一的网站级 discovery URL。应遵循目标 agent 的安装或发现文档。
发布 skill 会提升搜索排名吗？
不会。Skill 是给兼容 agent 使用的运营 package，不保证抓取、排名、引用或采用。
纯内容站应该发布 skills 吗？
只有在能提供真实可重复的工作流、权威 references 或可用 assets 时才值得。否则普通文档、sitemap 与技术 SEO 更合适。
