CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

401-frameworks-quarkus-core

Use when building or reviewing core Quarkus applications with CDI beans and scopes, SmallRye Config and profiles, lifecycle, interceptors and events, virtual threads, and test-friendly design. This should trigger for requests such as Review Java code for Quarkus application structure and CDI; Apply best practices for Quarkus configuration and beans; Improve CDI interceptors, events, or programmatic injection in Quarkus; Add virtual-thread configuration or tune CDI lifecycle. ; Review Quarkus CDI bean lifecycle and configuration. Part of Plinth Toolkit

65

Quality

82%

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

71%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.

Well-structured skill body with strong progressive disclosure (a lean overview pointing to a real, one-level-deep reference) and a clearly sequenced workflow with explicit compile/verify validation commands. The main weakness is redundancy — the Constraints section restates three rules six ways, and 'When to use this skill' duplicates the description verbatim.

Suggestions

Collapse the six labeled constraint bullets (MANDATORY, PREREQUISITE, SAFETY, BLOCKING CONDITION, VERIFY, BEFORE APPLYING) into the three actual rules they restate: run mvn compile before changes, stop if it fails, run mvn clean verify after — this would remove the section's padding without losing any information.

Drop or trim the 'When to use this skill' section: it repeats the frontmatter description verbatim, and the description is already surfaced at skill-selection time.

Make workflow steps 2–3 more concrete, e.g., name the specific checks to perform (scope selection, pattern matching from the reference's examples) instead of 'Implement or refactor configuration/code following the reference patterns and project conventions'.

DimensionReasoningScore

Conciseness

The body is mostly efficient (topic overview, workflow, reference pointer), but the Constraints section is padded: the intro paragraph ('ensure the project compiles. If compilation fails, stop immediately. After applying improvements, run full verification') is then restated across six labeled bullets (MANDATORY, PREREQUISITE, SAFETY, BLOCKING CONDITION, VERIFY, BEFORE APPLYING) that repeat the same three rules. The 'When to use this skill' section also duplicates the frontmatter description verbatim. This fits anchor 3 — could be tightened — rather than anchor 2, since the redundancy is concentrated in one section rather than pervasive.

3 / 5

Actionability

Concrete, executable guidance is present: exact commands ('./mvnw compile' or 'mvn compile', './mvnw clean verify' or 'mvn clean verify') and a specific file to read ('references/401-frameworks-quarkus-core.md'). Per the instruction-skill note, absence of code is not penalized since the guidance is actionable. It falls short of anchor 5 because workflow steps 2–3 ('Implement or refactor configuration/code following the reference patterns and project conventions') stay generic rather than naming which patterns or checks to apply.

4 / 5

Workflow Clarity

The 4-step workflow (read reference/assess → gather scope/decide → apply → verify and report) is clearly sequenced, with explicit validation checkpoints backed by exact commands: mandatory compile before, stop-immediately blocking condition on failure, and full verification after. Not anchor 5: there is no fix-and-retry feedback loop — failure simply halts and defers to the user — and step 4's 'Execute appropriate build/tests' is less specific than the Constraints section's exact commands.

4 / 5

Progressive Disclosure

The body is a clean overview: a coverage list, constraints, workflow, and a clearly signaled single reference ([references/401-frameworks-quarkus-core.md](references/401-frameworks-quarkus-core.md)), which exists and is one level deep (verified: it has its own table of contents with 15 examples and no nested references). The split is appropriate — all detailed rules and code examples live in the reference, and navigation is easy. This matches the anchor-5 pattern.

5 / 5

Total

16

/

20

Passed

Description

83%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, specific description with an explicit 'Use when...' clause and multiple natural trigger phrases that satisfy the completeness anchor. Minor deductions come from small coverage gaps and a duplicated trigger sentence with a stray '. ;' punctuation artifact.

DimensionReasoningScore

Specificity

The description names the domain ('core Quarkus applications') and lists several concrete capability areas: 'CDI beans and scopes, SmallRye Config and profiles, lifecycle, interceptors and events, virtual threads, and test-friendly design'. It stops short of anchor 5 because coverage has minor gaps — e.g., native-image safety and programmatic injection (Instance<T>) appear in the body but not the description.

4 / 5

Completeness

It explicitly answers both questions: 'what' ('building or reviewing core Quarkus applications with CDI beans and scopes, SmallRye Config and profiles, lifecycle, interceptors and events, virtual threads, and test-friendly design') and 'when' ('Use when building or reviewing... This should trigger for requests such as...'), matching the anchor-5 pattern of a clear what plus concrete trigger phrases.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases are present ('Review Java code for Quarkus application structure and CDI', 'Apply best practices for Quarkus configuration and beans', 'Improve CDI interceptors, events, or programmatic injection', 'Add virtual-thread configuration'), plus keywords like Quarkus, CDI, beans, lifecycle, Java. Not anchor 5: some natural synonyms are missing (e.g., Jakarta EE, dependency injection) and the final trigger sentence duplicates an earlier one ('Review Quarkus CDI bean lifecycle and configuration' appears twice) rather than broadening coverage.

4 / 5

Distinctiveness Conflict Risk

The Quarkus-core/CDI niche is clearly distinct from generic skills, and 'Part of Plinth Toolkit' signals the family. It sits below anchor 5 only because sibling Quarkus skills (e.g., REST or extension-specific ones in the same toolkit) could partially overlap on phrases like 'Apply best practices for Quarkus configuration'.

4 / 5

Total

17

/

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/401-frameworks-quarkus-core/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.