Florian Berthold
2e0e8a37d1
Public, curl-based agent skill (Claude Code + Sub-Bots) over the db.exil.es JSON API (https://db.exil.es/api/v1, no auth): - skills/coa-db-skill/SKILL.md — endpoint reference + name->id->detail workflow - bin/coa-db — optional bash helper (search/item/spell/npc/quest/url)
49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
# 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.
|