skills.rest
cdalsoniii
cdalsoniiiCOMMUNITY
Explore all skills by this author →
GitHub

OpenAPI Drift Detection

Your AI-powered home assistant is ready.

Updated Feb 13, 2026
Search Tags:#documentation#api#openapi#drift detection#code sync#swagger
One-click install
npx skills add https://github.com/cdalsoniii/brightpath-coder --skill openapi-drift-detection
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
thktthkt
11

documenting-apis

Generate Markdown API specs and OpenAPI/Swagger files from codebase analysis.

Community
Advanced
RaNDoM6913RaNDoM6913
1

api-contract-sync

Detect drift between OpenAPI specs and registered API routes.

Community
Advanced
Logos-LiberLogos-Liber
17

api-documentation

Document RESTful and GraphQL APIs with OpenAPI specifications and interactive tools.

Official
Intermediate
shafibabarshafibabar
1

python-openapi-codegen

Validate FastAPI implementations against hand-authored OpenAPI contracts.

Community
Advanced