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 Quarkus REST (Jakarta REST) — including resource classes, HTTP methods, status codes, request/response DTOs, Bean Validation, exception mappers, optional runtime OpenAPI exposure (SmallRye), contract-first generation from OpenAPI, content negotiation, pagination, sorting and filtering, API versioning, idempotency (Idempotency-Key), optimistic concurrency (ETag / If-Match), HTTP caching (Cache-Control), API deprecation (Sunset / Depre
.claude/skills/jabrena-402-frameworks-quarkus-rest/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-03 | ✗→✓ | ▲ Improved | -15% | 0% |
| case-01 | ✓→✗ | ▼ Worse | -73% | 0% |
| case-02 | ✓→✗ | ▼ Worse | -78% | 0% |
| case-18 | ✓→✓ | ＝ Same ✓ | -7% | 0% |
| case-04 | ✓→✓ | ＝ Same ✓ | -16% | 0% |
Apply REST API design principles on Quarkus using Jakarta REST (JAX-RS).
What is covered in this Skill?
/openapi via SmallRye; API-first contract maintained in openapi.yaml (codegen)Scope: Apply recommendations based on the reference rules and good/bad code examples.
Before applying REST changes, ensure the project compiles. After applying improvements, run full verification.
./mvnw compile or mvn compile before applying any change./mvnw clean verify or mvn clean verify after applying improvementsRead references/402-frameworks-quarkus-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/402-frameworks-quarkus-rest.md.
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-18 | pass→pass | 11,695 | 10,036 | -14% | 1 | 1 | 0% | 2,098 | 1,956 | -7% | 0 | 0 | — |
case-01 | pass→fail | 16,865 | 5,187 | -69% | 1 | 1 | 0% | 3,260 | 881 | -73% | 0 | 0 | — |
case-02 | pass→fail | 21,229 | 5,819 | -73% | 1 | 1 | 0% | 4,249 | 931 | -78% | 0 | 0 | — |
case-03 | fail→pass | 15,020 | 8,748 | -42% | 1 | 1 | 0% | 2,756 | 2,348 | -15% | 0 | 0 | — |
case-04 | pass→pass | 12,599 | 6,871 | -45% | 1 | 1 | 0% | 2,281 | 1,920 | -16% | 0 | 0 | — |
case-05 | pass→pass | 22,673 | 20,269 | -11% | 1 | 1 | 0% | 3,951 | 4,494 | +14% | 0 | 0 | — |
case-06 | pass→pass | 9,556 | 6,846 | -28% | 1 | 1 | 0% | 1,593 | 1,863 | +17% | 0 | 0 | — |
case-07 | pass→pass | 15,250 | 10,850 | -29% | 1 | 1 | 0% | 2,726 | 2,502 | -8% | 0 | 0 | — |
case-08 | pass→pass | 16,701 | 12,492 | -25% | 1 | 1 | 0% | 2,567 | 2,580 | +1% | 0 | 0 | — |
case-09 | pass→pass | 9,432 | 4,559 | -52% | 1 | 1 | 0% | 1,592 | 1,356 | -15% | 0 | 0 | — |
case-10 | pass→pass | 12,817 | 7,912 | -38% | 1 | 1 | 0% | 2,248 | 2,097 | -7% | 0 | 0 | — |
case-11 | pass→pass | 16,425 | 12,942 | -21% | 1 | 1 | 0% | 2,890 | 2,769 | -4% | 0 | 0 | — |
case-12 | pass→pass | 7,302 | 4,138 | -43% | 1 | 1 | 0% | 1,255 | 1,310 | +4% | 0 | 0 | — |
case-13 | pass→pass | 16,478 | 10,777 | -35% | 1 | 1 | 0% | 2,982 | 2,602 | -13% | 0 | 0 | — |
case-14 | pass→pass | 15,678 | 13,186 | -16% | 1 | 1 | 0% | 2,534 | 2,819 | +11% | 0 | 0 | — |
case-15 | pass→pass | 16,888 | 16,589 | -2% | 1 | 1 | 0% | 2,786 | 3,394 | +22% | 0 | 0 | — |
case-16 | pass→pass | 6,136 | 6,156 | +0% | 1 | 1 | 0% | 1,170 | 1,776 | +52% | 0 | 0 | — |
case-17 | pass→pass | 15,888 | 7,150 | -55% | 1 | 1 | 0% | 2,829 | 1,885 | -33% | 0 | 0 | — |
case-19 | pass→pass | 12,978 | 5,259 | -59% | 1 | 1 | 0% | 2,063 | 1,464 | -29% | 0 | 0 | — |
case-20 | pass→pass | 16,293 | 20,384 | +25% | 1 | 1 | 0% | 2,769 | 4,180 | +51% | 0 | 0 | — |
case-21 | pass→pass | 10,103 | 8,468 | -16% | 1 | 1 | 0% | 1,812 | 2,110 | +16% | 0 | 0 | — |
case-22 | pass→pass | 12,612 | 9,356 | -26% | 1 | 1 | 0% | 2,260 | 2,316 | +2% | 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. 22 cases were attempted, and 20 counted toward the lift figure. The other 2 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 -5 percentage points is the difference between those two pass rates over the 20 comparable cases. 2 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.