CtrlK
BlogDocsLog inGet started
Tessl Logo

113-java-maven-documentation

Use when you need to create a DEVELOPER.md file for a Maven project — combining a fixed base template with dynamic sections derived from the project pom.xml, including a Plugin Goals Reference, Maven Profiles table, and Submodules table for multi-module projects. This should trigger for requests such as Create DEVELOPER.md; Generate DEVELOPER.md; Maven project documentation; Add Maven documentation; Plugin goals reference. Part of cursor-rules-java project

80

Quality

75%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/113-java-maven-documentation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

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.

This is a strong skill description that clearly defines what the skill does (generates DEVELOPER.md files for Maven projects with specific dynamic sections), when to use it (explicit trigger phrases and a 'Use when' clause), and occupies a distinct niche. The description is well-structured with concrete actions, natural trigger terms, and clear scope boundaries.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: creating a DEVELOPER.md file, combining a fixed base template with dynamic sections from pom.xml, generating Plugin Goals Reference, Maven Profiles table, and Submodules table for multi-module projects.

3 / 3

Completeness

Clearly answers both 'what' (create DEVELOPER.md combining base template with dynamic sections from pom.xml including specific tables) and 'when' (explicit 'Use when' clause at the start plus a list of trigger phrases like 'Create DEVELOPER.md', 'Maven project documentation').

3 / 3

Trigger Term Quality

Includes explicit natural trigger terms users would say: 'Create DEVELOPER.md', 'Generate DEVELOPER.md', 'Maven project documentation', 'Add Maven documentation', 'Plugin goals reference'. Also mentions 'pom.xml' and 'multi-module projects' which are natural terms.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — targets a very specific niche of generating DEVELOPER.md files for Maven projects with specific dynamic sections derived from pom.xml. Unlikely to conflict with other skills due to the narrow scope.

3 / 3

Total

12

/

12

Passed

Implementation

50%

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

This skill provides a reasonable high-level structure for generating DEVELOPER.md files for Maven projects, with a clear workflow sequence and appropriate scoping constraints. However, it lacks concrete examples, executable commands, validation steps, and contains redundant content. The heavy delegation to a reference file without providing any inline examples or output format makes the SKILL.md body insufficient as a standalone guide.

Suggestions

Add a concrete example of the expected DEVELOPER.md output format (even abbreviated) so Claude understands the target structure without needing to read the reference file first.

Include at least one executable example showing how to extract plugin information from a pom.xml, or show the expected table format for plugin goals, profiles, and submodules.

Add a validation step after generation — e.g., 'Verify all explicitly declared plugins from POMs appear in the Plugin Goals Reference table' — to catch missed plugins or incorrect scope.

Remove the redundant 'When to use this skill' section (this belongs in frontmatter) and the duplicated constraint descriptions to improve conciseness.

DimensionReasoningScore

Conciseness

The skill has some redundancy — the constraints section repeats information from the intro (e.g., 'read every pom.xml' and 'only include explicitly declared plugins' appear twice). The 'When to use this skill' section duplicates the frontmatter description. However, it's not excessively verbose overall.

2 / 3

Actionability

The workflow provides a clear sequence of steps but lacks concrete, executable guidance — no actual commands, code snippets, or example output formats are shown. The skill heavily delegates to a reference file for the actual template content, plugin catalog, and detailed constraints, making the SKILL.md itself more of an abstract overview than actionable instructions.

2 / 3

Workflow Clarity

Steps are listed in a clear sequence (1-4), but there are no validation checkpoints or feedback loops. For a document generation task that involves reading multiple POM files and assembling content, there should be verification steps (e.g., validate that all declared plugins were captured, verify the generated file structure). The workflow also lacks error recovery guidance.

2 / 3

Progressive Disclosure

The skill references a single external file (references/113-java-maven-documentation.md) which is well-signaled, but since no bundle files were provided, we cannot verify the reference exists or assess its quality. The SKILL.md itself contains too little actionable detail — it over-delegates to the reference file without providing enough standalone value as an overview. The base template, plugin catalog format, and example output should at least be summarized in the skill body.

2 / 3

Total

8

/

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.

Validation11 / 11 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.