CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

database-migration

Master database schema and data migrations across ORMs (Sequelize, TypeORM, Prisma), including rollback strategies and zero-downtime deployments.

Quality

66%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/database-migration/SKILL.md

The canonical home for this skill is database-migration in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

53%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 delivers executable, ORM-specific migration examples with real commands, but it is padded with generic instruction boilerplate, its multi-step workflows lack explicit validation checkpoints, and its reference structure is broken: every listed bundle file is missing and the one in-instruction reference uses an inconsistent path. The skill reads as a code cookbook rather than a guided, navigable playbook.

Suggestions

Create the advertised bundle files (references/orm-switching.md, schema-migration.md, etc., assets/schema-migration-template.sql, scripts/test-migration.sh) or remove the Resources section, and fix the 'resources/implementation-playbook.md' path to match the actual layout.

Add explicit validation checkpoints to the destructive workflows (e.g. verify row counts after backfill, test down() on staging, confirm backup exists before running), so the blue-green and rename flows include validate-and-recover loops.

Delete the boilerplate 'Instructions' and 'Do not use this skill when' filler in favor of concrete, skill-specific guidance, and move the bulk of per-ORM examples into the referenced files to slim SKILL.md into an overview.

DimensionReasoningScore

Conciseness

Mostly efficient code examples, but padded by generic boilerplate instructions ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices and validate outcomes') and repeated Sequelize migration scaffolding across sections. It is not 2 because it never explains concepts Claude already knows; not 4 because the boilerplate and duplicated module.exports shells should be trimmed.

3 / 5

Actionability

Concrete, executable code with real run/rollback commands ('npx sequelize-cli db:migrate:undo', 'npm run typeorm migration:revert', 'npx prisma migrate deploy') covering common cases. Minor gaps keep it below 5: no Prisma rollback command, and 'npm run typeorm' assumes an unstated package.json script.

4 / 5

Workflow Clarity

Multi-step sequences exist (renaming columns in 3 steps, blue-green in 5 phases) but interim steps are only comment placeholders and lack validation checkpoints. Per the rubric's feedback-loop note, destructive database workflows without explicit validate-and-recover steps cap at 3; the transaction and checkpoint examples partially mitigate but do not sequence the main flows.

3 / 5

Progressive Disclosure

The Resources section lists seven bundle files (references/, assets/, scripts/), yet none exist, and the Instructions point to an inconsistent path 'resources/implementation-playbook.md'. The bulk of per-ORM detail is inlined in SKILL.md where the referenced files say it should live — content that clearly belongs in separate files is inlined with broken navigation, matching anchor 2.

2 / 5

Total

12

/

20

Passed

Description

66%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 specific, tool-named description that clearly conveys what the skill covers, but it omits any 'Use when' trigger guidance, which caps its completeness and weakens automatic triggering. It is distinguishable from generic database skills thanks to the explicit ORM names.

Suggestions

Append an explicit trigger clause, e.g. 'Use when migrating database schemas, switching ORMs (Sequelize, TypeORM, Prisma), or planning zero-downtime production migrations.'

Add natural user phrasings and synonyms such as 'schema change', 'migrate from X to Y', and 'migration rollback' to improve trigger term coverage.

Trim the 'Master' framing, which reads as buzzword padding rather than adding trigger value.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — 'schema and data migrations', 'rollback strategies', 'zero-downtime deployments' — anchored to a named domain. It falls between anchor 3 (only 1-2 actions) and anchor 5 (comprehensive coverage, e.g. omitting data-model refactoring and backup specifics), noticeably above the midpoint.

4 / 5

Completeness

It clearly answers 'what' (migrations, rollbacks, zero-downtime deployments) but has no 'Use when...' clause or equivalent explicit trigger guidance; per the judging guidelines a missing 'when' clause caps completeness at 3. It is not a 2 because the 'what' is concrete and specific.

3 / 5

Trigger Term Quality

Natural keywords users would say are present: 'database', 'schema', 'migrations', 'rollback', and the ORM names 'Sequelize', 'TypeORM', 'Prisma'. A few common variations are missing (e.g. 'schema change', 'migrate from X to Y', 'production deploy'), so it does not reach comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The ORM-specific scope (Sequelize, TypeORM, Prisma) and migration/rollback focus form a clear niche with minor overlap risk against generic database-administration skills. Not 5 since 'database' broadly could collide with general DB skills; not 3 since the named tools sharply narrow the trigger.

4 / 5

Total

15

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 7 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/database-migration/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.