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.