# KI-Agenten

Diese Doku ist so gebaut, dass sie sich auch von KI-Agenten lesen lässt — nicht nur
von Menschen. Am schnellsten wird ein Agent mit dem **fertigen Skill** unten
produktiv: Er bringt die gesamte Integration in einer einzigen Datei bei.

<SkillDownload lang="de" />

## Skill installieren

Lege den Skill in dein Skills-Verzeichnis — er wird automatisch geladen, sobald es
um die Accessful-API geht:

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

Das entpackt nach `~/.claude/skills/accessful-api/SKILL.md`. Nutze stattdessen
`.claude/skills/` im Projekt, um ihn mit deinem Team zu teilen.
Codex hat kein Skill-System, aber `SKILL.md` ist normales Markdown. Speichere die
Datei in deinem Repo (z. B. als `AGENTS.md` oder dort, wo der Agent Kontext liest):

```bash
curl -L https://docs.accessful.de/agent-skill/accessful-api/SKILL.md -o AGENTS.md
```
Der Skill deckt Authentifizierung, den Ablauf Upload → Status → Download, alle
Endpunkte, Webhooks (inkl. HMAC-SHA256-Verifikation), Limits und das Fehlerformat
ab — ausschließlich aus dieser Doku.

## Weitere Wege, wie Agenten diese Doku lesen

- **Jede Seite als Markdown** — jede Seite hat einen **Markdown kopieren**-Button und
  ein **In KI öffnen**-Menü (in ChatGPT oder Claude öffnen oder das rohe Markdown
  ansehen). Hänge `.md` an jede URL für die Rohquelle, z. B.
  [`/de/quickstart.md`](https://docs.accessful.de/de/quickstart.md).
- **`/llms.txt`** — ein maschinenlesbarer [Index aller Seiten](https://docs.accessful.de/llms.txt) nach der
  [llmstxt.org](https://llmstxt.org)-Konvention, für Agenten, die die Site crawlen.
**Tip:** Du arbeitest mit dem Agenten eines Kunden? Verweise ihn auf den Skill oder auf
`/llms.txt` — er lernt dann ohne weitere Hilfe, wie man einen Client anbindet.