api-controller-generator

What problem does it solve?

This Skill automates the creation of RESTful API controllers in ASP.NET Core projects, eliminating boilerplate and enforcing consistent patterns for versioning, routing, and authorization.

Core Features & Use Cases

• MediatR integration: Controllers dispatch commands and queries via ISender, reducing direct coupling to handlers.
• API versioning and routing: Generates controllers that follow versioned routes and consistent naming conventions for stability.
• Authorization and security: Includes role-based and permission-based access controls with attributes like Authorize and HasPermission.
• Consistent responses and DTOs: Encourages a clear separation between API layer DTOs and domain models, with standard HTTP status codes.
• Use Case: Quickly scaffold a new feature's API surface in a Clean Architecture solution, including CRUD patterns and common templates.

Quick Start

Create a new controller scaffold by targeting a feature and entity, then integrate the generated code into your ASP.NET Core API project. Ensure MediatR, API versioning, and authorization are properly configured and that the necessary policies exist.