CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

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 body with excellent progressive disclosure into three real reference files and a clear compile/stop/verify safety workflow. The main weaknesses are token waste from duplicating the description in the 'When to use' section plus generic edge-case boilerplate, and the absence of a re-verify feedback loop.

Suggestions

Remove the 'When to use this skill' section or the duplicated trigger list — it repeats the frontmatter description verbatim and spends tokens without adding new information.

Trim the three generic EDGE CASE bullets (ask when ambiguous, report missing tools, surface constraint conflicts) to one line, since they restate default Claude behavior unrelated to Flyway specifics.

Add an explicit feedback loop after verification, e.g. 'If clean verify fails, fix and re-run until green' — the rubric flags missing re-validation in database-operation workflows.

DimensionReasoningScore

Conciseness

The body duplicates the frontmatter description verbatim in the 'When to use this skill' section, and three generic 'EDGE CASE' bullets ('If the user goal is ambiguous, stop and ask a clarifying question...') restate default Claude behavior Claude already knows. Not level 2 because the core content is terse with no concept explanations; not level 4 because the duplication and boilerplate are more than minor trimmable instances.

3 / 5

Actionability

Concrete commands are present ('Run ./mvnw compile or mvn compile', 'Run ./mvnw clean verify or mvn clean verify') and exact reference file paths are named, but workflow steps 2–4 stay high-level ('Implement or refactor configuration/code following the reference patterns'). Not level 5 because no inline config or migration example covers the common case; not level 3 because the commands and file pointers are executable and specific.

4 / 5

Workflow Clarity

The 4-step workflow (read references → gather scope → apply → verify and report) is clearly sequenced, and the Constraints section supplies explicit checkpoints: mandatory compile before changes, stop immediately on failure, full clean verify after. Not level 5 because there is no explicit fix-and-re-verify loop if verification fails — important for database operations.

4 / 5

Progressive Disclosure

The body is a clean overview: a coverage list, constraints, and a workflow that points to three real, existing reference files (main, antipatterns, parallel-change), each linked in the Reference section. All three bundle files verified on disk, one level deep with no nested references. This matches the level-5 anchor.

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 high-quality description with a clear what/when structure, explicit trigger phrases, and concrete technical scope. The only weakness is slightly limited synonym coverage for trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'add or review Flyway database migrations in a Quarkus application — quarkus-flyway extension, db/migration scripts, quarkus.flyway.* configuration, migrate-at-start' plus six distinct task types (configure layout, add versioned SQL, review ordering, configure clean/migrate/baselines). Coverage of the skill's capability space is comprehensive; not level 4 because there are no minor gaps — actions, artifacts, and config surface are all named.

5 / 5

Completeness

Explicitly answers both questions: the 'what' ('add or review Flyway database migrations in a Quarkus application — quarkus-flyway extension, db/migration scripts, quarkus.flyway.* configuration') and the 'when' via both 'Use when you need to...' and an explicit trigger list ('This should trigger for requests such as...'). This matches the level-5 anchor exactly.

5 / 5

Trigger Term Quality

Strong natural phrasing users would actually say ('Add or review Flyway migrations in a Quarkus project', 'Configure quarkus-flyway or db/migration layout', 'Review Quarkus database migration ordering'), plus config keys like migrate-at-start. Falls short of level 5 because common synonyms such as 'schema migrations', 'database evolution', or '.sql' file extensions are absent.

4 / 5

Distinctiveness Conflict Risk

The Quarkus+Flyway niche is very narrow and every trigger phrase is Flyway-migration-specific, so it will not fire for generic Quarkus work. The mention of 'alignment with JDBC or Panache' defines coordination boundaries with sibling skills rather than claiming their scope, keeping conflict risk minimal.

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

Path

skills/413-frameworks-quarkus-db-migrations-flyway/SKILL.md

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.