fastapi-expert-extras

What problem does it solve?

This Skill eliminates two common development pain points: incorrect OpenAPI specifications generated from incomplete project briefs that mismatch actual API implementation, and tight coupling between modules built in parallel that breaks build order independence and slows development.

Core Features & Use Cases

• Mandatory Source Route Inventory: Enumerates all actual framework routes directly from source code before drafting any OpenAPI spec lines, eliminating mismatches between briefs and running applications.
• Protocol-Based Structural Typing: Defines consumer-side Protocols for shared data structures to decouple parallel module development, removing import dependencies and enabling synthetic test fixtures.
• Use Case: When documenting an existing FastAPI API, use this Skill to first catalog all real routes to avoid missing or misdocumenting endpoints. When building two interdependent modules in parallel, use the Protocol pattern to avoid coupling build order and speed up integration.

Quick Start

Use the fastapi-expert-extras skill to document the existing FastAPI API in your current project by first building a complete route inventory from the source code before drafting any OpenAPI specification lines.