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
75%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/113-java-maven-documentation/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
762cb86
Table of Contents
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.