BotShelf Vampire BOTSHELF VAMPIRE Register

GROK BOT TOOLS · SKILL

Migration plan review, no database execution

Reviews a migration file for locking, backfill size, code rollout order and recovery options. Returns risks and open questions, then stops before file changes; it never runs a migration against any database.

No sign-upSkillGrok BuildDatabasesUntested

Where it goes

Grok Build: save the file as .grok/skills/migration-plan-review/SKILL.md in the repository, or as ~/.grok/skills/migration-plan-review/SKILL.md for every project. It then shows up as the slash command /migration-plan-review.

First three moves

  1. Fill the blanks and save the text as ./.grok/skills/migration-plan-review/SKILL.md in the repository.
  2. In Grok Build, invoke /migration-plan-review with one migration file and its related local code change.
  3. Compare the operation risks and rollout order with the cited files, and supply missing engine or data size details before acting.

Where it stops

Blanks to fill

BlankWhat goes there
[REPOSITORY]Local repository containing the migration and application code.
[MIGRATION_FILE]Migration file to inspect without executing it.
[CODE_CHANGE]Related local code diff or revision range, including its base.
[ENGINE_DETAILS]Database engine, version and supplied notes about relevant operation behavior.
[DATA_PROFILE]Dated table size estimates, write activity and any supplied backfill limits; mark unknowns.

Replace every bracket. Leave none behind.

The text

Download SKILL.md Fork it Results & questions

---
name: migration-plan-review
description: Review a repository migration file for locking, backfill scope, rollout order and recovery options. Use when asked to assess a database change before execution.
when-to-use: review this migration, assess migration order, check backfill risks, inspect migration recovery
metadata:
  author: "BotShelf Vampire (unofficial, not xAI)"
  short-description: Migration review without database execution
license: MIT
---

# Migration plan review, no database execution

## When to use
Use this when I ask for a review of a proposed database migration and its related application change. Read files only; never execute the migration against any database, including local or disposable databases.

## Inputs and access
- Repository: [REPOSITORY].
- Migration file: [MIGRATION_FILE].
- Related diff and comparison base: [CODE_CHANGE].
- Engine, version and supplied behavior notes: [ENGINE_DETAILS].
- Dated size estimates and write activity: [DATA_PROFILE].
Use local sources. Do not connect to a database or request credentials.

## Steps
1. Read repository guidance and record the migration revision and code comparison. List schema operations and data updates in their written order.
2. For each operation, identify affected tables, indexes and constraints. Use supplied engine details to discuss possible locks, scans or rewrites. Separate supported behavior from questions that need an engine specialist.
3. Inspect backfill predicates, batching, transaction scope, progress tracking and restart behavior. Relate the affected data estimate to the proposed batch size. Do not invent row counts or completion times.
4. Trace old and new application reads and writes. Describe which schema each version expects and whether both can coexist during rollout. Flag removals or constraints that require a preceding code or data change.
5. Read the reversal steps. Distinguish restoring a schema from restoring lost data. List assumptions about backups, retained columns or a forward repair, and mark any irreversible operation.
6. Order the concerns by impact and attach file and line evidence. Propose review questions and sequence changes without editing files.

## Check the result
Account for every migration operation. Ensure each recovery suggestion addresses both schema and data. A reversal script alone is not evidence that recovery will succeed.

## What to return
Return an operation risk table, backfill questions, proposed rollout order and recovery limits. Include source revisions, unknowns and any unread scope.

## Needs my approval
Ask before editing files, committing, pushing, merging, deploying or force operations. Stop before sending, publishing, purchasing, paying, deleting or changing production. This review never runs migrations or database commands.

## If data is missing or stale
Missing engine details or data estimates leave dependent conclusions open. If a source revision changes, mark affected findings stale and request the current files. Return completed observations separately from unresolved questions.

License: MIT. Free, no sign-up. Use is at your own risk. BSV does not run it or set it up for you.

What it adds to the official page

The official page describes the Grok Build skill format. This text adds a migration operation inventory, rollout ordering checks and recovery questions without database execution.

Sources

The product facts in this text come from these official pages, read on 2026-11-18. Products change: when a page and this text disagree, the page is right.

All Grok Bot tools Download all (ZIP) Search the shelf