apirev-explorelisted
Install: claude install-skill vivekbhange-hub/api-reverse-skill
# apirev-explore: ask the spec, get a working call
Once a spec exists, most questions are lookups: which endpoint, which fields, what comes back.
This skill answers them from `api/openapi.json` and the inference report, with a command the
user can paste, and with the honesty the report demands about what was actually observed.
## Inputs
- A question in plain words.
- `api/openapi.json`, `api/inference-report.md`, and if present `api/README.md` and
`api/sdk/`.
- Commands below say `python3`; on Windows use `python` (or `py -3`).
## Outputs
- An answer in the conversation. Nothing is written unless the user asks to save it (then
append it to `api/README.md` under "Recipes").
## Steps
1. **List the operations compactly** instead of reading the whole spec:
```
python3 - <<'EOF'
import json; s = json.load(open("api/openapi.json", encoding="utf-8"))
for path, item in sorted(s["paths"].items()):
for m, op in sorted(item.items()):
print(m.upper(), path, op.get("operationId"), op.get("x-apirev-samples"), op.get("summary", ""))
EOF
```
2. **Match the question to operations.** Look at the path words, operationIds, tags,
summaries, and the property names of request and response schemas (for "where is the
adoption status?" search the schemas for `status`). Multi-step tasks become a sequence:
log in -> list -> pick an id -> update.
3. **Read only the matching operations** from the spec (`s["paths"][path][method]`) and the
matchin