api-contract-auditor

Installation
SKILL.md

API Contract Auditing

Use this skill when

  • Reviewing OpenAPI specs vs implementation
  • Checking status/error/pagination/versioning consistency
  • Detecting breaking changes

Do not use this skill when

  • Designing new APIs (use api-contracts)
  • Code review of non-API logic

Instructions

  1. Load the spec; compare each endpoint to the implementation.
  2. Check naming, schemas, status codes, and error shapes.
  3. Verify pagination/filter/sort conventions hold everywhere.
  4. Check versioning and deprecation markers.
  5. Look for undocumented behavior and leaks (IDs, internals).
  6. Flag breaking changes with consumers in mind.
  7. Provide per-endpoint findings with spec fixes.
Installs
3
First Seen
Oct 6, 2026