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:

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:

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:

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.

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 for Runflow integrations.”

Discovery resources

Resource	URL	Purpose
Skill	agent-skills/runflow/SKILL.md	Workflow guide for AI coding assistants.
Skills index	agent-skills/index.json	agentskills.io v0.2.0 manifest.
llms.txt	docs.runflow.io/llms.txt	This site’s index for LLMs.
llms-full.txt	docs.runflow.io/llms-full.txt	Full corpus, one-shot ingestion.
Public OpenAPI	docs.runflow.io/api/openapi.public.json	Customer integration spec.
API catalog	/.well-known/api-catalog	RFC 9727 linkset.
Models catalog	models-catalog.json	Full model catalog (45+ models), prices, categories. Live count via GET /v1/public/models.
Public models API	GET /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

Skill

agentskills.io v0.2.0 detail.

MCP server

Connect Claude, Cursor, VS Code via Model Context Protocol.

llms.txt

llmstxt.org convention.

OpenAPI

Spec, codegen recipes.

API catalog

RFC 9727 linkset.