CtrlK
BlogDocsLog inGet started
Tessl Logo

413-frameworks-quarkus-db-migrations-flyway

Use when you need to add or review Flyway database migrations in a Quarkus application — quarkus-flyway extension, db/migration scripts, quarkus.flyway.* configuration, migrate-at-start, and alignment with JDBC or Panache. This should trigger for requests such as Add or review Flyway migrations in a Quarkus project; Configure quarkus-flyway or db/migration layout; Add versioned Flyway SQL migrations for Quarkus; Review Quarkus database migration ordering; Configure Flyway clean migrate or baselines in Quarkus. Part of Plinth Toolkit

69

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

70%

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

The content is a well-structured overview with strong workflow validation and clean one-level-deep references. Its main weakness is actionability: it relies on references for the actual migration/config examples rather than showing one inline.

Suggestions

Add one minimal inline example — e.g. a sample V1__add_table.sql under src/main/resources/db/migration and the matching quarkus.flyway.migrate-at-start=true config — so guidance is actionable without opening references.

Dedupe the trigger list: the 'When to use this skill' bullets repeat the description's 'This should trigger for requests such as' list; keep one location and cross-reference.

Collapse 'What is covered in this Skill?' and 'When to use this skill' into a single section to reduce overlap and save tokens.

DimensionReasoningScore

Conciseness

The body is mostly efficient with no concept-padding, but the 'What is covered in this Skill?', 'When to use this skill', and description trigger lists overlap, so it could be tightened.

2 / 3

Actionability

It gives concrete commands (./mvnw compile, mvn clean verify) and specific config keys (quarkus.flyway.migrate-at-start, db/migration), but defers actual SQL migration and config examples to the references rather than providing copy-paste-ready guidance inline.

2 / 3

Workflow Clarity

The 4-step workflow includes explicit validation checkpoints — MANDATORY compile-before, SAFETY stop-on-failure, and VERIFY clean verify-after — giving a clear sequence with feedback loops appropriate for migration operations.

3 / 3

Progressive Disclosure

The body is a concise overview that points one level deep to three real, clearly signaled reference files (flyway, antipatterns, parallel-change) via a dedicated Reference section.

3 / 3

Total

10

/

12

Passed

Description

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.

The description is specific, trigger-rich, and clearly distinguishes this skill via a focused Quarkus+Flyway niche. It answers both what and when with explicit, natural trigger phrasings.

DimensionReasoningScore

Specificity

Lists multiple concrete actions such as 'add or review Flyway database migrations', 'Configure quarkus-flyway or db/migration layout', and 'Configure Flyway clean migrate or baselines', matching the multiple-specific-actions anchor.

3 / 3

Completeness

The opening 'Use when you need to add or review Flyway database migrations in a Quarkus application' states what it does, and the trigger list plus 'Use when' clause explicitly answer when to use it.

3 / 3

Trigger Term Quality

The explicit 'This should trigger for requests such as...' list gives natural phrasings a user would say (e.g. 'Add versioned Flyway SQL migrations for Quarkus', 'Review Quarkus database migration ordering'), covering common variations.

3 / 3

Distinctiveness Conflict Risk

The narrow niche of 'Flyway database migrations in a Quarkus application' with Quarkus-specific extension/config terms is unlikely to trigger for other, more generic skills.

3 / 3

Total

12

/

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.

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