CtrlK
BlogDocsLog inGet started
Tessl Logo

411-frameworks-quarkus-jdbc

Use when you need programmatic JDBC in Quarkus — Agroal DataSource, parameterized SQL, transactions, batching, and Dev Services. This should trigger for requests such as Review JDBC or SQL data access in a Quarkus project; Improve transactions and parameter binding for Quarkus JDBC; Translate SQLException to domain exceptions or stream large result sets; Fix CDI self-invocation bypassing @Transactional in Quarkus. Part of cursor-rules-java project

69

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

70%

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

A well-structured overview with a validated workflow and clean single-level reference disclosure, undermined mainly by a repetitive Constraints section and full delegation of JDBC code patterns to the reference. Tightening redundancy and inlining a minimal executable snippet would lift the weaker dimensions.

Suggestions

Collapse the six overlapping Constraints bullets into a concise compile-before / stop-on-failure / verify-after checklist to remove redundancy.

Inline one or two minimal executable JDBC snippets (e.g., DataSource injection with a parameterized PreparedStatement) instead of delegating all pattern guidance to the reference file.

Remove the 'When to use this skill' block, which duplicates the trigger phrasings already in the description.

DimensionReasoningScore

Conciseness

The 'What is covered' list is lean and assumes competence, but the Constraints section repeats the same compile/verify/stop idea across six overlapping bullets (MANDATORY, PREREQUISITE, SAFETY, BLOCKING, NO EXCEPTIONS, VERIFY) and 'When to use this skill' duplicates the description's triggers, so it could be tightened.

2 / 3

Actionability

Concrete copy-paste commands are present ('./mvnw compile', 'mvn clean verify') and the reference path is specific, but the core JDBC pattern guidance is delegated to the reference file with no inline executable examples, leaving the substantive technical direction incomplete.

2 / 3

Workflow Clarity

A clear four-step sequence with explicit validation checkpoints — compile before, stop immediately on failure, verify after — provides the feedback loop the rubric expects for database/batch operations.

3 / 3

Progressive Disclosure

The body is a concise overview pointing one level deep to a real, valid bundle file (references/411-frameworks-quarkus-jdbc.md), clearly signaled in both the Workflow and Reference sections, with content appropriately split out.

3 / 3

Total

10

/

12

Passed

Description

100%

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, third-person description with an explicit 'Use when' trigger, concrete capability list, and natural user-facing trigger phrasings. It cleanly answers both what the skill does and when to invoke it.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Agroal DataSource, parameterized SQL, transactions, batching, and Dev Services' — plus four specific trigger scenarios, matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

Explicitly answers both what (programmatic JDBC capabilities) and when ('Use when you need programmatic JDBC in Quarkus' plus 'This should trigger for requests such as'), satisfying the both-what-and-when anchor.

3 / 3

Trigger Term Quality

Triggers read as natural user requests — 'Review JDBC or SQL data access in a Quarkus project', 'Improve transactions and parameter binding', 'Fix CDI self-invocation bypassing @Transactional' — giving good coverage of phrasings a user would actually say.

3 / 3

Distinctiveness Conflict Risk

Scoped narrowly to Quarkus programmatic JDBC with distinct triggers and a cross-reference to Panache (@412), making it unlikely to fire for the wrong skill.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/cursor-rules-java
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.