# Send Agent Docs to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "agent-docs", "name": "Agent Docs", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/tylervovan/agent-docs", "canonicalUrl": "https://clawhub.ai/tylervovan/agent-docs", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/agent-docs", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-docs", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/advanced-patterns.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "agent-docs", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T01:42:08.501Z", "expiresAt": "2026-05-06T01:42:08.501Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-docs", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-docs", "contentDisposition": "attachment; filename=\"agent-docs-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "agent-docs" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/agent-docs" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/agent-docs", "downloadUrl": "https://openagent3.xyz/downloads/agent-docs", "agentUrl": "https://openagent3.xyz/skills/agent-docs/agent", "manifestUrl": "https://openagent3.xyz/skills/agent-docs/agent.json", "briefUrl": "https://openagent3.xyz/skills/agent-docs/agent.md" } } ``` ## Documentation ### Agent Docs Write documentation that AI agents can efficiently consume. Based on Vercel benchmarks and industry standards (AGENTS.md, llms.txt, CLAUDE.md). ### The Hybrid Context Hierarchy Three-layer architecture for optimal agent performance: ### Layer 1: Constitution (Inline) Always in context. 2,000–4,000 tokens max. # AGENTS.md > Context: Next.js 16 | Tailwind | Supabase ## 🚨 CRITICAL - NO SECRETS in output - Use \`app/\` directory ONLY ## 📚 DOCS INDEX (use read_file) - Auth: \`docs/auth/llms.txt\` - DB: \`docs/db/schema.md\` Include: Security rules, architecture constraints Build/test/lint commands (top for primacy bias) Documentation map (where to find more) ### Layer 2: Reference Library (Local Retrieval) Fetched on demand. 1K–5K token chunks. Framework-specific guides Detailed style guides API schemas ### Layer 3: Research Assistant (External) Gated by allow-lists. Edge cases only. Latest library updates Stack Overflow for obscure errors Third-party llms.txt ### Why This Works Vercel Benchmark (2026): ApproachPass RateTool-based retrieval53%Retrieval + prompting79%Inline AGENTS.md100% Root cause: Meta-cognitive failure. Agents don't know what they don't know—they assume training data is sufficient. Inline docs bypass this entirely. ### 1. Compressed Index > Full Docs An 8KB compressed index outperforms a 40KB full dump. Compress to: File paths (where code lives) Function signatures (names + types only) Negative constraints ("Do NOT use X") ### 2. Structure for Chunking RAG systems split at headers. Each section must be self-contained: ## Database Setup ← Chunk boundary Prerequisites: PostgreSQL 14+ 1. Create database... Rules: Front-load key info (chunkers truncate) Descriptive headers (agents search by header text) ### 3. Inline Over Links Agents can't autonomously browse. Each link = tool call + latency + potential failure. ApproachToken LoadAgent SuccessFull inline~12K✅ HighLinks only~2K❌ Requires fetchingHybrid~4K base✅ Best of both ### 4. The "Lost in the Middle" Problem LLMs have U-shaped attention: Strong: Start of context (primacy) Strong: End of context (recency) Weak: Middle of context Solution: Put critical rules at TOP of AGENTS.md. Governance first, details later. ### 5. Signal-to-Noise Ratio Strip everything that isn't essential: No "Welcome to..." preambles No marketing text No changelogs in core docs Formats like llms.txt and AGENTS.md mechanically increase SNR. ### llms.txt Standard Machine-readable doc index for agents: # Project Name > One-line project description. ## Authentication - [Setup](docs/auth/setup.md): Environment vars and init - [Server](docs/auth/server.md): Cookie handling ## Database - [Schema](docs/db/schema.md): Full Prisma schema Location: /llms.txt at domain root Companion: /llms-full.txt — full concatenated docs, HTML stripped ### Inline = Trusted AGENTS.md is part of your codebase. Controlled, version-pinned. ### External = Attack Surface Indirect prompt injection via hidden text SSRF risks if agents can browse freely Dependency on external uptime Mitigation: Domain allow-lists, human-in-the-loop for external retrieval. ### Anti-Patterns Pasting 50 pages — triggers "Lost in the Middle" "See external docs" — agents can't browse autonomously Generic advice — "Write clean code" (use specific constraints) TOC-only docs — indexes without content Trusting retrieval alone — 53% vs 100% pass rate ### Advanced Patterns For detailed guidance on RAG optimization, multi-framework docs, and API templates, see references/advanced-patterns.md. ### Validation Checklist Critical governance at TOP of doc Total inline context under 4K tokens Each H2 section self-contained No external links without inline summary Negative constraints explicit ("Do NOT...") File paths and signatures, not full code ## Trust - Source: tencent - Verification: Indexed source record - Publisher: tylervovan - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T01:42:08.501Z - Expires at: 2026-05-06T01:42:08.501Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/agent-docs) - [Send to Agent page](https://openagent3.xyz/skills/agent-docs/agent) - [JSON manifest](https://openagent3.xyz/skills/agent-docs/agent.json) - [Markdown brief](https://openagent3.xyz/skills/agent-docs/agent.md) - [Download page](https://openagent3.xyz/downloads/agent-docs)