How does it identify breaking changes?

It performs a field-by-field comparison between two versions of a specification, flagging removals, type changes, or new required parameters that would break existing clients.

Does this skill support both REST and GraphQL?

Yes, it fully supports OpenAPI/Swagger specifications for REST APIs and Schema Definition Language (SDL) for GraphQL schemas.

Can it detect backend code that isn't documented?

Yes, it scans your backend route definitions and compares them against your specification file to identify implemented but undocumented endpoints.

What languages are supported for client code generation?

The skill currently specializes in generating TypeScript interfaces, standard API client functions, and React Query or SWR hooks.

API Contract Sync Manager

Name: API Contract Sync Manager
Author: ananddtyagi

byananddtyagi

•

548

API開発

Ensures synchronization between API specifications and code implementations while detecting breaking changes and generating type-safe clients.

概要

The API Contract Sync Manager is a comprehensive tool designed to bridge the gap between API design and backend implementation. It validates OpenAPI and GraphQL schemas against industry standards, cross-references endpoints with source code to identify documentation drift, and automatically detects breaking changes during version updates. By generating TypeScript interfaces and client hooks directly from specifications, it maintains strict type safety across the full stack and streamlines the development workflow for teams managing complex, evolving APIs.

主な機能

548 GitHub stars
Generate type-safe TypeScript interfaces and API client hooks automatically.
Produce detailed coverage reports for documented versus implemented endpoints.
Identify implementation drift by cross-referencing specs with backend source code.
Detect breaking changes between versions and generate detailed migration guides.
Validate OpenAPI, Swagger, and GraphQL schema correctness and standards compliance.

ユースケース

Reviewing API changes in pull requests to prevent breaking client-side applications.
Maintaining 1:1 parity between backend routes (Express, FastAPI, Django) and their OpenAPI specs.
Onboarding developers by generating instant type-safe clients and documentation from existing specs.

概要

主な機能

548 GitHub stars
Generate type-safe TypeScript interfaces and API client hooks automatically.
Produce detailed coverage reports for documented versus implemented endpoints.
Identify implementation drift by cross-referencing specs with backend source code.
Detect breaking changes between versions and generate detailed migration guides.
Validate OpenAPI, Swagger, and GraphQL schema correctness and standards compliance.

ユースケース

Reviewing API changes in pull requests to prevent breaking client-side applications.
Maintaining 1:1 parity between backend routes (Express, FastAPI, Django) and their OpenAPI specs.
Onboarding developers by generating instant type-safe clients and documentation from existing specs.