> ## 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.

# Agent skills

> Runflow ships one agentskills.io v0.2.0 skill: integration guide for AI coding assistants.

[Agent Skills](https://agentskills.io) is a convention for publishing integration instructions that AI coding assistants discover and follow. Runflow exposes one skill.

## The index

```bash theme={"dark"}
curl https://www.runflow.io/.well-known/agent-skills/index.json
```

```json theme={"dark"}
{
  "$schema": "https://agentskills.io/schema/v0.2.0/index.json",
  "skills": [
    {
      "name": "runflow",
      "type": "instructions",
      "description": "Integrate the Runflow API.",
      "url": "https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md",
      "sha256": "<pinned hash>"
    }
  ]
}
```

The `sha256` lets agents detect tampering between fetch and use.

## The skill

```bash theme={"dark"}
curl https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md
```

Markdown body. Covers: API key setup, base URL, auth header, model catalog discovery, run lifecycle, callback or polling result delivery, error handling, common pitfalls.

## Install in your agent

See [For agents](/agents) for the recommended install flow. Prefer installing `SKILL.md` into a project or user skill directory over pasting long instructions into a prompt.

## Why a skill, not just docs?

A skill is a single, discoverable, hash-pinned document an agent fetches once. Docs are a website you navigate. Agents prefer the skill because:

* One fetch, no crawl.
* SHA256 makes tampering detectable.
* Versioned at the URL level.
* Freed from the surrounding marketing copy.

Use the skill as the workflow guide. Use OpenAPI for endpoint schemas and auth, and the models catalog for model availability and pricing. If they disagree, check the machine-readable source before coding.

## Related

<CardGroup cols={2}>
  <Card title="OpenAPI" icon="code" href="/agents/openapi">For agents that codegen instead.</Card>
  <Card title="llms.txt" icon="file-lines" href="/agents/llms-txt">For LLMs that ingest the corpus.</Card>
</CardGroup>