CtrlK
BlogDocsLog inGet started
Tessl Logo

review-data-migration

Review a code change for schema dump drift, swapped ID or enum mappings, irreversible migrations, missing backfills, deploy-window breaks, orphaned references, broken dual-writes, missing transactions, unsafe hot-table indexes, silent data loss, and missing post-deploy verification. Use when reviewing database migrations, schema changes, or data backfills.

75

Quality

94%

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

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

An exceptionally lean and expert-level review-lens skill that assumes Claude's competence throughout. The ordered method, explicit thresholds, and copy-paste fix commands make it immediately actionable; the only minor gap is telling the reviewer to supply sample verification SQL without offering one itself.

Suggestions

Include one short sample read-only verification query in the Reporting section (e.g., a grouped mapping-count SELECT) so the 'give sample read-only SQL' instruction has a concrete model to follow.

The Scope bullet 'Transactions and indexes' bundles two distinct checks; splitting it into transaction scope and online index creation would make the checklist marginally easier to scan.

DimensionReasoningScore

Conciseness

Phrases like 'The dump's version stamp should match the change's newest migration' and 'The fix is expand and contract: add, migrate readers and writers, remove only once nothing reads the old shape' deliver dense, non-redundant expertise with zero padding or explanation of concepts Claude already knows. Every line is either a check, a method step, a threshold rule, or a reporting instruction.

5 / 5

Actionability

The body gives concrete, executable commands ('git checkout <base> -- db/schema.rb', 'rerun bin/rails db:migrate', 'Diff the dump and db/migrate/ against the review's base ref, never an assumed main') plus specific inspection techniques ('Check each CASE or IF branch and constant hash entry individually'). It falls short of 5 because the reporting section says 'give sample read-only SQL that would prove it' without providing a sample, and not 3 because the guidance is directly executable as written, not pseudocode.

4 / 5

Workflow Clarity

The Method section gives an explicit ordered sequence ('check drift first... Then check migration correctness, then verification and rollback') with a guardrail ('Do not trust fixtures; production data shapes differ'), and the Threshold section acts as a report/don't-report checklist. This is a single-purpose, read-only review skill under 50 lines, so the simple-skill exception applies and no destructive-operation cap is triggered since the skill only reviews, never performs, destructive changes.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (no references/, scripts/, or assets/ bundle exists), and its content is organized into clear, well-labeled sections (Scope, Method, Threshold, Reporting). Per the rubric guideline, this earns a 5 with just well-organized sections.

5 / 5

Total

19

/

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 near-model description: third-person imperative voice, an exhaustive list of concrete capabilities, and an explicit 'Use when' trigger clause covering the three phrases users naturally say for this task. The only improvement space is a few missing synonyms in the trigger terms.

Suggestions

Add one or two natural trigger synonyms to the 'Use when' clause, such as 'migration files' or 'schema.rb/structure.sql changes', to broaden keyword coverage without adding length.

The eleven-item capability list is thorough but dense; grouping related checks (e.g., 'unsafe DDL such as hot-table indexes or precision-losing type changes') could reduce parsing cost while staying comprehensive.

DimensionReasoningScore

Specificity

The description enumerates eleven concrete, distinct checks: 'schema dump drift, swapped ID or enum mappings, irreversible migrations, missing backfills, deploy-window breaks, orphaned references, broken dual-writes, missing transactions, unsafe hot-table indexes, silent data loss, and missing post-deploy verification'. This is comprehensive coverage of the migration-review domain, matching the score-5 anchor; it exceeds 4 because the action list is exhaustive rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the long check list states exactly what the skill does, and 'Use when reviewing database migrations, schema changes, or data backfills' states when to invoke it with concrete trigger phrases. This matches the score-5 anchor verbatim in structure.

5 / 5

Trigger Term Quality

The 'Use when' clause includes natural terms users would say: 'reviewing database migrations, schema changes, or data backfills'. It falls short of 5 because common variations are missing — users also say 'migration files', 'schema.rb', 'ALTER TABLE', or 'data integrity' — but coverage is solidly good, not just 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The opening 'Review a code change for schema dump drift...' is a clear niche (database migration review), and the 'Use when reviewing database migrations, schema changes, or data backfills' trigger clause keeps it distinct from generic code-review skills. Terms like 'schema dump drift' and 'broken dual-writes' are unmistakably this skill's territory, minimizing conflict risk.

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
perihelionhq/perihelion-platform-context
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.