api-to-fastapi-scaffold

Provide the API specification document and this Skill parses each endpoint's HTTP method, path, parameters, and response format, then generates Router, Service, and Repository files. The output follows a three-layer architecture with TODO markers where business logic must be added manually.

It produces three files per module: a Router with endpoint definitions and dependency injection, a Service class containing business logic skeletons with TODO markers, and a Repository class extending BaseRepository with custom query methods derived from the spec's filter conditions.

Yes. Besides spec documents, the Skill accepts verbal descriptions such as "generate a user management CRUD API" or existing router code that needs additional endpoints. It infers standard REST conventions for list, get, create, update, and delete operations.

Yes. List endpoints use PageParams and PageResponse for pagination, and special endpoint types like batch operations, export via StreamingResponse, file uploads, and status-change endpoints are handled with dedicated generation strategies.

The generated Service layer contains only skeleton logic with TODO markers; business validation, delete-time relationship checks, and state machine rules must be implemented manually. You also need to register the router in main.py and write integration tests separately.