What problem does it solve? Frontend and backend teams often drift out of sync on API field names, types, and error codes, causing integration bugs discovered only during joint debugging. This Skill manages the full API contract lifecycle—definition, type synchronization, mock generation, and consistency validation—so both sides always work from the same OpenAPI source of truth. ## Core Features & Use Cases - OpenAPI Definition Generation: Extracts OpenAPI definitions from FastAPI routes and produces a structured openapi.yaml design document with complete parameters, request bodies, responses, and error codes. - Frontend Type Synchronization: Uses openapi-typescript to generate TypeScript types into src/types/api/, which the frontend Service layer references directly without manual edits. - Mock Data & Contract Validation: Generates faker.js-based mock data with MSW handler configurations, and validates contract consistency in CI on both backend (schema validator) and frontend (type freshness checks). - Use Case: After a backend developer modifies a FastAPI endpoint, run this Skill to regenerate the OpenAPI contract, then have the frontend pull updated TS types and MSW mocks so integration testing starts immediately against the new contract. ## Quick Start Generate the OpenAPI contract from the backend FastAPI routes and sync the frontend TypeScript types and MSW mock handlers.
