CtrlK
BlogDocsLog inGet started
Tessl Logo

513-frameworks-micronaut-db-migrations-flyway

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; Add versioned Flyway SQL migrations for Micronaut; Review Micronaut database migration ordering; Configure Flyway datasources in a Micronaut project. Part of Plinth Toolkit

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

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

A well-structured overview skill with strong safety constraints, concrete build commands, and excellent one-level-deep reference navigation. Its weaknesses are a duplicated trigger list that re-states the frontmatter, vague process-boilerplate lines, and a missing fix-and-re-verify feedback loop after the verification step.

Suggestions

Delete the 'When to use this skill' section — it duplicates the five trigger phrases already present verbatim in the frontmatter description, which is always loaded with the skill.

Add an explicit feedback loop for verification failure, e.g. 'If `mvn clean verify` fails, fix the failing migration or configuration and re-run verification before reporting results.'

Replace the meta 'Scope' line and the generic 'Gather scope and decide target improvements' step with concrete guidance (e.g. listing Flyway migration naming like V{n}__{description}.sql or a minimal flyway.datasources YAML snippet), which would also lift actionability.

DimensionReasoningScore

Conciseness

Mostly efficient — the Constraints and Workflow sections are tight — but there is real duplication and filler: the entire 'When to use this skill' section repeats the five trigger phrases already verbatim in the frontmatter description, and 'Scope: Apply recommendations based on the reference rules and good/bad examples' plus 'Gather scope and decide target improvements — Identify requested outcomes, constraints, and the minimum safe set of changes to apply' are meta-explanations that add no actionable content. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Concrete, executable commands are present — 'Run `./mvnw compile` or `mvn compile`', 'Run `./mvnw clean verify` or `mvn clean verify`', exact paths 'src/main/resources/db/migration' and 'flyway.datasources.*', and named reference files to read first. It stops short of anchor 5 because the body includes no copy-paste-ready example (e.g. a V1__init.sql naming sample or a flyway.datasources YAML snippet), delegating all patterns to the references.

4 / 5

Workflow Clarity

The four-step workflow is clearly sequenced with meaningful checkpoints for database work: mandatory 'Run `./mvnw compile`' before changes, 'SAFETY: If compilation fails, stop immediately', 'Run `./mvnw clean verify`' after, plus a breaking-change review gate. It misses anchor 5 because there is no explicit feedback loop after verification fails (fix and re-verify) — 'VERIFY' names the command but not the recovery path — which the rubric flags as important for database operations.

4 / 5

Progressive Disclosure

The body is a genuine overview: it states what is covered, points to three real reference files (all verified present in references/), cited consistently in Workflow step 1 and again in a dedicated 'Reference' section with markdown links, exactly one level deep. This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, dense description that concretely states capabilities, gives five explicit trigger phrasings, and tightly scopes the Flyway-in-Micronaut niche while coordinating with sibling skills. The only gap is a few natural synonyms ('schema migration', 'schema evolution', .sql naming) that anchor-5 trigger coverage would include.

DimensionReasoningScore

Specificity

The description lists multiple concrete, verifiable actions — 'add or review Flyway database migrations', 'Configure micronaut-flyway or db/migration layout', 'Add versioned Flyway SQL migrations', 'Review Micronaut database migration ordering', 'Configure Flyway datasources' — plus specific artifacts like 'flyway.datasources.* configuration'. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' exactly; it is well above anchor 4 because coverage spans adding, reviewing, ordering, and configuring with no gaps in the skill's stated scope.

5 / 5

Completeness

It explicitly answers both questions: 'what' via the enumerated capabilities (micronaut-flyway setup, db/migration scripts, flyway.datasources.* configuration, JDBC/Micronaut Data alignment) and 'when' via 'Use when you need to add or review Flyway database migrations in a Micronaut application' followed by five concrete trigger request phrasings. This is the anchor-5 pattern; anchor 4 would apply only if the 'when' were generic rather than enumerating explicit trigger requests.

5 / 5

Trigger Term Quality

Good keyword coverage: 'Flyway database migrations', 'Micronaut', 'micronaut-flyway', 'db/migration', 'flyway.datasources.*', 'JDBC', 'Micronaut Data', 'versioned Flyway SQL migrations' — phrases users would naturally say. It falls short of anchor 5 because a few natural synonyms are absent, e.g. 'schema migration'/'schema evolution', '.sql' migration files, and 'V{n}__ naming', which the companion reference file itself uses.

4 / 5

Distinctiveness Conflict Risk

The intersection of Flyway + Micronaut is a clear niche with distinct triggers (micronaut-flyway, flyway.datasources.*, db/migration in a Micronaut project), and it even names its sibling skills '@511-frameworks-micronaut-jdbc' and '@512-frameworks-micronaut-data' to delimit boundaries. Minimal conflict risk — it would not fire for generic Flyway (non-Micronaut) or Liquibase work.

5 / 5

Total

19

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/plinth
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.