CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-migration-helper

Plans Convex schema and data migrations with widen-migrate-narrow and @convex-dev/migrations. Use for breaking schema changes, backfills, table reshaping, or zero-downtime rollouts.

76

Quality

95%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

A well-structured skill body: concise, actionable, with a clearly sequenced multi-deploy workflow, explicit validation checkpoints, and clean progressive disclosure into two real reference files. Every dimension lands at the top anchor.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence; the schema-validation explanation is Convex-specific behavior Claude would not already know, so it earns its place rather than padding.

3 / 3

Actionability

Provides executable schema snippets and copy-paste commands such as `npx convex run migrations:myMigration '{"dryRun": true}'`, with deeper migration code appropriately deferred to references.

3 / 3

Workflow Clarity

The breaking-change workflow is sequenced as Deploy 1 / Migrate / Deploy 2 with explicit validation checkpoints (dry run, "Verify all documents are migrated") and a closing checklist.

3 / 3

Progressive Disclosure

The body is an overview that points to two real, one-level-deep reference files (migrations-component.md, migration-patterns.md), each clearly signaled with what it contains.

3 / 3

Total

12

/

12

Passed

Description

90%

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 concise, third-person description with an explicit "Use for" trigger and clear Convex-specific niche. The only weakness is that the capability is expressed as one planning verb rather than a list of distinct concrete actions.

Suggestions

Replace the single "Plans ... migrations" verb with a short list of distinct concrete actions (e.g., "Widen schemas, backfill data, and narrow schemas") to lift specificity to the top anchor.

Consider adding one or two more colloquial trigger phrasings (e.g., "migrating production data", "schema breaking changes") to broaden natural-term coverage.

DimensionReasoningScore

Specificity

Names the domain and methodology ("Plans Convex schema and data migrations with widen-migrate-narrow and @convex-dev/migrations"), but the actions collapse to a single verb rather than a list of distinct concrete actions as in the anchor-3 example.

2 / 3

Completeness

Explicitly states what it does and provides a "Use for ..." trigger clause covering multiple scenarios, answering both what and when.

3 / 3

Trigger Term Quality

"breaking schema changes, backfills, table reshaping, zero-downtime rollouts" gives good coverage of natural terms a Convex user would actually say.

3 / 3

Distinctiveness Conflict Risk

The Convex-specific migration niche with distinct triggers makes it unlikely to fire for the wrong skill.

3 / 3

Total

11

/

12

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.

Validation16 / 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.