Skills
.Work. You
Rest

web-layer

Official

Enforce robust web-layer patterns in controllers.

Software Engineering#validation#spring#controller-patterns#dto-conversion#web-layer#openapi-annotations#baseresponse
AuthorGreenFirst-kr
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill guides teams to implement or review the web-layer (controller) code with a consistent, well-scoped approach, enforcing patterns such as direct OpenAPI annotations and standardized response handling.

Core Features & Use Cases

  • Direct OpenAPI annotations on controller methods, explicit naming conventions (GetXxxController, CreateXxxController, UpdateXxxController), and no API spec interfaces.
  • DTO conversion via static from() methods in response classes to keep conversion out of controllers.
  • Validation with Bean Validation (@Valid) and clear separation between controller, service, and domain layers to improve maintainability.
  • Avoidance of API spec directories (api/ or api/spec/) and a clear base for web-layer contracts.

Quick Start

Implement or review a new web-layer controller using GetXxxController or CreateXxxController patterns, with OpenAPI annotations on methods and responses wrapped in BaseResponse.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: web-layer
Download link: https://github.com/GreenFirst-kr/green_first_be/archive/main.zip#web-layer

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.