Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Use when you need to design, review, or improve REST APIs with Micronaut — including @Controller routes, HTTP status codes, DTOs, Bean Validation, exception handlers, pagination, idempotency, ETag/If-Match, caching headers, versioning, contract-first OpenAPI (OpenAPI Generator), optional runtime OpenAPI via micronaut-openapi, and security annotations. This should trigger for requests such as Review or improve Micronaut @Controller REST APIs; Add validation, error handling, or align controllers w
.claude/skills/jabrena-502-frameworks-micronaut-rest/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-18 | ✗→✓ | ▲ Improved | 0% | 0% |
| case-03 | ✓→✗ | ▼ Worse | -72% | 0% |
| case-04 | ✓→✗ | ▼ Worse | -55% | 0% |
| case-05 | ✓→✗ | ▼ Worse | -65% | 0% |
| case-07 | ✓→✓ | ＝ Same ✓ | -16% | 0% |
Apply REST design principles for Micronaut HTTP applications.
What is covered in this Skill?
Scope: Apply recommendations based on the reference rules and good/bad code examples.
Compile before REST refactors; verify after.
./mvnw compile or mvn compile before applying any change./mvnw clean verify or mvn clean verify after applying improvementsRead references/502-frameworks-micronaut-rest.md and inspect the current project setup before proposing changes.
Identify requested outcomes, constraints, and the minimum safe set of changes to apply.
Implement or refactor configuration/code following the reference patterns and project conventions.
Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.
For detailed guidance, examples, and constraints, see references/502-frameworks-micronaut-rest.md.
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 3,303 | 7,103 | +115% | 1 | 1 | 0% | 365 | 1,031 | +182% | 0 | 0 | — |
case-02 | fail→fail | 19,441 | 6,068 | -69% | 1 | 1 | 0% | 4,174 | 868 | -79% | 0 | 0 | — |
case-03 | pass→fail | 15,070 | 6,128 | -59% | 1 | 1 | 0% | 3,055 | 861 | -72% | 0 | 0 | — |
case-04 | pass→fail | 21,739 | 6,846 | -69% | 1 | 1 | 0% | 4,352 | 1,961 | -55% | 0 | 0 | — |
case-05 | pass→fail | 13,285 | 8,154 | -39% | 1 | 1 | 0% | 2,489 | 875 | -65% | 0 | 0 | — |
case-06 | fail→fail | 16,306 | 4,421 | -73% | 1 | 1 | 0% | 2,875 | 860 | -70% | 0 | 0 | — |
case-07 | pass→pass | 9,382 | 5,586 | -40% | 1 | 1 | 0% | 1,845 | 1,555 | -16% | 0 | 0 | — |
case-08 | pass→pass | 13,602 | 8,150 | -40% | 1 | 1 | 0% | 2,549 | 2,082 | -18% | 0 | 0 | — |
case-09 | pass→pass | 12,815 | 5,432 | -58% | 1 | 1 | 0% | 2,255 | 1,503 | -33% | 0 | 0 | — |
case-10 | pass→pass | 4,712 | 8,301 | +76% | 1 | 1 | 0% | 826 | 1,461 | +77% | 0 | 0 | — |
case-11 | pass→pass | 6,505 | 3,707 | -43% | 1 | 1 | 0% | 1,124 | 1,185 | +5% | 0 | 0 | — |
case-12 | pass→pass | 10,387 | 8,998 | -13% | 1 | 1 | 0% | 1,728 | 1,764 | +2% | 0 | 0 | — |
case-13 | pass→pass | 16,942 | 14,269 | -16% | 1 | 1 | 0% | 3,012 | 2,943 | -2% | 0 | 0 | — |
case-14 | pass→pass | 4,161 | 3,543 | -15% | 1 | 1 | 0% | 716 | 1,163 | +62% | 0 | 0 | — |
case-15 | pass→pass | 5,904 | 4,434 | -25% | 1 | 1 | 0% | 996 | 1,316 | +32% | 0 | 0 | — |
case-16 | pass→pass | 9,751 | 8,212 | -16% | 1 | 1 | 0% | 1,778 | 2,055 | +16% | 0 | 0 | — |
case-17 | pass→pass | 6,143 | 3,997 | -35% | 1 | 1 | 0% | 884 | 1,045 | +18% | 0 | 0 | — |
case-18 | fail→pass | 5,459 | 2,026 | -63% | 1 | 1 | 0% | 819 | 822 | +0% | 0 | 0 | — |
case-19 | pass→pass | 5,197 | 2,664 | -49% | 1 | 1 | 0% | 806 | 733 | -9% | 0 | 0 | — |
case-20 | pass→pass | 9,144 | 6,374 | -30% | 1 | 1 | 0% | 1,494 | 1,417 | -5% | 0 | 0 | — |
case-21 | pass→pass | 10,450 | 5,220 | -50% | 1 | 1 | 0% | 1,526 | 1,509 | -1% | 0 | 0 | — |
case-22 | pass→pass | 17,646 | 11,619 | -34% | 1 | 1 | 0% | 2,906 | 2,641 | -9% | 0 | 0 | — |
case-23 | pass→pass | 3,512 | 2,020 | -42% | 1 | 1 | 0% | 510 | 832 | +63% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 23 cases were attempted, and 18 counted toward the lift figure. The other 5 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of -100 percentage points is the difference between those two pass rates over the 18 comparable cases. 3 cases got worse with the skill loaded, and they are included in that figure.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.