CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

312-frameworks-spring-data-jdbc

Use when you need to use Spring Data JDBC with Java records — including entity design with records, repository pattern, immutable updates, aggregate relationships, custom queries, transaction management, and avoiding N+1 problems. This should trigger for requests such as Review Java code for Spring Data JDBC; Apply best practices for Spring Data JDBC in Java code; Model Spring Data JDBC aggregates with Java records; Review Spring Data JDBC repositories and aggregate boundaries; Improve optimistic locking or domain events in Spring Data JDBC. Part of Plinth Toolkit

70

Quality

88%

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 overview body: lean, correct command guidance with pre/post validation, and exemplary progressive disclosure via a single real, well-organized reference file. Weaknesses are modest — duplicated constraint text, a vague apply-changes step, and no stated recovery loop if post-change verification fails.

Suggestions

Remove the Constraints intro paragraph and keep only the labeled bullets (MANDATORY/SAFETY/VERIFY/EDGE CASE) — the paragraph currently repeats the same compile/stop/verify instructions verbatim.

Make workflow step 3 concrete: specify what a minimal framework-aligned change looks like (e.g., which reference examples map to which change types) or instruct reading specific reference sections before editing.

Add an explicit recovery loop to the workflow: if 'mvn clean verify' fails after applying improvements, fix the regressions and re-run verification before reporting results.

DimensionReasoningScore

Conciseness

The body is lean — terse bullet lists, bold constraint labels, no background explanation of Spring Data JDBC — with one clear redundancy: the Constraints intro paragraph ('Before applying any Spring Data JDBC changes, ensure the project compiles. If compilation fails, stop immediately.') restates what the MANDATORY and SAFETY bullets immediately repeat. This fits 'Efficient; minor instances of over-explanation that could be trimmed'; not a 5 because of that duplicated constraint text, and not a 3 because nearly everything else earns its tokens.

4 / 5

Actionability

Concrete commands are present ('./mvnw compile', 'mvn clean verify'), the exact reference file to read is named, and edge-case handling is specified. However, workflow step 3 ('Implement or refactor configuration/code following the reference patterns and project conventions') is high-level and no inline example of a change appears, fitting 'Mostly executable guidance; concrete code or commands with minor gaps'. Not a 5 because of those gaps; not a 3 because the executable core (read this file, run this command, stop on failure) is fully specified.

4 / 5

Workflow Clarity

The 4-step workflow has a clear sequence and explicit validation checkpoints (compile before changes, stop on failure, full verify after), matching 'Clear sequence with most checkpoints present; minor validation gaps'. Not a 5 because the error-recovery loop after verification fails (fix and re-verify) is not stated; not a 3 because validation is explicit, not missing — so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

The body is a lean overview that defers all detail to a single clearly-signaled, one-level-deep reference — the 'Reference' section links references/312-frameworks-spring-data-jdbc.md, which exists and is a well-structured 1121-line file of rules and good/bad examples with no further nesting. This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'. Not a 4 because there are no organization gaps — the split is clean and navigation is trivial.

5 / 5

Total

17

/

20

Passed

Description

92%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 concrete capabilities, an explicit 'Use when' clause with natural trigger phrases, and a well-bounded niche. The only weakness is that trigger phrasings are formulaic variations of the exact framework name, offering little synonym coverage for users who phrase the need differently.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — 'entity design with records, repository pattern, immutable updates, aggregate relationships, custom queries, transaction management, and avoiding N+1 problems' — giving comprehensive coverage of the skill's actions, matching the anchor 'Lists multiple specific concrete actions; comprehensive coverage'. Not a 4 because there are no real gaps in coverage of the skill's stated scope.

5 / 5

Completeness

It explicitly answers both questions: the 'what' via the capability list after the em-dash, and the 'when' via 'Use when you need to use Spring Data JDBC with Java records' plus 'This should trigger for requests such as…' with five concrete trigger phrases — matching the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'. Not a 4 because the 'when' is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Trigger phrases like 'Review Java code for Spring Data JDBC', 'Model Spring Data JDBC aggregates with Java records', and 'Improve optimistic locking or domain events' are natural user phrasings, but all derive from the literal framework name with little synonym variation (e.g., no 'JDBC repositories', 'aggregate roots', or 'record-based entities' phrasings), fitting 'Good keyword coverage; a few natural terms missing'. Not a 5 because synonym variation is thin; not a 3 because the terms present are exactly what users of this framework would say.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Spring Data JDBC with Java records) and every trigger phrase names JDBC explicitly, so it would not fire for general Spring, JPA, or database skills — minimal conflict risk. Not a 4 because no closely-related sibling skill (e.g., a JPA variant) would plausibly be triggered by these JDBC-specific phrases.

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/312-frameworks-spring-data-jdbc/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.