# Agent Skill

> Give coding agents concise, accurate instructions for integrating the Kerox API.

## Install

Run this command in the project where you use your coding agent:

```sh
npx skills add https://kerox.ai --skill kerox
```

The package includes [SKILL.md](/.well-known/skills/kerox/SKILL.md) and an [MCP configuration template](/.well-known/skills/kerox/mcp.json). For manual installation, save both files under `kerox/` in your client's skills directory.

Put your Kerox key in the `KEROX_API_KEY` environment variable. To let your agent call Kerox directly, configure the server using the [MCP setup guide](/docs/mcp). The Skill can also guide REST integration from the documentation.

## What the Kerox Skill includes

The Kerox Agent Skill follows the open `SKILL.md` convention so coding agents (Claude Code, Codex, Cursor, and compatible tools) know how to:

- Query live model schemas via `GET /v1/models/{id}` or `/models/<id>/llms.txt` instead of guessing parameter names.
- Estimate costs via `POST /v1/estimate` before submitting tasks.
- Submit tasks with `Idempotency-Key`, handle `wait_seconds` vs. polling, and verify Standard Webhooks HMAC-SHA256 signatures.
- Map every `error.code` and task failure code cleanly without relying on fragile message matching.

## Working with Markdown docs today

You can feed your agent the full Markdown documentation right now:

- Index: `https://kerox.ai/llms.txt`
- Full reference: `https://kerox.ai/llms-full.txt`
- OpenAPI 3.1 schema: `https://api.kerox.ai/openapi.json`
