qa-api-contract-curator
Installation
SKILL.md
QA API Contract Curator
Purpose
Manage and formalize API contracts. Detect breaking changes, generate OpenAPI (OAS) specifications, and produce versioning rules. Transform disparate API information into a single, validated, version-controlled contract.
Input Sources
| Source | Description | How to Use |
|---|---|---|
| Existing endpoints | Live API or network traffic capture | Capture requests/responses via HAR, Postman, browser DevTools; infer schema from payloads |
| Swagger/OpenAPI JSON/YAML | Existing spec files | Parse, validate, normalize to OpenAPI 3.x, fill gaps |
| Developer interviews/descriptions | Natural language API descriptions | Extract endpoints, methods, parameters, responses; formalize into OAS |
| Codebase analysis | Express routes, FastAPI endpoints, Spring controllers, etc. | Scan route definitions, decorators, DTOs; derive contract from implementation |