# Docs for AI agents

> llms.txt, llms-full.txt, a Markdown version of every page and the OpenAPI specs. Everything an agent needs to read these docs.

Source: https://docs.emelia.io/docs/ai/llms

These docs are written for people and for agents. Everything below is public, needs no key, and is regenerated at every deploy.

| Resource        | URL                                                                          | Use it for                                                                          |
| --------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Index           | [/llms.txt](https://docs.emelia.io/llms.txt)                                                       | The map of the docs, every page with a one line summary and a link to its Markdown. |
| Full text       | [/llms-full.txt](https://docs.emelia.io/llms-full.txt)                                             | Every page in one Markdown file, in the order of the sidebar.                       |
| One page        | Add `.md` to any URL, for example [/docs/quickstart.md](https://docs.emelia.io/docs/quickstart.md.md) | The exact page, without the site around it.                                         |
| Emelia API spec | [/openapi/emelia.json](https://docs.emelia.io/openapi/emelia.json)                                 | OpenAPI 3: code generation, Postman, Insomnia, agents.                              |
| Claude skill    | [/skills/emelia-api.zip](https://docs.emelia.io/skills/emelia-api.zip)                             | The API rules in one file, see [Claude skill](https://docs.emelia.io/docs/ai/claude-skill.md).               |

## On every page

The **Copy page** menu, at the top of each page, gives the same resources in one click:

* **Copy page**: copies the page as Markdown, ready to paste in a chat.
* **View as Markdown**: opens the `.md` version.
* **Open in Claude**, **Open in ChatGPT**, **Open in Cursor**: opens the assistant with a prompt that points to the Markdown version of the page.

Each page also declares its Markdown version in its HTML head (`<link rel="alternate" type="text/markdown">`), so a crawler finds it without guessing.

## In your editor

Most AI editors let you add documentation by URL. Give them `https://docs.emelia.io/llms-full.txt`, or a single `.md` page for a focused task.

## Route pages

The Markdown version of a route page is generated from the OpenAPI spec: method and URL, a link to its guide, parameters, request body fields, examples in cURL, JavaScript and Python, and the responses with their fields. For example: [/docs/lists/add-contacts-in-bulk.md](https://docs.emelia.io/docs/lists/add-contacts-in-bulk.md.md).

In `/llms.txt`, every route is listed under its topic with its method and path, for example `POST /lists/list/{listId}/contacts/batch`.