api-documentation

What problem does it solve? API documentation frequently drifts out of sync with actual code as endpoints are added or modified, leaving consumers with stale or missing specs. This Skill monitors API-related file changes and pauses work until Swagger/OpenAPI documentation matches the code. ## Core Features & Use Cases - Drift Detection: Compares endpoints found in route, controller, and handler files against paths defined in openapi.yaml or swagger.json. - Pause-and-Audit Workflow: When drift is detected, work pauses and the documentation-audit skill is invoked to resynchronize documentation. - Documentation Standards: Enforces required OpenAPI fields including summaries, request/response schemas, examples, and security definitions, with validation via swagger-cli. - Use Case: A developer adds a new POST endpoint to an Express routes file; the Skill detects the change, finds it missing from openapi.yaml, pauses the workflow, and triggers a documentation update before work resumes. ## Quick Start Check whether my recent API route changes are reflected in the OpenAPI documentation and update it if anything is missing.