neopjm109/agent.oliver/api-generator

Claude Code and agent skill by neopjm109/agent.oliver

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Generate the runtime API layer (Controller, Request/Response DTO, mapping, routing) for a Spring Boot feature from business requirements.

Install

npx vskill@latest install neopjm109/agent.oliver/api-generator

SKILL.md

The same SKILL.md was published earlier as neopjm109/agent.oliver/api-generator.

Goal

Generate production-ready Spring Boot REST API code for one feature: Controller, Request DTO, Response DTO, validation, and route mapping. This produces runtime code — distinct from api-spec-generator (blueprint), which produces the design-time OpenAPI spec. For overlap resolution see INVENTORY.md.

Inputs

yaml
feature_requirements:
feature: user-management
endpoints:
- method: POST
path: /api/users
description: create a user
domain_model:
entities: [User]

Output

yaml
api_layer_code:
- UserController.java
- CreateUserRequest.java
- UserResponse.java

Workflow

Step 1 — Map endpoints

Derive controller methods, HTTP verbs, paths, and status codes from requirements.

Step 2 — Design DTOs

Define Request DTOs (with Bean Validation) and Response DTOs; never expose entities directly.

Step 3 — Delegate implementation

Delegate actual code writing to spring-senior-programmer with the mapped endpoints + DTO contracts.

Step 4 — Wire routing

Ensure paths, versioning, and error mapping follow project conventions.

Rules

  • Never expose JPA entities in the API; always use DTOs.
  • Request DTOs must carry Bean Validation annotations.
  • Controllers stay thin: no business logic (delegate to service layer).
  • Consistent base path (/api) and RESTful resource naming.
  • Do not generate the OpenAPI/design spec — that is api-spec-generator's job.

Examples

Input:

yaml
endpoints: [{ method: POST, path: /api/users, description: create a user }]

Output (abridged):

java
@RestController
@RequestMapping("/api/users")
@RequiredArgsConstructor
public class UserController {
private final UserService userService;
@PostMapping
@ResponseStatus(HttpStatus.CREATED)
public UserResponse create(@Valid @RequestBody CreateUserRequest request) {
return userService.create(request);
}
}

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/neopjm109/agent.oliver/api-generator/badge)](https://verified-skill.com/skills/neopjm109/agent.oliver/api-generator)

Something wrong with this skill or its page? Tell us.