# Resources for AI

> The machine-readable files every build of the Egon documentation publishes for AI tools: llms.txt, markdown pages, the OpenAPI schema, and skills.

Every build publishes the documentation, the OpenAPI schema, and the agent skills in **formats an AI tool can read** directly.

## Download Files

Give these files to your AI assistant or coding agent. `llms.txt` indexes every page, `llms-full.txt` holds the whole documentation, the OpenAPI schema describes every endpoint, and the [agent skills](https://documentation.egon.com/docs/build-with-ai/skills.md) teach a coding agent how to call Egon and run a batch job.

### LLM Files

- [llms.txt](https://documentation.egon.com/llms.txt)
- [llms-full.txt](https://documentation.egon.com/llms-full.txt)

### OpenAPI Schema

- [openapi.json](https://documentation.egon.com/openapi.json)
- [openapi.yaml](https://documentation.egon.com/openapi.yaml)

For a single service family, download its schema from the [API Reference](https://documentation.egon.com/docs/api.md#openapi-schema).

## Which File to Use

Add the site domain to each path.

| Path                             | Content                                                        | Use it when                                             |
| -------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------- |
| `/llms.txt`                      | Index of every page, with a link to its markdown version       | The assistant should find the pages it needs            |
| `/llms-full.txt`                 | The whole documentation in one markdown file                   | You want to load everything at once                     |
| `<page>.md`                      | Markdown version of a page: add `.md` to any page URL          | You work on a single endpoint                           |
| `/openapi.json`, `/openapi.yaml` | The full OpenAPI schema                                        | You generate a client or typed models                   |
| `/openapi/<family>.json`         | The OpenAPI schema of one service family, also in `.yaml`      | You need one family and a smaller context               |
| `/skills/<name>/SKILL.md`        | An agent skill, see [Agent Skills](https://documentation.egon.com/docs/build-with-ai/skills.md) | Your coding agent should load the Egon rules on its own |