CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

123-java-design-patterns

Use when you need to select, review, or implement Java design and integration patterns — including classic Java design patterns, REST API patterns, Kafka and event-driven patterns, database and persistence patterns, and cross-cutting integration patterns. This should trigger for requests such as Apply Java design patterns; Review REST API patterns; Design Kafka event-driven patterns; Improve database persistence patterns; Add resilient integration patterns. Part of Plinth Toolkit

67

Quality

84%

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, instruction-only skill body: an overview with real one-level-deep references, imperative constraints, and a sequenced workflow with build validation. Weaker spots are the verbatim duplication of the description's trigger list in the body, the absence of any inline example of the expected advisory output, and no error-recovery loop after validation.

Suggestions

Remove the 'When to use this skill' section (or collapse it to one line) — its bullets duplicate the frontmatter description's trigger phrases and the 'What is covered' list, saving tokens without losing information.

Add a brief inline example of the expected output for step 3/4 (e.g., a two-line pattern recommendation with benefit/cost/when-not-to-use) so the advisory format is concrete without loading a reference.

Extend step 5 with an explicit feedback loop: if the build fails or the chosen pattern increases complexity, re-evaluate against a simpler alternative before proceeding.

DimensionReasoningScore

Conciseness

The body is lean with no concept explanations Claude already knows — the constraints are imperative rules ("NO PATTERN SHOPPING", "BUILD SAFETY") and the workflow is terse. It misses anchor 5 because of redundancy: the "When to use this skill" bullet list ("Apply Java design patterns", "Review REST API patterns", ...) repeats the frontmatter description's trigger phrases verbatim, and the "What is covered" list re-caps the same five domains, so a few sections could be trimmed.

4 / 5

Actionability

Concrete, executable guidance is present: exact build commands ("run `./mvnw compile` or `mvn compile` before refactoring and `./mvnw clean verify` or `mvn clean verify` after changes") and exact reference paths to read ("references/123-java-design-patterns.md", etc.), all of which exist on disk. It falls short of anchor 5 because the core advisory steps stay abstract — "Choose the simplest pattern that addresses the design pressure" defers all concrete pattern guidance to the references without an inline example of the expected output shape (e.g., a trade-off table or request/response sketch).

4 / 5

Workflow Clarity

A clear 5-step sequence (identify pressure → select reference → recommend pattern → implement → validate) with explicit validation checkpoints ("BUILD SAFETY" requires compile before/verify after, and step 5 says "Validate the outcome... Run the project build"). It does not reach anchor 5 because there is no error-recovery feedback loop (e.g., what to do when the build fails or the pattern does not fit) and no checklist for the multi-domain selection decision.

4 / 5

Progressive Disclosure

The SKILL.md is a concise overview with well-signaled, one-level-deep references: five topical reference files are listed as markdown links in a dedicated "Reference" section and named again in workflow step 2, all five files exist in references/, and no content that belongs in separate files is inlined. This matches the anchor-5 "clear overview with well-signaled one-level-deep references; easy navigation".

5 / 5

Total

17

/

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 description that explicitly states what the skill does and when to trigger it, with concrete user-facing trigger phrases and clear domain subdivision. The main gaps are verb-level rather than outcome-level specificity in the action list and a few missing natural synonyms (e.g., refactor, Spring, GoF).

DimensionReasoningScore

Specificity

The description lists several concrete actions ("select, review, or implement") across five named pattern domains ("classic Java design patterns, REST API patterns, Kafka and event-driven patterns, database and persistence patterns, and cross-cutting integration patterns"), giving comprehensive coverage but the actions themselves are generic verbs rather than concrete outcomes like the anchor-5 example's "fill forms, merge documents, convert pages to images". It exceeds anchor 3 (only 1-2 concrete actions) but does not fully match anchor 5's fully concrete action list.

4 / 5

Completeness

Both questions are answered explicitly: "what" via "select, review, or implement Java design and integration patterns — including [five domains]" and "when" via "Use when you need to... This should trigger for requests such as..." with concrete trigger phrases, exactly matching the anchor-5 example pattern. Not 4 because the "when" is fully explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases are present ("Apply Java design patterns; Review REST API patterns; Design Kafka event-driven patterns; Improve database persistence patterns; Add resilient integration patterns") with good keyword coverage (Kafka, REST API, event-driven, persistence). It falls short of anchor 5's "comprehensive coverage of natural terms including synonyms" — common variations users would say such as "refactor", "singleton/factory", "GoF", or "Spring" are missing.

4 / 5

Distinctiveness Conflict Risk

The Java-specific framing ("Java design and integration patterns") carves a clear niche with distinct triggers, but sub-triggers like "Review REST API patterns" and "Improve database persistence patterns" could overlap with generic API-review or database-tuning skills — matching anchor 4's "mostly distinct; minor overlap risk with closely related skills" rather than anchor 5's minimal conflict risk.

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/123-java-design-patterns/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.