Use when you need to add or review Flyway database migrations in a Micronaut application — micronaut-flyway, db/migration scripts, flyway.datasources.* configuration, and alignment with JDBC or Micronaut Data. This should trigger for requests such as Add or review Flyway migrations in a Micronaut project; Configure micronaut-flyway or db/migration layout. Part of cursor-rules-java project
81
76%
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/513-frameworks-micronaut-db-migrations-flyway/SKILL.mdQuality
Discovery
89%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 solid skill description that clearly identifies its niche (Flyway migrations in Micronaut) with explicit 'Use when' and 'trigger for' clauses. The trigger terms are well-chosen for the target audience of Java/Micronaut developers. The main weakness is that the specific capabilities could be more comprehensively enumerated beyond 'add or review' and 'configure'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (Flyway database migrations in Micronaut) and mentions some actions like 'add or review migrations', 'configure micronaut-flyway', and 'db/migration layout', but doesn't list multiple concrete distinct actions comprehensively (e.g., doesn't mention creating migration scripts, validating migrations, rollback, etc.). | 2 / 3 |
Completeness | Clearly answers both 'what' (add/review Flyway migrations, configure micronaut-flyway, db/migration layout, alignment with JDBC/Micronaut Data) and 'when' with explicit 'Use when' clause and 'This should trigger for' examples providing clear trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'Flyway', 'database migrations', 'Micronaut', 'micronaut-flyway', 'db/migration', 'flyway.datasources.*', 'JDBC', 'Micronaut Data'. These cover both framework-specific terms and common variations a developer would use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — the combination of Flyway + Micronaut is a very specific niche. The triggers are narrowly scoped to Flyway database migrations within Micronaut applications, making it unlikely to conflict with general database, migration, or Java skills. | 3 / 3 |
Total | 11 / 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.
This skill provides a well-structured workflow with clear validation checkpoints and safety constraints for Flyway migrations in Micronaut. However, it lacks concrete executable examples (no SQL migration samples, no YAML config snippets, no dependency declarations), deferring nearly all substantive guidance to an external reference file. The skill would benefit significantly from inline examples that make it actionable without requiring the reference file for basic tasks.
Suggestions
Add at least one concrete example: a sample versioned migration SQL file (e.g., V1__create_users.sql) and the corresponding flyway.datasources.* YAML configuration snippet.
Include the micronaut-flyway Maven/Gradle dependency declaration so users can copy-paste it directly.
Trim the 'What is covered' bullet list and 'Scope' line — these are meta-descriptions that don't add actionable value and could be replaced with a single sentence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary framing ('What is covered in this Skill?' section, 'Scope' line) and the edge case bullets are somewhat boilerplate. However, it's not egregiously verbose — most content serves a purpose, but it could be tightened by removing the introductory summary and merging redundant sections. | 2 / 3 |
Actionability | The skill provides concrete commands (./mvnw compile, mvn clean verify) and a clear workflow, but lacks any executable code examples — no sample migration SQL, no YAML configuration snippet, no pom.xml dependency block. All substantive guidance is deferred to the reference file, making the skill itself more of a process wrapper than actionable instruction. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced with four numbered steps: read reference, gather scope, apply changes, then verify. Validation checkpoints are explicit (compile before changes, clean verify after), with a clear stop condition if compilation fails. The edge cases add useful feedback loops for ambiguity and missing context. | 3 / 3 |
Progressive Disclosure | The skill correctly references a single external file (references/513-frameworks-micronaut-db-migrations-flyway.md) and cross-references related skills. However, since no bundle files were provided, we cannot verify the reference exists or assess its quality. The SKILL.md itself is thin — almost all actionable content is deferred to the reference, making the skill overly dependent on external content without providing enough standalone value. | 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.
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.