Skip to content
Get packs

Convex Migration Lifecycle Guide

Guides an agent through planning, dry-running, applying and cleaning up ClawHub Convex production data migrations with approval gates.

Source Download skill
Repository
openclaw/clawhub
Stars
9,546
Licence
MIT
Files
1 file

What it does

This is a set of instructions that tells an AI coding agent how to run a production database change for the ClawHub Convex backend from start to finish: design the change, write and test the code, open a pull request, deploy, do a dry run, ask the human for approval, apply the change, verify it, and then remove the temporary code. The agent is told to stop and wait for explicit user confirmation before any destructive step and before deleting the migration code. It is written for maintainers of this specific repository and refers to other internal skills and files that are not included here.

Great for

  • Maintainers of the ClawHub Convex project who need to run a production backfill or cleanup
  • Developers who want a checklist-driven process for risky one-off data changes in Convex

Skip it if

  • Projects that do not use Convex or the ClawHub repository: it depends on repo-specific files and skills that are not in this package, so it will not work as written elsewhere
  • Unsupervised automation: it is designed to pause for human approval, and running it without a human reviewing dry-run and apply results would defeat its safety gates

Try asking

  • “Plan and implement a backfill that normalizes ownership fields in our Convex production tables”
  • “Write a dry-run and apply migration for removing a deprecated field, then guide me through the cleanup PR”
  • “Walk me through the production deploy and verification steps for this schema narrowing change”
Step-by-step guide: how to use Convex Migration Lifecycle GuideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    create-and-cleanup-migration.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip create-and-cleanup-migration.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip create-and-cleanup-migration.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Only use this with a repository that matches the ClawHub Convex setup; otherwise the referenced files and commands will be missing
  • Keep a human reviewer ready to confirm dry-run results before the agent runs any apply command against production
  • Note that the skill itself contains no scripts; any commands it suggests (deploys, migrations, production writes) would be executed by the agent with whatever credentials that environment has

What's inside

  • SKILL.md

Redistributed unmodified from openclaw/clawhub under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.