CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

ai-unified-process/aiup-flyway

AI Unified Process migration layer - Flyway schema migrations from the entity model

84

1.00x
Quality

91%

Does it follow best practices?

Impact

85%

1.00x

2 of 3 eval scenarios. Add 1 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

82%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.

The body is a highly actionable, well-structured layer skill: concrete examples, naming conventions, a sequenced workflow with a validation checklist, and clear scope boundaries. Its weaknesses are modest — a few verbose passages and no explicit error-recovery loop after the step-7 validation for these database operations.

Suggestions

Add an explicit feedback loop after step 7: 'if any check fails, fix the migration and re-validate before updating the Markers table'.

Trim the duplicated /use-case-implement rules in 'Run Directly or from /use-case-implement' by referencing them once.

Link references/layer.md (or note its audience) somewhere in the body so both bundle files are discoverable from SKILL.md.

DimensionReasoningScore

Conciseness

Nearly every section carries project-specific rules Claude could not infer (checksum immutability, the Spring Boot 4 vs 3 Flyway starter split, Flyway 10 database modules) and it assumes SQL competence, but the prompt-injection paragraph and the repeated /use-case-implement rules in 'Run Directly' could be tightened, leaving a few over-explained spots.

4 / 5

Actionability

Guidance is fully executable: a complete example migration, file-naming examples, the exact marker comment format, migration-location resolution rules, and a copy-paste Handover template with concrete coordinates and module paths.

5 / 5

Workflow Clarity

The 9-step workflow has an explicit validation checklist (step 7) and guards destructive operations ('drops a table or a column without explicit confirmation'), but for database operations the error-recovery loop — what to do when validation fails — is implicit rather than a validate/fix/re-validate cycle, so it falls between the sequence-with-checkpoints and full-feedback-loop anchors.

4 / 5

Progressive Disclosure

The body is well sectioned and its one reference link, references/markers.md, is clearly signaled and exists in the bundle; however references/layer.md is present but unlinked from the body, and the ~200-line body keeps some peripheral detail (the classpath version matrix) inline, leaving minor organization gaps rather than a fully clean overview-to-reference split.

4 / 5

Total

17

/

20

Passed

Description

96%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 description: concrete and comprehensive about capabilities, with natural trigger phrases and explicit when-to-use guidance, plus a deliberate boundary against the test skills. The only weakness is a couple of over-broad trigger phrases that a sibling layer skill could also claim.

Suggestions

Narrow or qualify the generic triggers 'add a column' and 'set up the database schema' (e.g. 'add a column to the Flyway schema') to reduce overlap with persistence-layer skills.

Consider stating the stack.md-governed placement rule more briefly; the long first sentence carries detail that also appears in the body.

DimensionReasoningScore

Specificity

The description enumerates concrete actions — 'versioned V*.sql scripts with sequences, tables, snake_case columns, CHECK and UNIQUE constraints, and foreign keys from the entity model' plus marker commenting — comprehensive rather than leaving minor gaps, matching the level-5 anchor.

5 / 5

Completeness

It explicitly answers what (builds the migration layer with the listed artifacts) and when ('Use when the user asks to…' with concrete trigger phrases), matching the anchor for both what and when with explicit triggers.

5 / 5

Trigger Term Quality

It quotes natural user phrases ('create a migration', 'write a Flyway migration', 'add a column', 'create the tables for UC-001', 'set up the database schema') alongside synonyms (schema migration, DB migration, database versioning, SQL migration files), giving comprehensive keyword coverage.

5 / 5

Distinctiveness Conflict Risk

The Flyway/UC-layer niche is clear and it draws an explicit boundary ('Test data migrations belong to the test skills'), but generic triggers like 'add a column' and 'set up the database schema' leave minor overlap risk with closely related persistence or schema-setup skills, so it sits just below the minimal-conflict anchor.

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

Reviewed

On this page