Human readers browse sidebars and search. AI assistants need structured access to the same content without scraping HTML or maintaining a separate mirror. When your docs live on docs.page in a public GitHub repository, most agent surfaces are already available from the Git source that powers your site.
Before you begin
- A published public docs site on your repository's default branch
- A public GitHub repository (programmatic routes require public visibility; see Public GitHub hosting)
Agent-ready docs serve two audiences from one Git source:
| Surface | On your site | Learn more |
|---|---|---|
| llms.txt | Auto-generated | llms.txt |
| MCP server | On by default | MCP server |
| Agent skills | When you add files | Agent skills |
| Ask AI (beta) | Requires setup | Ask AI |
llms.txt and MCP need no docs.json changes to exist. Agent skills are optional repo content you commit under .agents/skills/. Ask AI is the only surface you explicitly provision and enable.
Most teams start with llms.txt or MCP; both are live on a public site before you change anything. Add Agent skills when you encode team workflows in markdown. Enable Ask AI when readers need an in-docs chat panel.
Every surface reads from the public GitHub repository and ref that power your docs site. Push an MDX update and exports, MCP listings, and Ask AI search reflect it on the next request, using the same model as Public GitHub hosting.
Discovery vs interactive read: llms.txt answers "what exists?" in one HTTP fetch. MCP lets assistants list and read individual pages on demand. Choose llms exports when any HTTP client needs a catalog; choose MCP when the agent works in an editor or terminal session.
Skills and chat: Agent skills extend MCP with repo-specific instructions you own. Ask AI (beta) adds a reader-facing chat panel on your production site (optional, and separate from programmatic access).
Set mcp.enabled to false in docs.json when you want a public site without MCP tools or skill resources. llms.txt exports stay available; there is no separate toggle for them.
Every doc page header includes a Copy page menu with shortcuts for readers and integrators, including View markdown (raw {path}.md), Install with MCP, Connect to Cursor, Connect to VSCode, and Open in Claude (external Claude web chat about the current page). These complement site-wide surfaces like llms.txt and MCP; they do not replace Ask AI, which is a separate in-docs panel you enable explicitly.
See Page actions for the full menu list and MCP server for setup from the live site.