Use when building or reviewing Micronaut applications — Micronaut.run bootstrap, @Singleton/@Prototype, @Factory beans, @ConfigurationProperties, environments, @Requires, @Controller vs services, @Scheduled, graceful shutdown, @ExecuteOn for blocking work, and Jakarta-consistent APIs. This should trigger for requests such as Review Java code for Micronaut application structure and beans; Apply best practices for Micronaut configuration, @Requires, and factories; Improve scheduling, shutdown, or threading in Micronaut services. Part of cursor-rules-java project
70
85%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
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 identifies its niche (Micronaut framework for Java), lists numerous specific capabilities and annotations, and provides explicit trigger guidance with example requests. The description is comprehensive and distinctive, making it easy for Claude to select this skill when appropriate and avoid it otherwise.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and concepts: Micronaut.run bootstrap, @Singleton/@Prototype, @Factory beans, @ConfigurationProperties, environments, @Requires, @Controller vs services, @Scheduled, graceful shutdown, @ExecuteOn for blocking work, and Jakarta-consistent APIs. | 3 / 3 |
Completeness | Clearly answers both 'what' (Micronaut application structure, beans, configuration, scheduling, shutdown, threading) and 'when' with an explicit 'Use when building or reviewing Micronaut applications' clause plus specific trigger examples like 'Review Java code for Micronaut application structure and beans'. | 3 / 3 |
Trigger Term Quality | Includes highly relevant natural keywords users would say: 'Micronaut', 'Java', 'beans', '@Singleton', '@Controller', 'scheduling', 'shutdown', 'threading', 'configuration', '@Factory', 'best practices'. These cover common variations of how users would phrase Micronaut-related requests. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — focuses specifically on the Micronaut framework with framework-specific annotations and concepts (@Singleton, @Requires, @ExecuteOn, Micronaut.run). Unlikely to conflict with generic Java skills or other framework-specific skills like Spring. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
70%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with excellent workflow clarity and progressive disclosure — it clearly sequences steps with validation checkpoints and appropriately delegates detailed patterns to a reference file. Its main weakness is limited actionability in the SKILL.md itself: there are no inline code examples or concrete before/after patterns, making it heavily dependent on the reference file for actual guidance. Conciseness could also be improved by consolidating redundant compilation-check statements.
Suggestions
Add at least one concrete good/bad code example inline (e.g., constructor injection vs field injection, or thin controller delegating to service) so the SKILL.md is actionable without requiring the reference file.
Consolidate the overlapping MANDATORY/PREREQUISITE/SAFETY constraint bullets into a single clear statement about the compile-first requirement to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'What is covered' bullet list is somewhat redundant with the reference file and the 'When to use this skill' section partially duplicates the description. The constraints section is useful but slightly verbose with the bold labels repeating similar ideas (MANDATORY/PREREQUISITE/SAFETY all say 'must compile'). Overall mostly efficient but could be tightened. | 2 / 3 |
Actionability | The skill provides concrete commands (./mvnw compile, mvn clean verify) and a clear workflow, but lacks any executable code examples or specific before/after patterns. All actual guidance is deferred to the reference file, so the SKILL.md itself gives direction rather than directly actionable code. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced in four numbered steps with explicit validation checkpoints: compile before changes (blocking condition if it fails), verify after changes, and a clear feedback loop (stop if compilation fails). The constraints section reinforces these checkpoints well. | 3 / 3 |
Progressive Disclosure | The SKILL.md serves as a clear overview with a single, well-signaled reference to the detailed file (references/501-frameworks-micronaut-core.md). Navigation is one level deep and clearly indicated. The structure appropriately keeps the overview concise while pointing to detailed content. | 3 / 3 |
Total | 10 / 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.
3b97275
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.