OpenAPI Drift Detection

Your AI-powered home assistant is ready.

Updated Feb 13, 2026

Search Tags:#documentation #api #openapi #drift detection #code sync #swagger

Ready to run

npx skills add https://github.com/cdalsoniii/brightpath-coder --skill openapi-drift-detection

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: OpenAPI Drift Detection
Source: https://github.com/cdalsoniii/brightpath-coder/tree/main/.cursor/skills/openapi-drift-detection
Command: npx skills add https://github.com/cdalsoniii/brightpath-coder --skill openapi-drift-detection

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about OpenAPI Drift Detection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I detect discrepancies between my API code and OpenAPI specification?▼

OpenAPI drift detection works by analyzing code for registered routes and comparing them against documented endpoints to flag missing routes, stale specifications, and schema mismatches.

How do I find undocumented endpoints in my API code?▼

To find undocumented endpoints, analyze your API handler implementations to identify routes present in your code but missing from your OpenAPI or Swagger specification.

Why does my Swagger UI point to removed API routes?▼

Swagger UI points to removed routes because the OpenAPI specification is stale, containing endpoint definitions that no longer match your actual API handler implementations.

Can I validate request and response schemas against my OpenAPI spec?▼

Yes, you can validate request and response schemas by comparing your code's Data Transfer Objects against the schemas defined in your OpenAPI specification to detect mismatches.

Does API drift detection check authentication documentation for secured endpoints?▼

Yes, API drift detection validates authentication documentation by analyzing secured endpoints to ensure your OpenAPI specification accurately reflects the security implemented in your code.