Why does this skill prohibit the use of MockMvc?

This skill prioritizes TestRestTemplate to ensure integration tests run against a real server environment, providing more reliable validation of the API's network behavior compared to MockMvc.

Does this skill help with error handling?

Yes, it mandates the implementation of a GlobalExceptionHandler and the use of ErrorCode Enums instead of raw strings for consistent error responses.

How do I trigger the REST API expert functionality?

The skill automatically activates on triggers like 'controller', 'api', or 'dto', and can be manually invoked using the /kb-rest-api command.

Can I return domain entities directly to the client?

No, this skill strictly enforces the use of dedicated Request/Response DTOs and Mappers to prevent domain model exposure and ensure API stability.

REST API Expert

Name: REST API Expert
Author: ryu-qqq

byryu-qqq

API Development

Enforces strict RESTful API design principles, DTO patterns, and robust integration testing using TestRestTemplate.

About

The REST API Expert skill transforms Claude into a specialized backend architect focused on high-quality Java Spring Boot development. It enforces a zero-tolerance policy for common architectural smells by mandating the separation of DTOs from domain entities, requiring @Valid-based input validation, and standardizing global exception handling. Unlike standard tools, it specifically promotes TestRestTemplate for realistic integration testing over MockMvc, ensuring that your API layer is production-ready, well-documented, and decoupled from business logic.

Key Features

Automates Mapper pattern implementation for clean data transformation layers
0 GitHub stars
Ensures centralized validation and error handling via @Valid and GlobalExceptionHandler
Standardizes ResponseEntity usage for precise HTTP status code management
Mandates integration testing using TestRestTemplate for authentic HTTP interaction
Enforces strict DTO-Entity separation to prevent domain leakage

Use Cases

Designing robust integration test suites for backend services
Refactoring legacy API endpoints to follow clean architecture and DTO patterns
Building production-grade Java Spring Boot REST controllers from scratch

About

Key Features

Automates Mapper pattern implementation for clean data transformation layers
0 GitHub stars
Ensures centralized validation and error handling via @Valid and GlobalExceptionHandler
Standardizes ResponseEntity usage for precise HTTP status code management
Mandates integration testing using TestRestTemplate for authentic HTTP interaction
Enforces strict DTO-Entity separation to prevent domain leakage

Use Cases

Designing robust integration test suites for backend services
Refactoring legacy API endpoints to follow clean architecture and DTO patterns
Building production-grade Java Spring Boot REST controllers from scratch