How does it handle API versioning?

It compares two versions of an API spec to identify breaking changes like removed fields or renamed endpoints, and can generate migration guides for your team.

Do I need to install external packages to use this?

Basic validation and matching work natively. For advanced linting or diffing, it may suggest using industry-standard tools like Spectral or GraphQL Inspector.

Can it detect if I forgot to implement a documented endpoint?

Yes, it searches your codebase for route handlers in frameworks like Express, FastAPI, and Django to find discrepancies between your documentation and implementation.

Does it support automated code generation?

Yes, it can generate TypeScript interfaces, API client functions, and React Query or SWR hooks directly from your API specifications.

Which API formats does this skill support?

The skill supports OpenAPI 3.0/3.1 (Swagger) in YAML or JSON formats, as well as GraphQL Schema Definition Language (SDL) files.

API Contract Sync Manager

Name: API Contract Sync Manager
Author: ananddtyagi

byananddtyagi

•

619

API 개발

Synchronizes API specifications with implementations, detects breaking changes, and generates type-safe client code for frontend and backend alignment.

소개

The API Contract Sync Manager is a specialized skill for Claude Code designed to bridge the gap between API documentation and codebase reality. It automates the validation of OpenAPI and GraphQL schemas, cross-references documentation against actual endpoint implementations to find coverage gaps, and protects against regression by identifying breaking changes between versions. By facilitating the generation of TypeScript interfaces and API clients directly from specifications, it ensures that frontend and backend teams stay perfectly aligned while maintaining high standards for API versioning and documentation.

주요 기능

Generates type-safe TypeScript interfaces and API client hooks from specifications
Cross-references specs against route handlers to identify undocumented or missing endpoints
619 GitHub stars
Categorizes API modifications into breaking and non-breaking changes between versions
Produces detailed API coverage reports and migration guides for version upgrades
Validates OpenAPI and GraphQL schemas for structural correctness and standards compliance

사용 사례

Verifying that backend code changes match the documented OpenAPI specification in a pull request
Generating React Query hooks and TypeScript types automatically from a new GraphQL schema
Conducting an audit to find undocumented 'shadow APIs' within an existing codebase

소개

주요 기능

Generates type-safe TypeScript interfaces and API client hooks from specifications
Cross-references specs against route handlers to identify undocumented or missing endpoints
619 GitHub stars
Categorizes API modifications into breaking and non-breaking changes between versions
Produces detailed API coverage reports and migration guides for version upgrades
Validates OpenAPI and GraphQL schemas for structural correctness and standards compliance

사용 사례

Verifying that backend code changes match the documented OpenAPI specification in a pull request
Generating React Query hooks and TypeScript types automatically from a new GraphQL schema
Conducting an audit to find undocumented 'shadow APIs' within an existing codebase