CtrlK
BlogDocsLog inGet started
Tessl Logo

412-frameworks-quarkus-panache

Use when you need data access with Quarkus Hibernate ORM Panache — including PanacheEntity / PanacheEntityBase, PanacheRepository, named queries, JPQL, native SQL, DTO projections (project(Class)), pagination (Page.of()), N+1 avoidance (JOIN FETCH), optimistic locking (@Version / OptimisticLockException), @NamedQuery for validated reusable queries, transactions, @TestTransaction for test isolation, and immutable-friendly patterns. This is the Quarkus analogue to Spring Data for relational persistence. This should trigger for requests such as Review Panache entities or repositories in Quarkus; Improve Hibernate ORM data access with Panache; Add DTO projections, JOIN FETCH, pagination, or optimistic locking to Panache queries; Fix N+1 query problems or add @Version concurrency control in Quarkus Panache; Improve Panache active record versus repository design. Part of Plinth Toolkit

68

Quality

85%

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

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

The body is well-structured as an overview with excellent progressive disclosure to a single reference file, and its compile-before/verify-after guardrails are explicit. Its weaknesses are redundancy (the same compile rule stated six ways, plus a verbatim repeat of the description's trigger list) and thin actionable detail — no code patterns in the body and generic middle workflow steps.

Suggestions

Collapse the six constraint bullets (MANDATORY / PREREQUISITE / SAFETY / BLOCKING CONDITION / VERIFY / BEFORE APPLYING) into two: one stating compile-before-is-blocking and one stating verify-after, keeping the exact commands.

Replace the generic workflow steps 2-3 ("Gather scope…", "Apply framework-aligned changes") with concrete actions, e.g. naming which reference sections to consult per task type or inlining one small good/bad Panache example.

Drop or shrink the "When to use this skill" section, which duplicates the description's trigger phrases verbatim and adds no new information to the body.

DimensionReasoningScore

Conciseness

The Constraints section restates a single rule six ways ("MANDATORY: Run ./mvnw compile…", "PREREQUISITE: Project must compile…", "SAFETY: If compilation fails…", "BLOCKING CONDITION…", "VERIFY…", "BEFORE APPLYING…"), and "When to use this skill" duplicates the description's trigger list verbatim. This is more than the "minor instances" of the anchor-4 example, so anchor 3 ("mostly efficient… could be tightened") fits best.

3 / 5

Actionability

There are concrete commands ("Run ./mvnw compile or mvn compile", "./mvnw clean verify") and a concrete reference path, but the body contains no code or pattern examples — all implementation detail is deferred to the reference — and steps like "Identify requested outcomes, constraints, and the minimum safe set of changes" are generic. This matches anchor 3 ("some concrete guidance but incomplete; missing key details") better than anchor 4's executable-code example.

3 / 5

Workflow Clarity

The 4-step workflow has explicit validation checkpoints (compile before changes, stop immediately on failure, clean verify after), matching anchor 4's "clear sequence with most checkpoints present". Not 5 because the middle steps are vague and failure handling is "stop and hand back to the user" rather than a fix-and-retry feedback loop.

4 / 5

Progressive Disclosure

The body is a genuine overview — a coverage summary, constraints, and workflow — pointing to a single, real, one-level-deep reference (references/412-frameworks-quarkus-panache.md, verified present) that is clearly signaled in both Workflow step 1 and the Reference section. This matches anchor 5 ("clear overview with well-signaled one-level-deep references").

5 / 5

Total

15

/

20

Passed

Description

100%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: it states a comprehensive set of concrete capabilities, gives explicit "use when" triggers with natural user phrasings, and defines a distinct niche with minimal conflict risk. The length is dense with real capabilities rather than fluff, so verbosity is not penalized.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities — "DTO projections (project(Class))", "pagination (Page.of())", "N+1 avoidance (JOIN FETCH)", "optimistic locking (@Version / OptimisticLockException)", "@TestTransaction for test isolation" — giving comprehensive, non-vague coverage of the Panache domain. Only one soft item ("immutable-friendly patterns") sits among many specific ones, which is not a coverage gap.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is the enumerated list of Panache data-access capabilities, and the "when" appears twice ("Use when you need data access with Quarkus Hibernate ORM Panache" and "This should trigger for requests such as…") with concrete trigger phrases. Clearly the anchor-5 example structure.

5 / 5

Trigger Term Quality

Explicit natural trigger phrasings ("Review Panache entities or repositories in Quarkus", "Fix N+1 query problems", "Improve Panache active record versus repository design") plus broad synonym coverage (JPQL, native SQL, @Version concurrency control) match how a user would actually phrase these requests. Not 4 because the term coverage is comprehensive rather than missing a few natural variations.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (Quarkus Hibernate ORM Panache), anchors it against Spring Data, and every trigger phrase is Quarkus/Panache-specific, so overlap with other persistence skills is minimal. Not 4 because there is no meaningful ambiguity about which skill should fire.

5 / 5

Total

20

/

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