CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

403-frameworks-quarkus-validation

Use when you need to design, review, or improve validation in Quarkus applications — including Bean Validation on JAX-RS resources, @Valid on parameters and CDI beans, constraint groups, @ConfigMapping validation, custom constraints, nested DTO validation, and ExceptionMapper-based error mapping. This should trigger for requests such as Add validation support in Quarkus; Review Quarkus validation rules; Improve request validation in Quarkus REST APIs; Add custom validation constraints in Quarkus; Validate Quarkus @ConfigMapping properties. Part of Plinth Toolkit

71

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, appropriately brief overview that delegates detail to a single clearly-signaled reference file, with explicit compile/verify checkpoints around changes. Main gaps are mild redundancy with the description, some high-level workflow steps, and a stop-only (rather than fix-and-retry) failure path.

Suggestions

Drop or compress the 'When to use this skill' section, since its five bullets repeat trigger phrases already stated verbatim in the frontmatter description.

Tighten workflow step 2 with a concrete decision rule (e.g., which files to inspect for JAX-RS resources/@ConfigMapping, and what counts as the minimum safe change set) so it instructs rather than describes.

Replace the bare 'If compilation fails, stop immediately' with a short feedback loop (diagnose the compile error, fix, re-run compile) to reach top-tier workflow clarity.

DimensionReasoningScore

Conciseness

The body is mostly lean and directive, but "When to use this skill" duplicates the five trigger phrases already in the description, and "Scope: Apply recommendations based on the reference rules and good/bad examples" adds little — minor trimming opportunities rather than real padding, matching the 'efficient; minor instances that could be trimmed' anchor.

4 / 5

Actionability

Concrete commands are present ("Run `./mvnw compile` or `mvn compile`", "Run `./mvnw clean verify` or `mvn clean verify`") plus an explicit reference path to read, but workflow steps 2-3 remain high-level ("Identify requested outcomes, constraints, and the minimum safe set of changes", "following the reference patterns and project conventions") — mostly executable with minor gaps.

4 / 5

Workflow Clarity

A clear four-step sequence (read reference/assess context, gather scope, apply changes, run verification and report) with explicit checkpoints (MANDATORY compile before, SAFETY stop on failure, VERIFY after). It falls short of the 5 anchor because failure handling is only "stop immediately" with no fix-and-retry feedback loop.

4 / 5

Progressive Disclosure

The body is a concise overview and all detail is correctly pushed to references/403-frameworks-quarkus-validation.md (a real, one-level-deep, self-contained 296-line file with no nested .md references), which is clearly signaled both in the Constraints ("BEFORE APPLYING: Read the reference") and in a dedicated Reference section with a proper markdown link — a clear overview with well-signaled one-level-deep references.

5 / 5

Total

17

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: comprehensive and concrete on capabilities, with an explicit and well-phrased trigger list that mirrors natural user requests. The only deduction is the rubric-mandated penalty for the second-person phrase "Use when you need to design".

Suggestions

Rewrite the opening in third person (e.g., "Use when designing, reviewing, or improving validation in Quarkus applications" or "Apply when the user asks to...") to avoid the second-person voice penalty.

Consider trimming the frontmatter description's trigger list to unique phrasings and moving variants (e.g., "Improve validation error mapping with ExceptionMapper in Quarkus", which only appears in the body's When-to-use section) into the description for full coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities ("Bean Validation on JAX-RS resources, @Valid on parameters and CDI beans, constraint groups, @ConfigMapping validation, custom constraints, nested DTO validation, and ExceptionMapper-based error mapping") with comprehensive coverage matching the top anchor, but the rubric's explicit penalty for second-person voice ("Use when you need to design...") reduces it by one point from 5.

4 / 5

Completeness

It explicitly answers both what ("design, review, or improve validation in Quarkus applications" with an enumerated capability list) and when ("Use when you need to... This should trigger for requests such as..."), matching the anchor for clear and explicit what AND when with concrete trigger phrases.

5 / 5

Trigger Term Quality

"This should trigger for requests such as Add validation support in Quarkus; Review Quarkus validation rules; Improve request validation in Quarkus REST APIs; Add custom validation constraints in Quarkus; Validate Quarkus @ConfigMapping properties" gives comprehensive, natural phrasings a user would actually say, plus technical terms like Bean Validation and @Valid.

5 / 5

Distinctiveness Conflict Risk

Every capability and trigger is Quarkus-scoped (Quarkus, JAX-RS resources, @ConfigMapping, Quarkus REST APIs), creating a clear niche with minimal overlap risk against generic Bean Validation or REST skills; "Part of Plinth Toolkit" additionally situates it within its toolkit.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jabrena/plinth

Path

skills/403-frameworks-quarkus-validation/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.