api-contract-sync-managerlisted

# API Contract Sync Manager Maintain synchronization between API specifications and their implementations, detect breaking changes, and generate client code to ensure contracts stay reliable across frontend and backend teams. ## When to Use This Skill Use this skill when: - Working with OpenAPI/Swagger specification files (`.yaml`, `.json`) - Managing GraphQL schemas (`.graphql`, `.gql`) - Reviewing API changes in pull requests - Generating TypeScript types or client code from specs - Validating that implementations match documented APIs - Detecting breaking vs. non-breaking API changes - Creating API versioning strategies - Onboarding new developers to an API-driven codebase ## Core Capabilities ### 1. Spec Validation Validate API specification files for correctness and completeness: **OpenAPI/Swagger Validation**: - Check schema syntax and structure - Validate against OpenAPI 3.0/3.1 standards - Ensure all endpoints have proper descriptions - Verify request/response schemas are complete - Check for required security definitions - Validate parameter types and constraints **GraphQL Validation**: - Parse and validate SDL (Schema Definition Language) - Check for schema stitching issues - Validate resolver coverage - Detect circular dependencies - Verify input/output type consistency **Validation Approach**: 1. Read the spec file using the Read tool 2. Parse the structure (YAML/JSON for OpenAPI, SDL for GraphQL) 3. Check for common issues: - Missing required fields