CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cloudflare-d1

Cloudflare D1 SQLite database with Workers, Drizzle ORM, migrations

53

Quality

67%

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

Quality

Content

65%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.

The body is a strong, highly executable reference — commands and code are copy-paste ready and cover setup through deployment — but it ships as a monolithic ~660-line file with no progressive disclosure, redundant duplicated sections, and no validation/feedback loops around migrations and production deploys. Splitting reference material into bundle files and adding verify steps would address the weakest dimensions.

Suggestions

Move the query patterns, CLI quick reference, multi-environment setup, and testing sections into references/ files (e.g. references/queries.md, references/cli.md) and keep SKILL.md as a lean overview with clearly signaled links.

Add explicit validation checkpoints and error-recovery loops to the migration workflow: verify applied state with `wrangler d1 migrations list`, and instruct what to do when a remote apply fails.

Remove duplication — drop the raw SQL migration file that restates the Drizzle schema, and consolidate the raw-D1 and Hono CRUD examples into one canonical implementation plus a short alternative note.

DimensionReasoningScore

Conciseness

The body is mostly dense, useful code and tables with little prose explaining concepts Claude already knows, matching anchor 3's "mostly efficient but could be tightened". It is not a 4 because of clear redundancy: the migration SQL example restates the schema definition, the raw-D1 CRUD example duplicates the Hono CRUD routes, and the multi-environment wrangler.toml repeats the earlier config — several hundred lines that could be trimmed or split out.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready — "npx wrangler d1 create my-database", a complete drizzle.config.ts, schema.ts, Hono CRUD worker, query patterns, batch transactions, and a vitest integration test — covering the common cases end to end, which matches anchor 5. It avoids a lower score because the few gaps (how to obtain CLOUDFLARE_D1_TOKEN, installing wrangler as a dev dependency for unstable_dev) are edge details, not missing common-case steps.

5 / 5

Workflow Clarity

The overall sequence (create project → create database → configure → generate/apply migrations → implement worker → dev/test → deploy) is clear and one validation checkpoint exists ("Preview first (dry run)" for remote migrations), but this is a database-operations skill with no feedback loops: no verify-after-apply step, no guidance for handling failed migrations, and no pre-deploy verification. Per the rubric's cap on database/batch operations missing validation loops, workflow clarity is capped at 3; it is not a 2 because the sequence itself is coherent and well-ordered.

3 / 5

Progressive Disclosure

The single SKILL.md has no bundle files (references/, scripts/, assets/ are absent) and inlines roughly 600 lines — query patterns, a full CRUD worker, CLI quick reference, multi-environment setup, and testing — that clearly belong in separate reference files, matching anchor 3's "content that should be separate is inline". It is not a 2 because the document is not minimally structured: section headers are consistent, a CLI quick-reference and a limits table aid navigation, and external doc links are clearly labeled; it is not a 4 because zero content is split out, so the whole payload loads into context on every invocation.

3 / 5

Total

14

/

20

Passed

Description

56%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.

The description is a precise stack noun-phrase with strong, distinctive keywords, but it never states what the skill actually does and omits any explicit trigger guidance ('Use when...'), capping completeness. Rewriting it as an action-led sentence with a when-clause would lift it substantially.

Suggestions

Rewrite the description in third-person action form, e.g. "Set up Cloudflare D1 databases, define Drizzle schemas, run and apply migrations, and query from Workers."

Append an explicit trigger clause: "Use when working with Cloudflare D1, Wrangler, wrangler.toml d1_databases bindings, or Drizzle schemas for Workers."

Include the natural trigger terms users actually say — "wrangler", "D1 database", "Drizzle Kit" — to round out keyword coverage.

DimensionReasoningScore

Specificity

"Cloudflare D1 SQLite database with Workers, Drizzle ORM, migrations" names the domain and stack components precisely but contains no action verbs whatsoever — it describes what the technology is, not what the skill does (no "create", "migrate", "query"). It sits between anchor 1 (no concrete actions, though this is far from entirely vague) and anchor 3 (which requires 1-2 concrete actions, absent here); anchor 2's "names the domain but actions are minimal or generic" is the best fit.

2 / 5

Completeness

The description conveys a clear-enough 'what' (D1 database work with Workers, Drizzle, and migrations) but contains no 'Use when...' clause, which per the judging guidelines caps completeness at 3. It is not a 2 because the 'what' is specific and informative rather than vague; it is not a 4 because the 'when' is entirely absent from the description field (the skill's separate when-to-use frontmatter field is outside the evaluated text).

3 / 5

Trigger Term Quality

Natural terms a user would say — "Cloudflare", "D1", "SQLite", "Workers", "Drizzle", "migrations" — are all present, matching anchor 4's "good keyword coverage; a few natural terms missing". It falls short of anchor 5 because common variations like "wrangler", "database", "ORM", or file/config triggers (wrangler.toml) are absent.

4 / 5

Distinctiveness Conflict Risk

"Cloudflare D1" plus "Drizzle ORM" carve out a clear, niche trigger set with minimal conflict risk, matching anchor 4 ("mostly distinct; minor overlap risk with closely related skills"). It is not a 5 because a generic Cloudflare Workers skill or a general Drizzle/SQLite skill would still compete for the same triggers, and no trigger phrase unambiguously routes D1-database work to this skill.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (661 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

alinaqi/maggy

Path

skills/cloudflare-d1/SKILL.md

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.