CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

drizzle-orm-d1

| Type-safe ORM for Cloudflare D1 databases using Drizzle. Use when: building D1 database schemas, writing type-safe SQL queries, managing migrations with Drizzle Kit, defining table relations, implementing prepared statements, using D1 batch API, or encountering D1_ERROR, transaction errors, foreign key constraint failures, or schema inference issues.

65

Quality

82%

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

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 highly actionable, well-structured skill whose quick-start, critical rules, and error tables are copy-paste ready. Its weaknesses are padding from marketing claims and version banners, and a bundle/manifest mismatch where seven referenced template files are missing and one script is orphaned.

Suggestions

Create the missing templates/ files referenced in 'Common Patterns Summary', 'Configuration Summary', and 'Bundled Resources' (basic-schema.ts, basic-queries.ts, transactions.ts, relations-queries.ts, prepared-statements.ts, drizzle.config.ts, package.json) — or remove/fix those links so no referenced path 404s.

Trim the marketing footer ('Token Savings: ~65%', 'Error Prevention: 100%', 'Ready for production! ✅') and move the 'Secure Installation' section into a reference file or the linked skill to cut non-actionable tokens from the main body.

Consolidate time-sensitive details (pinned versions drizzle-orm@0.45.2 / drizzle-kit@0.31.10, 'Last Updated: 2025-12-14', the drizzle-kit 0.30/0.31 validation note) into a dedicated versioning/deprecated section or reference file so the main body stays stable, and reference scripts/check-versions.sh from the body so it is discoverable.

DimensionReasoningScore

Conciseness

Core tables and code are dense and useful, but the marketing footer ('Token Savings: ~65%', 'Error Prevention: 100%', 'Ready for production! ✅'), the off-topic 'Secure Installation' section, and prominent time-sensitive version/date banners ('drizzle-orm@0.45.2', 'Last Updated: 2025-12-14') outside any deprecated/old-patterns section add unnecessary tokens.

3 / 5

Actionability

Fully executable throughout: complete drizzle.config.ts, runnable schema definitions, copy-paste wrangler/npm commands, a working Worker fetch handler, and a concrete error→solution table covering the most common failure cases.

5 / 5

Workflow Clarity

The 5-step Migration Workflow is clearly sequenced with an explicit validation checkpoint ('Test local ... Verify locally', '--local before --remote'), so the missing-validation cap does not apply; however, no explicit fix-and-retry feedback loop is described for failed migrations, leaving a minor validation gap.

4 / 5

Progressive Disclosure

The 'When to Load References' table clearly signals one-level-deep references that all exist, but the body points to seven templates/* files (e.g., templates/basic-queries.ts, templates/drizzle.config.ts, templates/package.json) that do not exist in the bundle, and scripts/check-versions.sh is never referenced — navigation is materially impaired by the broken and orphaned paths.

3 / 5

Total

15

/

20

Passed

Description

88%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 with an explicit 'Use when:' clause, concrete capabilities, and distinctive error-based triggers. The only gaps are a few missing natural trigger terms (e.g., 'wrangler', 'Cloudflare Workers') and slightly generic Drizzle phrases that could overlap with non-D1 Drizzle skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'building D1 database schemas', 'managing migrations with Drizzle Kit', 'implementing prepared statements', 'using D1 batch API' — covering schema, queries, migrations, relations, and error scenarios comprehensively, matching the top anchor rather than the 'minor gaps' level below.

5 / 5

Completeness

Explicitly answers both: what ('Type-safe ORM for Cloudflare D1 databases using Drizzle') and when ('Use when: building D1 database schemas, ... or encountering D1_ERROR, transaction errors, ...') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage including pasted error text ('D1_ERROR', 'foreign key constraint failures'), but common user phrasings like 'wrangler', 'Cloudflare Workers', or D1 HTTP-driver setup terms are missing, so it falls just short of comprehensive.

4 / 5

Distinctiveness Conflict Risk

The Drizzle + Cloudflare D1 niche is clear and error-code triggers are distinctive, but generic phrases like 'managing migrations with Drizzle Kit' and 'defining table relations' would also fire for non-D1 Drizzle usage (e.g., Postgres), a minor overlap risk with closely related skills.

4 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

secondsky/claude-skills

Path

plugins/drizzle-orm-d1/skills/drizzle-orm-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.