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.

主要功能

01Generates type-safe TypeScript interfaces and API client hooks from specifications

02Cross-references specs against route handlers to identify undocumented or missing endpoints

03619 GitHub stars

04Categorizes API modifications into breaking and non-breaking changes between versions

05Produces detailed API coverage reports and migration guides for version upgrades

06Validates OpenAPI and GraphQL schemas for structural correctness and standards compliance

使用场景

01Verifying that backend code changes match the documented OpenAPI specification in a pull request

02Generating React Query hooks and TypeScript types automatically from a new GraphQL schema

03Conducting an audit to find undocumented 'shadow APIs' within an existing codebase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ananddtyagi/cc-marketplace api-contract-sync

For use in Claude.ai and ChatGPT

Download Skill