← ClaudeAtlas

apirev-explorelisted

Answers "how do I do X with this API" from the inferred spec: finds the operation or sequence of operations, shows a ready-to-run curl command and a call with the generated SDK, and says which fields and endpoints are low-confidence because they were seen in few samples. Use when the user says "how do I create an order with this API", "which endpoint lists users", "what does this endpoint return", "show me a curl for", "what parameters does X take", "how do I paginate this", or "can this API do Y".
vivekbhange-hub/api-reverse-skill · ★ 0 · API & Backend · score 75
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