# coa-db-skill

An agent skill for looking up **Conquest of Ascension (CoA)** WoW items,
spells, NPCs, and quests on [db.exil.es](https://db.exil.es) — the CoA Guild
"Exiles" database — via its public JSON API.

Works for Claude Code and the Sub-Net Sub-Bots. No credentials required; the
db.exil.es API is public and read-only.

## What's here

- `skills/coa-db-skill/SKILL.md` — the skill (curl-based; API reference + workflow).
- `bin/coa-db` — optional bash helper (`coa-db search "…"`, `coa-db item <id>`, …).

## Install

### Claude Code

Symlink (or copy) the skill into your skills dir:

```bash
ln -s "$(pwd)/skills/coa-db-skill" ~/.claude/skills/coa-db-skill
```

Optionally put the helper on your PATH:

```bash
ln -s "$(pwd)/bin/coa-db" ~/.local/bin/coa-db
```

### Sub-Bots

Drop `skills/coa-db-skill/` into the bot's skills directory (the same place
the other `*/SKILL.md` skills live), or vendor this repo and point the loader
at it. The skill only needs `curl` (and `jq`/`python3` for pretty output).

## Quick use

```bash
curl -s 'https://db.exil.es/api/v1/search?q=Neurotoxin%20Edge'
curl -s 'https://db.exil.es/api/v1/items/312518'
# or, with the helper:
coa-db search "Neurotoxin Edge"
coa-db item 312518
```

API base `https://db.exil.es/api/v1`; OpenAPI at
`https://db.exil.es/api/openapi.json`. See `skills/coa-db-skill/SKILL.md` for
the full endpoint reference.