做了一个 awesome-guide.md：收集那些专门给 AI Agent 读的 Markdown 指南

[vodmaker]

最近发现一个挺有意思的趋势：越来越多网站、产品和文档站开始主动提供 Markdown 格式的入口，给 AI Agent 读取或执行。

比如：

• 告诉 Agent 怎么注册、鉴权、拿 API Key
• 告诉 Agent 怎么调用 API 或发现资源
• 提供 skill.md、guide.md、getting-started.md 之类的专用入口
• 明确说明“这是给 AI Agent 用的文档”

所以我整理了一个小项目：awesome-guide.md。

这个项目是什么

awesome-guide.md 是一个列表，用来收集互联网上那些“网站主动暴露给 AI Agent 的 Markdown 指南入口”。

它不是普通 API 文档导航，也不是又一个大而全的 awesome-list 。收录标准会更窄一点：

• 必须是网站、产品、服务或文档站公开提供的 Markdown 指南
• 必须能指导 AI Agent 完成接入、注册、鉴权、调用、集成、资源发现或理解服务
• 必须能从公开网页、官方文档、官方仓库或可信公开资料中验证来源
• 只收录 .md 或明确以 Markdown 形式提供的页面
• 普通 API 文档不收，除非它明确是面向 AI Agent 的

目前已经收录的一些例子

项目里目前收了一些比较典型的入口，例如：

• Moltbook 的 skill.md
• Telnyx 的 getting-started.md
• Hookdeck 的 AI Agent Resources
• Redis 的 AI Agent Resources Markdown 入口
• Inkbox 的 agent signup 文档
• 搭桥的 guide.md
• doc2md.cn 的 api.md

这些入口的共同点是：它们不只是“给人看的文档”，而是更接近“给 Agent 读完后可以直接行动的说明书”。

为什么想做这个

我觉得这类 Markdown 指南可能会变成未来服务接入的一种轻量协议。

以前是：

人打开网页 -> 看文档 -> 写代码调用 API

现在可能逐渐变成：

Agent 读取 Markdown 指南 -> 理解接入方式 -> 完成注册、鉴权、调用或集成

这中间会出现很多新的约定，比如：

• 文件应该叫 guide.md、skill.md 还是 llms.txt 关联的某个入口？
• Agent 专用文档应该写到什么粒度？
• 是否需要包含 OpenAPI 、MCP 、CLI 、权限说明、速率限制？
• 如何证明这个入口确实是官方公开提供的？
• 哪些内容适合给 Agent 自动执行，哪些必须留给用户确认？

awesome-guide.md 想先把这些案例收集起来，方便大家观察这个方向到底在怎么演化。

适合谁看

如果你在做这些事情，可能会感兴趣：

• 给自己的产品设计 AI Agent 接入文档
• 研究 llms.txt、MCP 、Agent skill 、Markdown docs
• 想看看哪些服务已经开始主动面向 Agent 提供入口
• 做爬虫、文档索引、Agent 工具调用、自动化集成
• 想给自己的服务加一个“Agent 友好”的接入说明

欢迎提交

如果你知道类似的公开入口，欢迎提 Issue：

项目地址：https://github.com/YUHAI0/awesome-guide.md