CtrlK
BlogDocsLog inGet started
Tessl Logo

d1-migration

Cloudflare D1 migration workflow: generate with Drizzle, inspect SQL for gotchas, apply to local and remote, fix stuck migrations, handle partial failures. Use when running migrations, fixing migration errors, or setting up D1 schemas.

73

Quality

90%

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

88%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 lean, highly actionable migration workflow with explicit validation checkpoints and error-recovery loops. It is self-contained and well-structured, though no bundle files are used to split detail outward.

DimensionReasoningScore

Conciseness

Mostly efficient with copy-paste commands and brief rationale, but a few explanatory asides ('Local-only migrations cause confusing works locally breaks in production issues') could be trimmed; sits above the 3 anchor but not fully lean enough for 5.

4 / 5

Actionability

Fully executable guidance throughout — concrete `pnpm`/`wrangler` commands, copy-paste SQL fixes, and a complete TypeScript batching example covering the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The five-step flow is clearly sequenced with an explicit Verify checkpoint (PRAGMA table_info for both local and remote), plus a diagnosis→fix feedback loop for stuck migrations and batching guidance for the destructive/batch case, matching the 5 anchor and satisfying the validation requirement.

5 / 5

Progressive Disclosure

Well-organized with clear section headers and cohesive single-file content that legitimately belongs together with no nested references, but it is a monolithic file rather than an overview pointing to one-level-deep references, fitting the 4 anchor.

4 / 5

Total

18

/

20

Passed

Description

92%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, specific description that clearly states both capabilities and trigger conditions for a well-scoped D1/Drizzle migration skill. The only minor gap is trigger-term synonym coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'generate with Drizzle, inspect SQL for gotchas, apply to local and remote, fix stuck migrations, handle partial failures' — giving comprehensive coverage of the migration workflow, matching the 5 anchor.

5 / 5

Completeness

Explicitly answers both 'what' (the five workflow actions) and 'when' ('Use when running migrations, fixing migration errors, or setting up D1 schemas') with concrete trigger phrases, matching the 5 anchor.

5 / 5

Trigger Term Quality

Includes natural phrases users would say ('running migrations', 'fixing migration errors', 'setting up D1 schemas') with good coverage, but misses common synonyms like 'drizzle migrations' or file-extension triggers, fitting the 4 anchor above the 3.

4 / 5

Distinctiveness Conflict Risk

Targets a clear niche — Cloudflare D1 with Drizzle ORM — with distinct triggers and minimal overlap risk with other skills, matching the 5 anchor.

5 / 5

Total

19

/

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
jezweb/claude-skills
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.