convex-migration-helper
Plan Safe Convex Data Migrations
Breaking Convex schema changes can fail deploys or damage production data. This skill guides safe rollouts, batched backfills, dry runs, and verification.
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "convex-migration-helper" from https://skillstore.io/skills/get-convex-convex-migration-helper.md and its manifest at https://skillstore.io/api/skills/get-convex-convex-migration-helper/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Your Agent should still show its plan and request any confirmation required by the security policy.
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "convex-migration-helper". A user table needs a new required role field for existing accounts.
Expected outcome:
- Deploy a widened schema with role optional.
- Backfill missing roles in batches with a dry run first.
- Verify no accounts remain unmigrated before making role required.
Using "convex-migration-helper". A team table is changing from a boolean plan flag to a plan enum.
Expected outcome:
- Add the new plan field while keeping the old flag optional.
- Write new documents in the new format during the transition.
- Remove old readers and fields only after verification passes.
Using "convex-migration-helper". A large table migration keeps timing out during local tests.
Expected outcome:
- Use the migrations component instead of collecting the whole table.
- Lower the batch size for heavy documents or high write traffic.
- Monitor migration status and retry from the saved cursor after failures.
Security Audit
SafeAll static findings were adjudicated as false positives. The apparent SQLite and shell execution findings are Convex ctx.db examples and Markdown backticks in documentation. No prompt injection, data exfiltration intent, or hidden malicious behavior was found in the reviewed skill files.
Risk Factors
⚙️ External commands (14)
🌐 Network access (1)
Share & cite this report
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
Copy report link
https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/get-convex-convex-migration-helper?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/get-convex-convex-migration-helper?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/get-convex-convex-migration-helper/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/get-convex-convex-migration-helper.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Academic citations (APA · BibTeX · CFF)
APA citation
get-convex. (2026). convex-migration-helper security audit report (audit version 4) [Author version unspecified]. Skillstore. https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4BibTeX citation
@techreport{get-convex-get-convex-convex-migration-helper-2026,
author = {get-convex},
title = {convex-migration-helper security audit report (audit version 4)},
institution = {Skillstore},
year = {2026},
number = {4},
url = {https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "convex-migration-helper security audit report (audit version 4)"
version: "unspecified"
type: report
authors:
- name: "get-convex"
date-released: "2026-07-05"
url: "https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4"
identifiers:
- type: other
value: "skillstore:get-convex-convex-migration-helper:audit:4"
description: "Skillstore immutable audit report identifier"
Skillstore Score
Why this score Evidence Confidence: HighWhat You Can Build
Add Required Fields Safely
Plan a rollout that adds optional fields first, backfills existing documents, then makes fields required after verification.
Prepare Zero Downtime Rollouts
Design staged deploys where application code handles old and new data formats during migration windows.
Refactor Existing Data Models
Map steps for field deletion, type changes, table splitting, orphan cleanup, and migration completion checks.
Try These Prompts
Review this Convex schema change and tell me whether it needs a data migration. Explain the deployment order and main risks.
Create a widen-migrate-narrow plan for adding a required field to an existing Convex table. Include verification and rollback notes.
Help me design a batched Convex migration with dry run, status monitoring, and safe batch sizing for this table.
Audit this Convex migration plan for production safety. Check schema widening, dual reads or writes, dry run coverage, and completion checks.
Best Practices
- Widen the schema before touching production data.
- Run a dry run and inspect status before production execution.
- Verify every document is migrated before narrowing the schema.
Avoid
- Making a field required before existing documents are backfilled.
- Using collect on large tables instead of a batched migration.
- Deleting legacy fields before readers and writers stop using them.
Frequently Asked Questions
What is widen-migrate-narrow?
Does this skill run migrations automatically?
When should I use @convex-dev/migrations?
Can it help with zero downtime?
Does it support small table migrations?
What should I do before production?
Developer Details
Author
get-convexLicense
MIT
Skillstore revision
r1
Version notice
The author did not declare a version.
Ref
30c73eac2afe762f6aa9c4553158769369d47351
Maintenance freshness
7/18/2026
Usage
3 downloads · 88 views
File structure