CtrlK
BlogDocsLog inGet started
Tessl Logo

502-frameworks-micronaut-rest

Use when you need to design, review, or improve REST APIs with Micronaut — including @Controller routes, HTTP status codes, DTOs, Bean Validation, exception handlers, pagination, idempotency, ETag/If-Match, caching headers, versioning, contract-first OpenAPI (OpenAPI Generator), optional runtime OpenAPI via micronaut-openapi, and security annotations. This should trigger for requests such as Review or improve Micronaut @Controller REST APIs; Add validation, error handling, or align controllers with the OpenAPI contract on Micronaut HTTP layer. Part of cursor-rules-java project

68

Quality

81%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

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 excels across all dimensions. It provides comprehensive specificity with numerous concrete Micronaut REST API concepts, includes natural trigger terms developers would use, explicitly states both what the skill does and when to use it with example trigger phrases, and is highly distinctive due to its Micronaut-specific focus. The only minor weakness is that it's somewhat dense and could benefit from slightly better formatting for readability.

DimensionReasoningScore

Specificity

The description lists numerous specific concrete actions and concepts: @Controller routes, HTTP status codes, DTOs, Bean Validation, exception handlers, pagination, idempotency, ETag/If-Match, caching headers, versioning, contract-first OpenAPI, security annotations. This is highly specific and comprehensive.

3 / 3

Completeness

Clearly answers both 'what' (design, review, improve REST APIs with Micronaut including a comprehensive list of capabilities) and 'when' ('Use when you need to design, review, or improve REST APIs with Micronaut' plus explicit trigger examples like 'Review or improve Micronaut @Controller REST APIs'). The 'Use when' clause is present and explicit.

3 / 3

Trigger Term Quality

Includes many natural keywords a user would say: 'REST APIs', 'Micronaut', '@Controller', 'validation', 'error handling', 'OpenAPI', 'pagination', 'HTTP status codes', 'DTOs', 'caching headers', 'versioning'. Good coverage of terms developers would naturally use when working in this domain.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — scoped specifically to Micronaut REST API design with very specific triggers like '@Controller', 'Micronaut HTTP layer', 'OpenAPI Generator', and 'micronaut-openapi'. Unlikely to conflict with generic REST API or other framework skills due to the Micronaut-specific terminology throughout.

3 / 3

Total

12

/

12

Passed

Implementation

62%

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

The skill has a well-structured workflow with strong validation checkpoints and clear sequencing, which is its main strength. However, it lacks any concrete code examples or executable patterns in the body itself, deferring everything to a reference file that cannot be verified. The 'What is covered' section is verbose and descriptive rather than instructive, listing topics without providing actionable guidance for any of them.

Suggestions

Add at least 2-3 concrete, minimal code examples inline (e.g., a @Controller with @Valid, an ExceptionHandler pattern, or a pagination example) so the skill provides immediate actionable value without requiring the reference file.

Remove or significantly condense the 'What is covered' bullet list — it reads like a table of contents for the reference file rather than adding value in the SKILL.md itself.

Merge the 'When to use this skill' section into the opening line or remove it, as it duplicates the skill description and wastes tokens.

DimensionReasoningScore

Conciseness

The skill includes a lengthy 'What is covered' bullet list that largely restates the description and could be trimmed. The constraints and workflow sections are reasonably tight, but the overall content has some redundancy (e.g., the 'When to use this skill' section repeats the description). The skill also explains scope in ways that don't add much beyond what Claude would infer.

2 / 3

Actionability

The skill provides concrete build commands (./mvnw compile, mvn clean verify) and a clear workflow sequence, 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.md itself — it's essentially a pointer to the reference with some process scaffolding.

2 / 3

Workflow Clarity

The workflow is clearly sequenced with four numbered steps: read reference, gather scope, apply changes, verify. The constraints section includes explicit validation checkpoints (compile before, verify after) with stop conditions on failure, and edge case handling for ambiguous requests or missing inputs. This constitutes a clear feedback loop for a potentially destructive refactoring operation.

3 / 3

Progressive Disclosure

The skill correctly references a single detailed reference file (references/502-frameworks-micronaut-rest.md) for deeper guidance, which is good one-level-deep disclosure. However, since no bundle files were provided, we cannot verify the reference exists or assess its quality. The SKILL.md itself is somewhat thin — it defers almost everything to the reference while the inline content is mostly meta-description rather than actionable overview content.

2 / 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.

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.