OpenAPI Drift Detection

What problem does it solve?

This Skill ensures your API documentation (OpenAPI/Swagger) accurately reflects your actual code implementation, preventing issues caused by outdated or missing endpoint definitions.

Core Features & Use Cases

• Detect Undocumented Endpoints: Identifies API routes present in your code but missing from your OpenAPI specification.
• Identify Stale Specs: Flags endpoints defined in your OpenAPI spec that no longer exist in your code.
• Schema Mismatch Detection: Compares request and response schemas between your code (DTOs) and the OpenAPI spec.
• Use Case: After deploying new API features, run this Skill to automatically verify that all new endpoints are correctly documented in your Swagger UI and that no existing documentation points to removed routes.

Quick Start

Use the OpenAPI Drift Detection skill to check for discrepancies between your API code and the swagger.yaml file.