CtrlK
BlogDocsLog inGet started
Tessl Logo

vishnu/database-migration-helper

Creates and manages database migrations, including generating migration files, writing up/down migration logic, running schema changes, resolving migration conflicts, and testing rollbacks. Use when asked to add a column, rename a table, ALTER TABLE, create a migration file, run db migrate, handle schema changes, or work with migration tools like Alembic, Knex, Rails ActiveRecord, Flyway, or Liquibase.

72

Quality

90%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Content

77%

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

This is a solid, actionable skill with a clear workflow, explicit validation/rollback steps, and executable code examples across three frameworks. Its main weakness is that the inline framework examples make it longer than necessary — the content could benefit from splitting framework-specific details into separate files. The Key Rules section adds valuable safety constraints that complement the workflow well.

Suggestions

Consider moving framework-specific examples (Knex, Alembic, Rails) into separate referenced files (e.g., KNEX.md, ALEMBIC.md, RAILS.md) to keep the main SKILL.md as a concise overview with links to details.

The workflow step 4 ('Wrap in a transaction') could include a brief inline example of transaction wrapping rather than just mentioning it, since the code examples don't demonstrate this explicitly.

DimensionReasoningScore

Conciseness

The content is mostly efficient with good code examples and clear structure, but includes some slightly redundant framing (e.g., the workflow steps partially repeat what the examples already demonstrate). The three framework examples cover similar patterns which adds length, though each is reasonably lean individually.

2 / 3

Actionability

Provides fully executable, copy-paste ready code for three major frameworks with complete up/down migration examples and exact CLI commands for generating, running, rolling back, and checking status. Every instruction is concrete and specific.

3 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced with explicit validation (step 6: validate schema) and rollback testing (step 7: test the rollback). The Key Rules section reinforces safety constraints like never modifying applied migrations and using transactions for atomicity.

3 / 3

Progressive Disclosure

The content is well-organized with clear sections (Workflow, Framework Examples, Key Rules), but all three framework examples are inline rather than split into separate reference files. For a skill of this length (~80 lines of content), the framework-specific examples could be offloaded to separate files to keep the main skill leaner.

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

This is an excellent skill description that hits all the marks. It provides specific concrete actions, includes a comprehensive 'Use when...' clause with natural trigger terms spanning both user-level language ('add a column') and tool-specific references (Alembic, Knex, etc.), and is clearly distinguishable from other database-related skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: generating migration files, writing up/down migration logic, running schema changes, resolving migration conflicts, and testing rollbacks.

3 / 3

Completeness

Clearly answers both 'what' (creates and manages database migrations with specific sub-tasks) and 'when' (explicit 'Use when...' clause with concrete trigger phrases and tool names).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'add a column', 'rename a table', 'ALTER TABLE', 'create a migration file', 'run db migrate', 'schema changes', plus specific tool names like Alembic, Knex, Rails ActiveRecord, Flyway, and Liquibase.

3 / 3

Distinctiveness Conflict Risk

Clearly scoped to database migrations specifically, with distinct triggers like migration-specific tools and SQL DDL operations. Unlikely to conflict with general database query skills or other development 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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents