# AI agents

These docs are built to be read by AI agents as well as people. The fastest way to
get an agent productive with the API is the **ready-made skill** below — it teaches
the entire integration in one file.

<SkillDownload lang="en" />

## Install the skill

Drop the skill into your skills directory and it loads automatically whenever the
task touches the Accessful API:

```bash
cd ~/.claude/skills \
  && curl -LO https://docs.accessful.de/agent-skill/accessful-api-skill.zip \
  && unzip accessful-api-skill.zip
```

This unpacks to `~/.claude/skills/accessful-api/SKILL.md`. Use `.claude/skills/` in a
project instead to share it with your team.
Codex has no skill system, but `SKILL.md` is plain Markdown. Save it into your repo
(for example as `AGENTS.md`, or anywhere the agent reads context):

```bash
curl -L https://docs.accessful.de/agent-skill/accessful-api/SKILL.md -o AGENTS.md
```
The skill covers authentication, the upload → poll → download flow, every endpoint,
webhooks (including HMAC-SHA256 verification), limits, and the error format — sourced
only from these docs.

## Other ways agents can read these docs

- **Any page as Markdown** — every page has a **Copy as Markdown** button and an
  **Open in AI** menu (open in ChatGPT or Claude, or view the raw Markdown). Append
  `.md` to any URL for the raw source, e.g. [`/quickstart.md`](https://docs.accessful.de/quickstart.md).
- **`/llms.txt`** — a machine-readable [index of every page](https://docs.accessful.de/llms.txt) following
  the [llmstxt.org](https://llmstxt.org) convention, for agents that crawl the site.
**Tip:** Working with a customer's agent? Point it at the skill or at `/llms.txt` and it can
learn how to connect a client without any hand-holding.