CtrlK
BlogDocsLog inGet started
Tessl Logo

511-frameworks-micronaut-jdbc

Use when you need programmatic JDBC in Micronaut — pooled DataSource, parameterized SQL, io.micronaut.transaction.annotation.Transactional, batching, and domain exception translation. This should trigger for requests such as Review JDBC or SQL data access in a Micronaut project; Improve transactions and parameter binding for Micronaut JDBC; Translate SQLException to domain exceptions or stream large result sets; Fix self-invocation bypassing @Transactional in Micronaut; Review Hikari or pooled datasource usage in Micronaut JDBC. Part of Plinth Toolkit

68

Quality

86%

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.

A well-structured overview body with excellent progressive disclosure and a sound workflow with pre/post validation gates. Its weaknesses are redundancy — the Constraints section and the When-to-use section each repeat content fourfold and verbatim from the frontmatter — and the absence of any inline code or fix-and-retry loop, plus a stray "@512" artifact that should be corrected.

Suggestions

Collapse the Constraints section to two bullets (compile before, verify after) instead of six MANDATORY/PREREQUISITE/SAFETY/BLOCKING CONDITION variants of the same rule, or fold them into the workflow steps.

Remove or shrink the "When to use this skill" section — it duplicates the frontmatter description's trigger list verbatim and adds no new information to the body.

Fix the "When to prefer Micronaut Data (`@512`)" bullet — the `@512` token is an artifact/typo — and name the actual decision criteria or the correct annotation.

DimensionReasoningScore

Conciseness

Two sections are padded with duplication rather than over-explanation: the Constraints section restates the same compile-before/verify-after rule four times under MANDATORY/PREREQUISITE/SAFETY/BLOCKING CONDITION labels, and "When to use this skill" repeats the frontmatter description's trigger list verbatim. This is noticeably more than the "minor instances" of the 4 anchor, though nothing explains concepts Claude already knows.

3 / 5

Actionability

Concrete, executable commands are present ("./mvnw compile or mvn compile", "./mvnw clean verify or mvn clean verify") and the reference path is specific, but the body itself contains no code — the actual JDBC patterns are delegated to the reference file. Also, the covered-topics bullet "When to prefer Micronaut Data (`@512`)" contains an unexplained artifact/typo that reads as broken guidance, a minor gap.

4 / 5

Workflow Clarity

The 4-step workflow (read reference → gather scope → apply changes → run verification and report) is clearly sequenced, and validation checkpoints exist both before and after changes with an explicit failure gate ("If compilation fails, stop immediately"). It falls short of the 5 anchor because there is no fix-and-retry feedback loop — failures are deferred to the user rather than resolved within the workflow.

4 / 5

Progressive Disclosure

The body is a genuine overview (covered-topics list, constraints, workflow) pointing to a single, well-signaled, one-level-deep reference — [references/511-frameworks-micronaut-jdbc.md](references/511-frameworks-micronaut-jdbc.md), which exists on disk, is ~869 lines, and itself contains no nested references. This matches the clear-overview anchor exactly.

5 / 5

Total

16

/

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 with explicit, natural trigger phrasings, a concrete capability list, and a well-defined Micronaut-JDBC niche. Its only flaw is the second-person "Use when you need" opening, which violates the third-person voice guideline and costs it the top specificity score.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities — "pooled DataSource, parameterized SQL, io.micronaut.transaction.annotation.Transactional, batching, and domain exception translation" — which matches the comprehensive-coverage anchor, but the description opens in second person ("Use when you need programmatic JDBC in Micronaut"), and the rubric's third-person guideline requires a 1-point penalty, capping this at 4 rather than 5.

4 / 5

Completeness

Both questions are answered explicitly: the "what" is the concrete capability list up front, and the "when" is a full sentence of concrete trigger phrases ("This should trigger for requests such as Review JDBC or SQL data access in a Micronaut project; Improve transactions and parameter binding..."). This matches the top anchor exactly.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive with natural user phrasings and synonyms across all five concerns: "Review JDBC or SQL data access", "Improve transactions and parameter binding", "Translate SQLException", "Fix self-invocation bypassing @Transactional", and "Hikari or pooled datasource" — each phrased the way a user would actually state the request.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — programmatic JDBC in Micronaut specifically — and its triggers are qualified with "in a Micronaut project" / "Micronaut JDBC", so it will not fire for generic SQL, Spring JDBC, or Micronaut Data requests. Minimal conflict risk.

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