verify-api-shape

Installation
SKILL.md

Verify API shape

A green test suite proves nothing about an external API when the fixtures were hand-written. Fabricated fixtures encode a contract the API does not implement, so every guard passes in CI and the path refuses (or misbehaves) in production forever.

Real case: 278 passing tests, a reviewed and merged feature, and the code path could never succeed. It read three field names the API does not send.

When to run this

  • Code reads named fields off an external API response.
  • A path "works" in tests but is reported as always refusing or never firing.
  • Before marking any task done that consumes an external record.
  • A plan or PR asserts "the API returns X".

Procedure

1. Capture a real response first

Run a read-only GET against a non-production environment. Never reason from the fixture, the Swagger, or memory. If the endpoint has no documented response schema, that is itself a finding to report.

Installs
10
Repository
anis-dr/skills
GitHub Stars
4
First Seen
Sep 26, 2026