Agent skill

Convex Migrate

by openclaw in openclaw/clawhub

Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.

MITAuto-check passed

Install Convex Migrate

skills CLI
$ npx skills add openclaw/clawhub --skill convex-migrate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openclaw/clawhub convex-migrate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openclaw/clawhub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/convex-migrate .claude/skills/convex-migrate && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
convex-migrate
GitHub stars
9.5k
Token cost
~254 tokens
SKILL.md length
117 words
Files
1
Skills in repo
56
Repo updated
First seen
Licence
MIT

At a glance

Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.

  • Works in 4 steps: Make the new field optional first (so… → Install @convex-dev/migrations; write a… → Run the migration; verify all rows are… → …
  • SKILL.md covers Workflow and Rules
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Convex Migrate is an agent skill from openclaw/clawhub. Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.

Its SKILL.md is about 250 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Convex. The repository describes itself as: Skill + Plugin Registry for OpenClaw. The licence is MIT.

Example prompts

  • “/convex-migrate”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Make the new field optional first (so deploy doesn't reject existing rows).
  2. Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
  3. Run the migration; verify all rows are valid.
  4. Tighten the validator (make the field required) once the backfill is complete.

What it can do on your machine

Read from SKILL.md and the folder at commit c23e34a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Convex Migrate loads about 254 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 117 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~254

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from openclaw/clawhub at commit c23e34a, republished under its MIT licence (© openclaw). 117 words, ~254 tokens.

Download SKILL.mdSave it as .claude/skills/convex-migrate/SKILL.md (or your agent's skills folder).
name
convex-migrate
description
Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.
<!-- GENERATED from convex-agents content/capabilities/migrate.json — do not edit by hand. -->

Migrate the schema / data on a live app

Change a deployed schema without breaking existing data: stage the schema change, install @convex-dev/migrations, write a backfill that makes old rows valid, run it, and verify before tightening the validator.

Workflow

  1. Make the new field optional first (so deploy doesn't reject existing rows).
  2. Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
  3. Run the migration; verify all rows are valid.
  4. Tighten the validator (make the field required) once the backfill is complete.

Rules

  • Never tighten a validator before the backfill completes — it rejects existing rows and breaks the live app.
  • Add new fields as optional first, migrate, then require.
  • Verify row counts before and after.

© openclaw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/convex-migrate of openclaw/clawhub.

Open the folder on GitHubat commit c23e34a

Compare with similar skills

Convex Migrate next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Convex Migrate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Convex Migrate this skillopenclaw/clawhub9.5k—~254Automated safety check: PassMIT
Convex Migration Helperspokvulcan/poker-planning1148 repos~1.4kAutomated safety check: PassMIT
Convex Quickstartspokvulcan/poker-planning1146 repos~3.5kAutomated safety check: NotesMIT
Convex Agentswaynesutton/builder-skills404—~2.2kAutomated safety check: PassApache-2.0
Convex Best Practiceswaynesutton/builder-skills404—~2.6kAutomated safety check: PassApache-2.0
Convex Release Auditudecode/kitcn450—~1.8kAutomated safety check: PassApache-2.0

Similar skills

  • Convex Migration Helper

    spokvulcan/poker-planning

    Plans Convex schema and data migrations with widen-migrate-narrow and @convex-dev/migrations.

    114 GitHub starsUsed in 8 repos~1.4k tokens
    Product & Project ManagementAuto-check passed
  • Convex Quickstart

    spokvulcan/poker-planning

    Creates or adds Convex to an app. An agent skill from spokvulcan/poker-planning.

    114 GitHub starsUsed in 6 repos~3.5k tokens
    Frontend & DesignAuto-check: notes
  • Convex Agents

    waynesutton/builder-skills

    Builds AI agents on the Convex agent component: threads, messages, tools that call queries and mutations, streaming, RAG with vector search, and workflows for multi step jobs.

    404 GitHub stars~2.2k tokensUpdated 10 days ago
    AI & LLM EngineeringAuto-check passed
  • Convex Best Practices

    waynesutton/builder-skills

    Production patterns for Convex apps and the rules the @convex-dev/eslint-plugin enforces: validators, indexes, idempotent mutations, avoiding OCC conflicts, thin function wrappers, error handling.

    404 GitHub stars~2.6k tokensUpdated 10 days ago
    DevelopmentAuto-check passed
  • Audit newer Convex npm releases against kitcn. An agent skill from udecode/kitcn.

    450 GitHub stars~1.8k tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Convex Backend

    CloudAI-X/claude-workflow-v2

    Convex backend development guidelines. An agent skill from CloudAI-X/claude-workflow-v2.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from openclaw/clawhub

All 56 skills in this repo
  • Creates and manages Axiom monitors and notifiers end to end through the v2 API, with scripts for each CRUD operation and a recommended create-validate-tune workflow.

    9.5k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Axiom Dashboard Builder

    openclaw/clawhub

    Designs and deploys Axiom dashboards through the API, choosing chart types and writing APL or metrics queries, with templates and migration notes for Splunk and Grafana.

    9.5k GitHub stars~4.9k tokensUpdated today
    Auto-check passed
  • Axiom Cost Control

    openclaw/clawhub

    Finds unused data in Axiom by analyzing query patterns, then deploys a cost dashboard and ingest monitors to keep spend under the contract limit.

    9.5k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Axiom Metrics Query

    openclaw/clawhub

    Explores and queries OpenTelemetry metrics in Axiom MetricsDB, listing datasets, metrics and tags first and picking the right aggregation for each metric's type.

    9.5k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Axiom SRE Investigator

    openclaw/clawhub

    Investigates incidents and production problems with hypothesis-driven debugging, queries Axiom observability data when available, and keeps secrets out of commands and output.

    9.5k GitHub stars~7.1k tokensUpdated today
    Auto-check passed
  • Axiom Eval Writer

    openclaw/clawhub

    Scaffolds evaluation suites for the Axiom AI SDK: eval files, scorers, flag schemas and axiom.config.ts, generated from plain descriptions of an AI capability.

    9.5k GitHub stars~4.1k tokensUpdated today
    Auto-check: warnings

Works with

Questions about Convex Migrate

What does Convex Migrate do?

Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations. Convex Migrate is an agent skill from openclaw/clawhub. Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.

How do I install Convex Migrate in Claude Code?

Run `npx skills add openclaw/clawhub --skill convex-migrate -a claude-code`. Or copy the skill folder (.agents/skills/convex-migrate in openclaw/clawhub) into .claude/skills/convex-migrate in your project. Claude Code loads it when a task matches its description.

How do I install Convex Migrate in Codex?

Run `npx skills add openclaw/clawhub --skill convex-migrate -a codex`. Or copy the skill folder (.agents/skills/convex-migrate in openclaw/clawhub) into .agents/skills/convex-migrate in your project. Codex loads it when a task matches its description.

Can I use Convex Migrate in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openclaw/clawhub --skill convex-migrate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/convex-migrate, .gemini/skills/convex-migrate, .github/skills/convex-migrate and .opencode/skills/convex-migrate in your project.

What does Convex Migrate need to run?

SKILL.md names no scripts, command-line tools or credentials: Convex Migrate is instructions for the agent only.

Does Convex Migrate access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Convex Migrate safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Convex Migrate use?

Convex Migrate is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Convex Migrate use?

About 254 tokens (SKILL.md is roughly 1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Convex Migrate?

Skills that share tags, products or a category with Convex Migrate: Convex Migration Helper (spokvulcan/poker-planning, 114 stars), Convex Quickstart (spokvulcan/poker-planning, 114 stars), Convex Agents (waynesutton/builder-skills, 404 stars) and Convex Best Practices (waynesutton/builder-skills, 404 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Convex Migrate?

openclaw (a GitHub organization) maintains it in openclaw/clawhub, which has 9,495 GitHub stars. The repository holds 56 skills in this directory. The repository was last updated on October 7, 2026.

Source: openclaw/clawhub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.