agent-docs
由 tylervovan 提供
AI & LLMs简介
Create documentation optimized for AI agent consumption.
描述
该技能的功能
Guides writing documentation structured for AI agent consumption, covering token efficiency, RAG chunking, and context hierarchy. Applies to AGENTS.md constitutions, llms.txt indexes, SKILL.md files, and API docs read by LLMs. Based on Vercel benchmarks showing inline docs achieve 100% agent task pass rates versus 53% with retrieval-only approaches.
Inline AGENTS.md achieves a 100% agent task pass rate compared to 53% for tool-based retrieval alone, because agents skip fetching docs they assume they already know from training.
何时使用
- Writing AGENTS.md constitutions for a new codebase
- Generating a llms.txt index for an existing project
- Structuring API docs so an agent retrieves the right chunk
- Auditing a README for token efficiency before adding it to agent context
- Creating SKILL.md files for OpenClaw agent workflows
示例工作流
User asks: Create an AGENTS.md for my Next.js project
- 1
Identifies stack, architecture constraints, and critical governance rules
- 2
Places security rules and build commands at the top to exploit primacy bias
- 3
Writes a compressed docs index with file paths and function signatures, not full code
- 4
Structures each H2 section to be self-contained for RAG chunk boundaries
- 5
Validates total inline context stays under 4,000 tokens
AGENTS.md with governance rules, a docs index, and architecture constraints ready for agent context windows
安装
clawhub install tylervovan/agent-docs运行 CLI 命令,或把这段提示词粘贴到 Claude Code、Cursor、Codex 或你在用的任意编程智能体里。