api-contract-sync

Detect drift between OpenAPI specs and registered API routes.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/RaNDoM6913/claude-code-superkit --skill api-contract-sync-random6913
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-contract-sync
Source: https://github.com/RaNDoM6913/claude-code-superkit/tree/main/packages/codex/skills/api-contract-sync
Command: npx skills add https://github.com/RaNDoM6913/claude-code-superkit --skill api-contract-sync-random6913

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Verify OpenAPI/Swagger specs match registered routes and handler implementations.

Core Features & Use Cases

  • Cross-checks API specs against route registrations.
  • Detects undocumented routes and stale documentation.
  • Produces a structured report highlighting mismatches and suggested fixes.

Quick Start

Run after updating APIs to validate alignment and generate a drift report.

Frequently Asked Questions about api-contract-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my OpenAPI spec matches my actual route registrations?

API specification drift occurs when your OpenAPI or Swagger spec diverges from actual route registrations and handler implementations, leading to undocumented endpoints, stale documentation, and DTO inconsistencies.

How do I detect undocumented API routes and stale Swagger documentation?

You detect undocumented API routes by enforcing cross-reference checks between your API specs and route files, which identifies mismatches and generates a structured report highlighting stale documentation.

What is the best way to verify DTO consistency against an OpenAPI specification?

The best way to verify DTO consistency is to apply cross-reference checks to your DTOs and API specs, enforcing validation that flags mismatches between data transfer objects and documented endpoints.

Does API drift detection work across common software stacks?

Yes, API drift detection applies to changes in route files, API specs, handlers, and DTOs across common stacks, validating alignment and reporting stale endpoints regardless of the specific framework.

When should I run an API spec validation to catch implementation drift?

You should run API spec validation after updating APIs to validate alignment, catching implementation drift early by verifying that route files, handlers, and DTOs match the OpenAPI or Swagger specifications.