Spring REST Controller Scaffold

What it does

This skill scaffolds a Spring Boot REST controller for a named entity, producing controller code, request/response DTOs, validation annotations, OpenAPI documentation annotations, and a corresponding integration test suite. It codifies common REST conventions (status codes, Location header on create, pagination on list endpoints) so the agent can produce consistent, test-backed controller scaffolds for standard Java projects.

When to use it

Invoke when the developer asks for a ready-to-run REST controller scaffold for an entity (e.g., /spring-controller User). Suitable during rapid prototyping, training demos, or when adding standard CRUD endpoints to an existing Spring project that follows conventional package/layout and build files (pom.xml/build.gradle).

What's included

• Scripts: none bundled (has_scripts=false)
• References: none bundled (has_references=false)
• Instructions: clear code templates and conventions covering endpoint signatures, DTO separation, Jakarta validation usage, OpenAPI annotations, constructor injection, and integration tests using @SpringBootTest + MockMvc. The SKILL.md provides exact endpoint behaviors and test expectations.

Compatible agents

Best for code-generation/code-assistant agents (Code models, Copilot/Claude Code/Cursor-like assistants) and any agent that can emit multi-file Java code and tests.