skills.rest
VelkaressiaBlutkrone
VelkaressiaBlutkroneCOMMUNITY
Explore all skills by this author →
GitHub

gen-api-controller

Generates Spring Boot REST API controllers following project conventions.

Updated Feb 26, 2026
Search Tags:#code generation#backend#conventions#java#rest api#controller#spring boot
One-click install
npx skills add https://github.com/VelkaressiaBlutkrone/spring-python-llm-exam-mng --skill gen-api-controller-velkaressiablutkrone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gen-api-controller
Source: https://github.com/VelkaressiaBlutkrone/spring-python-llm-exam-mng/tree/main/.claude/skills/gen-api-controller
Command: npx skills add https://github.com/VelkaressiaBlutkrone/spring-python-llm-exam-mng --skill gen-api-controller-velkaressiablutkrone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing Spring Boot REST API controllers by hand requires remembering project-specific conventions like annotation ordering, the /api path prefix, and the Resp wrapper response format. This Skill collects requirements through a short interview and generates a compliant @RestController class automatically. ## Core Features & Use Cases - Convention-Enforced Generation: Produces controllers that follow the common-rule.md conventions, including @RequiredArgsConstructor before @RestController, /api-prefixed endpoints, and Resp.ok()/Resp.fail() response wrapping. - Guided Interview: Asks one question at a time to collect the target domain, required endpoints (list, create, update, delete, duplicate check), and session-based authentication needs. - Use Case: When building a new Board feature, ask for an API controller and receive a complete BoardApiController.java with CRUD endpoints wired to BoardService, placed in the correct package directory. ## Quick Start Ask the assistant to create a REST API controller for your domain, for example by saying "API 컨트롤러 만들어줘" or typing /gen-api-controller.

Frequently Asked Questions about gen-api-controller

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Spring Boot REST API controller?▼

Trigger the skill by typing /gen-api-controller or asking for an API controller in Korean. It interviews you for the target domain, required endpoints, and authentication needs, then generates a complete @RestController class following project conventions.

What conventions does the generated Spring controller follow?▼

Generated controllers place @RequiredArgsConstructor before @RestController, prefix all endpoints with /api, and wrap every response in Resp.ok() or Resp.fail() instead of returning raw objects. SSR page routing is handled separately by a different skill.

Can the generated controller handle session-based authentication?▼

Yes, the interview asks whether any endpoints need session checks. When required, the generated code injects HttpSession and retrieves the sessionUser attribute before calling service methods, as shown in the save endpoint example.

What happens if the Service class does not exist yet?▼

The skill requires the Service layer to exist before generating the controller. If the Service is missing, it notifies the user instead of generating code that references nonexistent methods.

When should I not use this controller generator?▼

Do not use it for SSR page routing controllers, which belong to the separate gen-controller skill. It is also unsuitable if your project does not use the Resp wrapper convention or Lombok's @RequiredArgsConstructor.

Related Skills

Explore More Software Engineering Skills→
samrocks03samrocks03

rails-service

Encapsulate Rails business logic in module-namespaced service classes.

Community
Advanced
stars-endstars-end

context-api-contracts

Analyze frontend-backend API contracts, routes, and type definitions.

Official
Basic
zdanovichnickzdanovichnick
4

aspnet-api-patterns

Define ASP.NET Core API patterns for controllers, minimal APIs, middleware, and JWT authentication.

Community
Basic
Marwan78888Marwan78888
16

spring-boot-engineer

Generate Spring Boot 3.x backend scaffolds with REST controllers, security, and WebFlux.

Community
Advanced