# Agent Skill

> 让编码智能体开箱即用地掌握 Kerox API 接入规范。

## 安装

在使用编码智能体的项目目录中运行：

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

安装包包含 [SKILL.md](/.well-known/skills/kerox/SKILL.md) 和 [MCP 配置模板](/.well-known/skills/kerox/mcp.json)。也可以手动将两个文件都放到客户端技能目录下的 `kerox/` 中。

将 Kerox API Key 放在 `KEROX_API_KEY` 环境变量中。如需让智能体直接调用 Kerox，请按 [MCP 配置指南](/docs/mcp) 配置服务器。使用 REST API 接入时，Skill 也可以根据文档指导实现。

## Skill 包含的内容

Kerox Agent Skill 遵循开放的 `SKILL.md` 规范，帮助 Claude Code、Codex、Cursor 等编码智能体自动完成：

- 通过 `GET /v1/models/{id}` 或 `/models/<id>/llms.txt` 读取实时参数 schema，避免猜测字段名。
- 提交前先用 `POST /v1/estimate` 预估费用。
- 正确使用 `Idempotency-Key`、`wait_seconds` / 轮询以及 Standard Webhooks 的 HMAC-SHA256 签名校验。
- 依据 `error.code` 与任务失败码做结构化错误处理。

## 立即配合 Markdown 文档使用

你现在就可以把以下机器可读入口直接提供给编码智能体：

- 站点索引：`https://kerox.ai/llms.txt`
- 全量文档：`https://kerox.ai/llms-full.txt`
- OpenAPI 3.1 规范：`https://api.kerox.ai/openapi.json`
