Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Quarkus REST API Guidelines · jabrena | DecimalAI

codingby jabrena

Quarkus REST API Guidelines

jabrena/402-frameworks-quarkus-rest

Source jabrena/plinth ↗License Apache-2.0

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

NewMaintained

Automatic

Coding pack

Last verified 8/20/2026

What it changes

Passed 18 of 20 test cases with the skill, and 19 of 20 without it.

Without skill95%

With skill91%

Checks it passed that the model alone missed

Formats JSON error payloads following RFC 7807 Problem Details.

1 fixed19 passed either way0 still failing2 broke

Pass-rate lift: -5 pp
Tokens: +1%
Agent turns: 0%
Response time: -25%

Model gemini-3.6-flashMeasured 8/20/2026v120 of 22 cases passed with skill · 20 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/jabrena-402-frameworks-quarkus-rest/SKILL.md https://app.decimal.ai/s/jabrena-402-frameworks-quarkus-rest/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add jabrena-402-frameworks-quarkus-rest, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/jabrena-402-frameworks-quarkus-rest/ and pins it in .decimal/skills.lock

decimalai skills add jabrena-402-frameworks-quarkus-rest

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/jabrena-402-frameworks-quarkus-rest/SKILL.md https://app.decimal.ai/s/jabrena-402-frameworks-quarkus-rest/SKILL.md

Raw file: /s/jabrena-402-frameworks-quarkus-rest/SKILL.md ↗ · machine-readable summary at /s/jabrena-402-frameworks-quarkus-rest.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

A test case the skill fixed. Same model, same prompt, with and without the skill.

Prompt

We want consistent JSON error responses across our Quarkus JAX-RS endpoints when exceptions occur, rather than raw stacktraces or arbitrary custom JSON maps. How should exception handling be structured?

What was checked, without and with the skill
Checked	Without skill	With skill
Uses ExceptionMapper to handle JAX-RS exceptions.	Passed	Passed
Formats JSON error payloads following RFC 7807 Problem Details.	Missed	Passed

case-03 · gemini-3.6-flash · 8/20/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md62 lines2 files

Quarkus REST API Guidelines

Apply REST API design principles on Quarkus using Jakarta REST (JAX-RS).

What is covered in this Skill?

Resource classes, @Path, HTTP method mapping, and resource URI design
Status codes, Location headers, and Response building
DTOs and Bean Validation at the boundary; ISO-8601 for date/time fields
ExceptionMapper for consistent error JSON (RFC 7807 Problem Details)
API versioning strategies (URI path, Accept header)
Idempotency with Idempotency-Key header
Optimistic concurrency: ETag, If-Match, If-None-Match
HTTP caching with Cache-Control headers
API deprecation: Sunset and Deprecation headers
Pagination, sorting, and filtering query parameters
Optional /openapi via SmallRye; API-first contract maintained in openapi.yaml (codegen)
Reactive vs blocking considerations; @RunOnVirtualThread
Security integration at the filter layer

Scope: Apply recommendations based on the reference rules and good/bad code examples.

Constraints

Before applying REST changes, ensure the project compiles. After applying improvements, run full verification.

MANDATORY: Run ./mvnw compile or mvn compile before applying any change
PREREQUISITE: Project must compile before applying REST API improvements
SAFETY: If compilation fails, stop immediately
BLOCKING CONDITION: Compilation errors must be resolved by the user before proceeding
VERIFY: Run ./mvnw clean verify or mvn clean verify after applying improvements
BEFORE APPLYING: Read the reference for detailed rules and examples

When to use this skill

Review or improve JAX-RS resources in a Quarkus project
Design HTTP APIs with validation and error handling on Quarkus
Add API versioning, idempotency, ETag concurrency, or deprecation headers
Implement pagination, sorting, or RFC 7807 Problem Details error responses
Improve Quarkus REST resources and exception mappers

Track record

Benchmark

18 / 20

test cases passed, vs 19 / 20 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

jabrena / plinth

skills/402-frameworks-quarkus-rest/SKILL.md

View on GitHub ↗

License Apache-2.0Imported 10/2/2026Version v1Bundled 1 file

Other skills for the same job

Published skills whose descriptions closely match this one, with their headline benchmark lift.

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Quarkus REST API Guidelines

Constraints

When to use this skill

Track record

Benchmark

Adoption

SkillSafety

Source

Other skills for the same job

Related skills