CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

114-java-maven-search

Routes Maven version questions to the right workflow by choosing project-local update report interpretation for a user’s own pom.xml, or Maven artifact discovery from maintainer-approved structured evidence. Use when interpreting dependency, plugin, or property update reports; finding Maven coordinates; verifying groupId artifactId version; browsing versions from approved evidence; or constructing artifact URLs without fetching remote content. 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

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 router skill with excellent progressive disclosure and actionable, safety-conscious guidance. The main weakness is redundancy: routing defaults and no-fetch/no-execution rules are repeated across Constraints, 'When to use', and the Workflow section, inflating token cost without adding information.

Suggestions

Remove the near-verbatim restatements of the PROJECT DEFAULT / NO REMOTE FETCHING / NO REMOTE PLUGIN EXECUTION rules from Workflow steps 2 and 3 — the Constraints section already states them.

Consider trimming the 17-item 'When to use this skill' list, which overlaps heavily with the description's 'Use when' clause and the Workflow classification step.

Add one compact example inline (a two-line sample update-report interpretation or a constructed artifact URL pattern) so the most common case does not require opening a reference.

DimensionReasoningScore

Conciseness

The body is mostly free of concept padding, but the routing rules are restated three times — the 'PROJECT DEFAULT', 'CENTRAL EXPLICIT', 'NO REMOTE FETCHING', and 'NO REMOTE PLUGIN EXECUTION' constraints reappear nearly verbatim in Workflow steps 2 and 3. It is not 4 because the Constraint/Workflow duplication is more than minor trimming; not 2 because there is no unnecessary concept explanation or padding.

3 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: named plugin goals ('display-dependency-updates', 'display-plugin-updates', 'display-property-updates'), a hard output format ('express full coordinates as groupId:artifactId:version'), named reference files to read per workflow, and explicit prohibitions. It is not 5 because there are no inline examples (e.g., a sample report snippet or a URL pattern) to cover the most common case without opening a reference; not 3 because the guidance given is specific and directly executable.

4 / 5

Workflow Clarity

A clear 4-step sequence (classify → project-local by default → discovery only when explicit → format results) with explicit checkpoints for ambiguity, missing context, and constraint conflicts ('If the user goal is ambiguous, stop and ask a clarifying question'). It is not 5 because there is no validate-then-verify loop on the produced output itself (e.g., re-checking that reported coordinates match the evidence); not 3 because the edge-case checkpoints are explicit rather than implicit.

4 / 5

Progressive Disclosure

The SKILL.md is a lean overview that routes to exactly two one-level-deep references, both of which exist in the bundle and are each linked in a dedicated 'Reference' section and named again in the corresponding workflow step. It is not 4 because there are no organization gaps — every reference is clearly signaled, one level deep, and loaded only when its workflow is selected.

5 / 5

Total

16

/

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: third-person, concrete, and comprehensive across both routed workflows, with an explicit 'Use when' trigger clause. The only weakness is that a few natural user phrases (e.g. 'outdated dependencies', 'Maven Central', 'latest version') are absent from the trigger list.

Suggestions

Add one or two natural user phrasings to the 'Use when' clause, such as 'outdated dependencies' or 'what can I update in my pom.xml'.

Mention 'Maven Central' explicitly in the discovery trigger since users commonly ask for 'the latest version on Maven Central'.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Routes Maven version questions', 'update report interpretation for a user's own pom.xml', 'Maven artifact discovery', 'finding Maven coordinates', 'verifying groupId artifactId version', 'constructing artifact URLs' — comprehensively covering both routed workflows in third-person voice. It is not 4 because coverage spans interpretation, discovery, verification, browsing, and URL construction with no significant gaps.

5 / 5

Completeness

It clearly answers 'what' ('Routes Maven version questions to the right workflow by choosing project-local update report interpretation... or Maven artifact discovery...') and 'when' with an explicit 'Use when' clause enumerating concrete triggers (interpreting update reports, finding coordinates, verifying GAV, browsing versions, constructing URLs). It is not 4 because the 'when' is explicit and enumerates specific trigger phrases rather than being merely adequate.

5 / 5

Trigger Term Quality

Good keyword coverage including 'pom.xml', 'dependency, plugin, or property update reports', 'Maven coordinates', 'groupId artifactId version', and 'artifact URLs'. It is not 5 because common natural phrases users would say are missing, e.g. 'outdated dependencies', 'Maven Central', 'latest version', or 'update my pom'.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Maven version routing between project-local updates and artifact discovery — with distinct triggers like 'pom.xml', 'display-dependency-updates', and 'groupId artifactId version' that other skills would not claim. It is not 4 because overlap risk is minimal; the routing scope and Maven-specific terminology make mis-triggering unlikely.

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/114-java-maven-search/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.