Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, concise skill body that uses progressive disclosure effectively with a real single-level reference. Its main gaps are that the executable creation command and the verify-failure feedback loop are delegated to the reference rather than surfaced in the body.
Suggestions
Surface the concrete `mn create-app` invocation (with --build=maven, --jdk, --features, --lang, --output flags) in the body's Workflow Step 3 so the core action is actionable without opening the reference.
Add an explicit verify-failure feedback loop in the body (e.g., 'If `./mvnw clean verify` fails, read the failing goal, fix the cause, and re-run verify') to satisfy the error-recovery expectation for a filesystem-mutating operation.
Drop or trim the 'When to use this skill' section, which duplicates the trigger phrases already in the frontmatter description, to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, with no padding explaining what Micronaut/Maven/SDKMAN are; every section (Constraints, Workflow, Reference) earns its place, fitting the lean-and-efficient anchor at 3. | 3 / 3 |
Actionability | Concrete commands appear for verification ("sdk version", "./mvnw clean verify", "mvn clean verify"), but the core creation command (`mn create-app`) lives only in the reference, so the body's guidance is incomplete rather than copy-paste ready, matching anchor 2 not 3. | 2 / 3 |
Workflow Clarity | A clear 4-step sequence with an explicit verify checkpoint is present, but the in-body error-recovery feedback loop (fix -> re-verify) is absent and only implied via the reference, keeping it below the feedback-loops-required anchor at 3. | 2 / 3 |
Progressive Disclosure | Clear overview body with a single well-signaled, verified one-level-deep reference ("Read the reference...", "BEFORE APPLYING: Read the reference", plus a Reference link), matching the clear-overview-with-one-level-references anchor at 3. | 3 / 3 |
Total | 10 / 12 Passed |