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
83
78%
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/501-frameworks-micronaut-core/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 identifies its niche (Micronaut framework), lists specific concrete capabilities and annotations, and provides explicit trigger guidance with example requests. The description effectively combines a 'Use when' clause with detailed enumeration of covered topics, making it easy for Claude to select this skill appropriately.
| 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' (building/reviewing Micronaut applications with specific features listed) and 'when' (explicit 'Use when' clause at the start, plus concrete 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 code', 'beans', '@Singleton', '@Controller', 'scheduling', 'shutdown', 'threading', 'configuration', '@Factory', 'best practices'. These cover common variations of how users would describe Micronaut-related tasks. | 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
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is well-organized as a routing document that points to a detailed reference, with good progressive disclosure and clear verification commands. However, it lacks concrete code examples or actionable patterns in the body itself, making it heavily dependent on the reference file for any real guidance. The constraints section is somewhat repetitive, and the workflow steps are generic enough to apply to almost any framework skill.
Suggestions
Add at least 2-3 concrete good/bad code examples inline (e.g., constructor injection vs field injection, thin controller pattern) so the skill provides immediate actionable value without requiring the reference file
Consolidate the constraints section — the MANDATORY, PREREQUISITE, and SAFETY bullets all convey the same 'must compile first' message and could be a single clear statement
Add an explicit feedback loop in the workflow for when `mvn clean verify` fails after applying changes (e.g., revert, diagnose, fix, re-verify)
| 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 has some repetitive emphasis (MANDATORY, PREREQUISITE, SAFETY all say roughly the same thing about compilation). However, it's not egregiously verbose. | 2 / 3 |
Actionability | The skill provides concrete commands (`./mvnw compile`, `mvn clean verify`) for verification steps, but all actual implementation guidance is deferred to the reference file. There are no code examples, no concrete patterns, and no executable snippets in the skill body itself — it's essentially a pointer to another document. | 2 / 3 |
Workflow Clarity | The four-step workflow is clearly sequenced and includes a verification step at the end. The constraints section adds a pre-check (compile before changes) and a post-check (verify after). However, there's no explicit feedback loop for what to do if verification fails after applying changes, and the workflow steps are quite generic/abstract rather than specific to Micronaut operations. | 2 / 3 |
Progressive Disclosure | The skill is well-structured as an overview that clearly points to a single reference file for detailed rules, examples, and constraints. The reference link is clearly signaled, one level deep, and the SKILL.md itself stays at the right level of abstraction for an overview document. | 3 / 3 |
Total | 9 / 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.
899d988
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.