Skip to content

Convex Backup and Restore Drill

Set up Convex backups and prove they restore by running a test restore into a throwaway preview.

Stars
9,546
Licence
MIT
Files
1 file

What it does

This skill teaches an agent to take regular snapshot exports of a Convex app's data and set up a backup schedule matched to how much data loss is acceptable. Its main feature is a restore drill: the agent restores the snapshot into a disposable preview deployment, checks that row counts and sample records came back, and reports whether recovery actually worked. It also writes a gated runbook for restoring to production.

Great for

  • Developers running a Convex app who want a tested backup, not just an export file
  • Teams preparing for disaster recovery who want a restore rehearsed before it is needed

Skip it if

  • Apps not using Convex, since the commands are specific to the Convex CLI
  • Forward schema or data migrations, which belong to the separate migrate-rehearse skill (the restore drill is for recovery, not changes)
  • Users on plans without Preview Deploy Keys who cannot use a throwaway preview; the drill falls back to a personal dev deployment, which is less representative

Try asking

  • “Set up daily Convex backups and run a restore drill to confirm they work”
  • “Check that my last Convex snapshot restores with the expected row counts”
  • “Write a recovery runbook for restoring my Convex production data”
  • “Recommend a backup schedule and retention window based on how much data loss we can tolerate”
Step-by-step guide: how to use Convex Backup and Restore DrillInstall, 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.

    convex-backup.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip convex-backup.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip convex-backup.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

  • Check the deployment name and which deployment is production before the agent runs anything, since the drill and the runbook use different targets.
  • Review the drill result yourself; a failed drill is the most useful outcome and should be fixed before you rely on the backups.
  • Delete local snapshot files after the drill, because they contain real user data, and never commit them to git.

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.