CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-migrate-rehearse

Rehearse a live-app schema change + backfill on a snapshot-seeded preview deployment, verify, then promote the proven change to prod with the snapshot as rollback.

63

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/convex-migrate-rehearse/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, operationally precise runbook: exact CLI invocations with flag-level gotchas, a correctly ordered rehearsal workflow with explicit validation gates and feedback loops, and honest treatment of destructive-risk details (fresh consent, rollback artifact, data-loss window, snapshot sensitivity). The only notable weaknesses are moderate redundancy between the Rules and Workflow sections and high-level direction on the two trickiest authoring steps (backfill and schema edit).

Suggestions

Trim the Rules section to points not already stated verbatim in the Workflow (e.g. keep only the sensitive-snapshot and @convex-dev/migrations rules) to cut redundancy.

Add a minimal example of the optional-then-tighten schema.ts change and a skeletal @convex-dev/migrations backfill definition so the two hardest steps are executable rather than directed.

State the migrate-order rule once, in one place, rather than in both step 4 and the Rules section.

DimensionReasoningScore

Conciseness

The body is dense with operational specifics — exact CLI flags, deployment-name targeting, key preconditions — and explains only Convex-specific gate behavior Claude cannot be assumed to know, not general concepts. It is not a 5 because the Rules section restates roughly half a dozen points already made in the Workflow (pre-change preview creation, --preview-name vs --deployment, fresh explicit yes, snapshot rollback caveat, snapshot sensitivity), which is more than trivially trimmable redundancy.

4 / 5

Actionability

Concrete, copy-paste-ready commands with exact flags appear at every step (`npx convex export --path snapshot.zip`, `npx convex deploy --preview-create migrate-<slug>`, `npx convex import snapshot.zip --deployment migrate-<slug>`, `--preview-name`, `import ... --replace --prod`), plus gotchas like the missing --preview-name flag on import. It is not a 5 because the two hardest steps — authoring the @convex-dev/migrations backfill and the optional-then-tighten schema edit — are directed at a high level with no example snippet, leaving minor gaps.

4 / 5

Workflow Clarity

The numbered 0–7 sequence is explicit with validation checkpoints and feedback loops exactly where the destructive/batch risk lives: the conformance gate fails on the preview copy with "fix and re-push until green", step 5 verifies behavior against migrated data, and the prod promote is gated on a fresh explicit yes and is a repeat of the proven run. Rollback (snapshot --replace) and data-loss caveats are stated plainly. This matches the top anchor: clear sequence, explicit validation, error-recovery loops for a batch/destructive process.

5 / 5

Progressive Disclosure

There are no bundle files (no references/, scripts/, or assets/), and the ~30-line body is well organized into a Workflow and Rules section with everything needed inline; per the rubric, a sub-50-line self-contained skill with well-organized sections scores 5. No content belongs in separate files and no nested or buried references exist.

5 / 5

Total

18

/

20

Passed

Description

63%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, action-dense description that clearly states what the capability does across the full rehearse-verify-promote-rollback lifecycle. Its main weaknesses are the complete absence of a 'Use when...' trigger clause and the omission of the most natural trigger terms (Convex, migration, database), which limit discoverability and leave minor overlap risk with sibling migration skills.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user wants to change a Convex schema on a live app with real data, run a schema migration or backfill against prod, or safely deploy a breaking schema change."

Include the platform name and the most common synonyms in the description ("Convex", "migration", "database schema") so natural user phrasings match.

Briefly distinguish the trigger from the plain 'migrate' capability (e.g. "Use this — not plain migrate guidance — when live prod data is involved") to reduce conflict risk with the sibling skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete, chained actions — "Rehearse a live-app schema change + backfill on a snapshot-seeded preview deployment", "verify", "promote the proven change to prod", "with the snapshot as rollback" — covering the full rehearse→verify→promote→rollback lifecycle of this capability comprehensively. It is not the level-4 anchor because no meaningful action in the workflow's scope is omitted; seeding, verifying, promoting, and rollback are all explicit.

5 / 5

Completeness

The 'what' is clear and multi-part (rehearse on snapshot-seeded preview, verify, promote to prod with snapshot rollback), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is fully concrete, and not a 4 because 'when' is entirely absent rather than merely implicit-but-presented.

3 / 5

Trigger Term Quality

Relevant natural terms are present ("schema change", "backfill", "preview deployment", "prod", "rollback", "promote"), but the most common user phrasings — "Convex", "migration"/"migrate", "database" — are absent, so a user asking to "migrate my Convex schema" would not naturally match. This sits between the 'some relevant keywords but missing common variations or synonyms' (3) and 'good keyword coverage' (4) anchors; the missing terms are the primary synonyms for the task, not just a few, so it falls to 3.

3 / 5

Distinctiveness Conflict Risk

The niche is clear and distinctive — snapshot-seeded preview rehearsal followed by proven-change promotion with a rollback artifact — so it would rarely trigger for unrelated skills. It is not a 5 because, without the word 'Convex' or 'migration', it has minor overlap risk with closely related deployment/migration skills (the body itself notes a sibling 'migrate' capability covering the plain optional-then-tighten guidance).

4 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
openclaw/clawhub
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.