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

0•

API 개발

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

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.

주요 기능

01Automates Mapper pattern implementation for clean data transformation layers

020 GitHub stars

03Ensures centralized validation and error handling via @Valid and GlobalExceptionHandler

04Standardizes ResponseEntity usage for precise HTTP status code management

05Mandates integration testing using TestRestTemplate for authentic HTTP interaction

06Enforces strict DTO-Entity separation to prevent domain leakage

사용 사례

01Designing robust integration test suites for backend services

02Refactoring legacy API endpoints to follow clean architecture and DTO patterns

03Building production-grade Java Spring Boot REST controllers from scratch

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ryu-qqq/marketplace rest-api-expert

For use in Claude.ai and ChatGPT

Download Skill