> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# For agents

> Front door for AI agents integrating Runflow. Skill, llms.txt, OpenAPI, API catalog.

For agent integrations, start with the **Runflow skill**. It is the shortest path to the correct workflow.

## Install the skill

If your coding agent has file access, it can install the skill for you. Open the agent in the repo where you are integrating Runflow and ask:

```text theme={"dark"}
Install the Runflow Agent Skill for this project.

Create .agents/skills/runflow/SKILL.md by downloading:
https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md

Then use that skill whenever this repo integrates, calls, or debugs Runflow.
Use OpenAPI for endpoint schemas and auth, and the models catalog for model
availability and pricing. Never write API keys to files.
```

If you prefer to install it yourself, run this from the project root:

```bash theme={"dark"}
mkdir -p .agents/skills/runflow
curl -fsSL https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md \
  -o .agents/skills/runflow/SKILL.md
```

For a user-wide install, use your home directory instead:

```bash theme={"dark"}
mkdir -p ~/.agents/skills/runflow
curl -fsSL https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md \
  -o ~/.agents/skills/runflow/SKILL.md
```

Agents with native skill managers may also have their own install command or directory. Common project directories are `.agents/skills/`, `.claude/skills/`, `.cursor/skills/`, `.github/skills/`, and `.codex/skills/`. Prefer `.agents/skills/` when you want the skill to travel with the repo across compatible agents.

Set `RUNFLOW_API_KEY` in the environment where your agent runs. Do not put it in `SKILL.md` or commit it to the repo.

<Note>
  Only use a system prompt or rules file when your agent cannot read skill directories. In that case, add one short instruction: "Use the Runflow skill at [https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md](https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md) for Runflow integrations."
</Note>

## Discovery resources

| Resource          | URL                                                                                                 | Purpose                                                                                                                                                         |
| ----------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Skill             | [`agent-skills/runflow/SKILL.md`](https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md) | Workflow guide for AI coding assistants.                                                                                                                        |
| Skills index      | [`agent-skills/index.json`](https://www.runflow.io/.well-known/agent-skills/index.json)             | agentskills.io v0.2.0 manifest.                                                                                                                                 |
| llms.txt          | [`docs.runflow.io/llms.txt`](https://docs.runflow.io/llms.txt)                                      | This site's index for LLMs.                                                                                                                                     |
| llms-full.txt     | [`docs.runflow.io/llms-full.txt`](https://docs.runflow.io/llms-full.txt)                            | Full corpus, one-shot ingestion.                                                                                                                                |
| Public OpenAPI    | [`docs.runflow.io/api/openapi.public.json`](https://docs.runflow.io/api/openapi.public.json)        | Customer integration spec.                                                                                                                                      |
| API catalog       | [`/.well-known/api-catalog`](https://www.runflow.io/.well-known/api-catalog)                        | RFC 9727 linkset.                                                                                                                                               |
| Models catalog    | [`models-catalog.json`](https://www.runflow.io/models-catalog.json)                                 | Full model catalog (45+ models), prices, categories. Live count via [`GET /v1/public/models`](https://api.runflow.io/v1/public/models).                         |
| Public models API | [`GET /v1/public/models`](https://api.runflow.io/v1/public/models)                                  | Unauthenticated catalog read. Same shape as the model details on this site. Use it for client-side pickers and discovery flows that should not ship an API key. |

## Hosts

| Host                | Purpose                                           |
| ------------------- | ------------------------------------------------- |
| `api.runflow.io`    | Production API.                                   |
| `docs.runflow.io`   | This site.                                        |
| `app.runflow.io`    | Dashboard and per-model `llms.txt`.               |
| `www.runflow.io`    | Marketing and agent discovery (`/.well-known/*`). |
| `public.runflow.io` | Public CDN for example assets.                    |

## Pages in this section

<CardGroup cols={2}>
  <Card title="Skill" icon="sparkles" href="/agents/skills">agentskills.io v0.2.0 detail.</Card>
  <Card title="MCP server" icon="plug" href="/agents/mcp">Connect Claude, Cursor, VS Code via Model Context Protocol.</Card>
  <Card title="llms.txt" icon="file-lines" href="/agents/llms-txt">llmstxt.org convention.</Card>
  <Card title="OpenAPI" icon="code" href="/agents/openapi">Spec, codegen recipes.</Card>
  <Card title="API catalog" icon="link" href="/agents/api-catalog">RFC 9727 linkset.</Card>
</CardGroup>