CtrlK
BlogDocsLog inGet started
Tessl Logo

convex-migrate

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

59

Quality

74%

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/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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, well-structured skill that captures the safe migration ordering (optional, backfill, verify, then tighten) with strong guardrail rules. Its weakness is actionability: no executable commands or code examples for installing the migrations package, writing a migration function, running it, or verifying rows.

Suggestions

Add executable commands for each step: the npm/pnpm install command for @convex-dev/migrations, the CLI command to run the migration, and a concrete validation query to verify rows are valid.

Include a minimal migration function example showing the expected shape of a backfill migration.

Add an error-recovery feedback loop for step 3 (what to do when row verification fails), and deduplicate the Rules that restate workflow steps.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no concept explanations, no padding, every section instructs. It is not level 5 because the Rules section partially restates the workflow ("Add new fields as optional first, migrate, then require" duplicates workflow steps 1 and 4), leaving minor redundancy that could be trimmed.

4 / 5

Actionability

The strategy is concrete (optional first, backfill, then require) and names the package, but there is no executable code or command anywhere: no install command, no migration function example, no run command, and no concrete verification command. This matches the anchor for some concrete guidance that is incomplete with missing key details; it exceeds level 2 because the ordering and package choice are specific, not just high-level hints.

3 / 5

Workflow Clarity

A clear four-step sequence with validation checkpoints present ("Run the migration; verify all rows are valid", "Verify row counts before and after", and the never-tighten-early rule). Validation steps exist, so the destructive/batch cap of 3 does not apply, but there is no explicit error-recovery feedback loop (what to do when verification fails) and verification lacks a concrete command, keeping it below level 5.

4 / 5

Progressive Disclosure

The skill is under 50 lines, has no external bundle files, and needs none at this size; sections are well-organized (overview, Workflow, Rules). Per the guidelines, this qualifies for a top score with just well-organized sections.

5 / 5

Total

16

/

20

Passed

Description

65%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 concise, specific, and highly distinctive description that clearly states what the skill does and with which tool. Its main weakness is the complete absence of a "when to use" trigger clause, which caps completeness and limits natural trigger-phrase coverage.

Suggestions

Append a 'Use when...' clause with concrete trigger phrases, e.g. 'Use when a Convex schema change requires migrating or backfilling existing production data.'

Include natural trigger variations such as 'production', 'live database', or 'schema migration' to broaden keyword coverage.

Mention the run/verify lifecycle (e.g. 'run migrations and verify data') to round out the action coverage.

DimensionReasoningScore

Specificity

"Migrate schema + backfill data" names the domain (Convex schema migration) and two concrete actions plus the tool "@convex-dev/migrations" and the "deployed" context. This matches the anchor for 1-2 concrete actions that is not comprehensive; it lists fewer actions than the level-4 example's several specific actions and has no vague filler that would push it below.

3 / 5

Completeness

The description has a clear "what" (migrate schema and backfill data using @convex-dev/migrations on a deployed app) but no "Use when..." clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. It is not level 2 because the "what" is specific rather than vague; the "when" is only weakly implied by "deployed".

3 / 5

Trigger Term Quality

"migrate", "schema", "backfill data", and "Convex" are precisely the natural terms a Convex user would say when needing this skill, comparable to the level-4 example's coverage. It falls short of level 5 because common variations like "production", "live database", or "schema migration" phrasing are absent.

4 / 5

Distinctiveness Conflict Risk

"Convex" and the exact package "@convex-dev/migrations" give this a clear niche with distinct triggers and minimal conflict risk with other skills. No other common skill domain would claim these terms.

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