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.

68

Quality

86%

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

78%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 well-structured, efficient overview of a genuinely non-obvious workflow (schema validation gating forces widen-migrate-narrow), with executable commands and both validation steps and a checklist for batch operations. The main gaps are minor: a few padded explanatory sentences and no explicit recovery loop when verification fails.

DimensionReasoningScore

Conciseness

The body is mostly lean — the schema-validation constraint, the widen-migrate-narrow pattern, and the pitfalls are Convex-specific knowledge Claude would not already have. A few sentences drift toward over-explanation ("This is the fundamental constraint that shapes every migration", "This makes the transition safer and easier to roll back"), landing it on anchor 4 rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Concrete, executable guidance throughout: TypeScript schema snippets, the numbered three-deploy workflow, a real command (`npx convex run migrations:myMigration '{"dryRun": true}'`), and a copy-ready checklist. It falls short of anchor 5 only because the core migration code patterns are delegated to references rather than shown inline for the common cases.

4 / 5

Workflow Clarity

The multi-deploy workflow is a clearly sequenced numbered list with validation checkpoints (dry run, "Verify all documents are migrated") and a full migration checklist, satisfying the batch-operation validation requirement. Not anchor 5 because the error-recovery feedback loop is implicit — the skill says verify but never says what to do when verification fails or a deploy is rejected.

4 / 5

Progressive Disclosure

The body is a genuine overview: concepts, safe-vs-breaking changes, workflow, and pitfalls inline, with the two real reference files (`references/migrations-component.md`, `references/migration-patterns.md`) clearly signaled with explicit scope descriptions ("See references/migration-patterns.md for complete patterns with code examples covering: ..."). One level deep, well navigable — matches anchor 5 exactly.

5 / 5

Total

17

/

20

Passed

Description

87%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 strong description in third-person voice with a clear what-and-when structure and an explicit 'Use for' trigger clause. Trigger terms are natural and domain-specific. Only minor room to grow via broader synonym coverage in the trigger list.

DimensionReasoningScore

Specificity

The description names the domain and several concrete actions — "Plans Convex schema and data migrations with widen-migrate-narrow and @convex-dev/migrations" — which is more than 1-2 actions but has minor coverage gaps (e.g., verification/rollback is only implied via 'zero-downtime rollouts'). It sits between anchor 3 and anchor 5, matching anchor 4's 'several specific actions; minor gaps in coverage'.

4 / 5

Completeness

It explicitly answers both: what ("Plans Convex schema and data migrations with widen-migrate-narrow and @convex-dev/migrations") and when ("Use for breaking schema changes, backfills, table reshaping, or zero-downtime rollouts"), with concrete trigger phrases. This matches anchor 5 exactly; it is not anchor 4 because the 'when' clause is fully explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Trigger terms "breaking schema changes, backfills, table reshaping, or zero-downtime rollouts" are natural phrases a user with this need would say. It falls just short of anchor 5's comprehensive synonym coverage (e.g., 'migration script', 'column type change', 'backfill data' as variations), so anchor 4's 'good keyword coverage; a few natural terms missing' is the best fit.

4 / 5

Distinctiveness Conflict Risk

The Convex-specific niche ("Convex schema and data migrations", "widen-migrate-narrow") gives it a clear trigger surface with minimal overlap risk against generic database or ORM skills. Matches anchor 5's 'clear niche with distinct triggers'; anchor 4 would require some noticeable overlap with a closely related skill, which is not the case.

5 / 5

Total

18

/

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.