What problem does it solve? API design flaws like inconsistent naming, wrong HTTP methods, missing pagination, or weak auth models are cheap to fix on paper but expensive once coded and shipped. This Skill reviews a proposed API contract before any implementation begins, catching contract issues at the design phase. ## Core Features & Use Cases - Ten-point contract audit: Checks naming and path consistency, HTTP method correctness, request/response shape quality, error contract, auth and authorization model, pagination, idempotency, versioning, and alignment with existing endpoints. - Grounded alignment check: Reads existing route files and controllers so consistency findings are based on real code, not assumptions. - Ungrounded-claim marking: External API or vendor behaviors that lack captured references are explicitly marked as unproven rather than asserted as fact. - Use Case: Before building a new set of REST endpoints described in an implementation plan, run this review to get per-endpoint findings and a clear verdict: ready to implement, needs revision, or has blocking issues. ## Quick Start Review the API contract defined in my IMPLEMENTATION_PLAN.md for naming, methods, errors, auth, and pagination before I start coding.
