drizzle

I took a look at your drizzle skill and wanted to share some thoughts.

Links:

• GitHub
• Your skill on SkillzWave

The TL;DR

You're at 81/100, solid B-grade territory. This is based on Anthropic's skill best practices. Your strongest area is Ease of Use (22/25)—the metadata triggers and discoverability are really well done. Weakest area is Progressive Disclosure Architecture (24/30)—mainly because the file could be more efficiently layered and you're missing some navigation helpers for a ~270-line file.

What's Working Well

• Trigger phrases are sharp. You've got specific intent triggers like "create table" alongside artifact triggers like "pgTable" and even regex patterns for code detection. That's the kind of discoverability that actually helps agents find your skill.
• Templates are practical. The two template files (table-schema.ts.md and migration.ts.md) give concrete starting points, and your quick_start section includes real code examples with placeholders. People can actually copy-paste and iterate.
• Problem-solving is focused. You're tackling real Drizzle pain points: type exports, timezone handling, migration conflicts. Not abstract fluff—actual developer headaches.

The Big One: Missing Workflow Steps

Right now your quick_start shows code snippets but doesn't walk through the actual sequence. You jump from "here's Drizzle" to "here's a table definition" without the middle steps.

Why it matters: Developers using your skill want to know: fetch docs → create schema file → define table → export types → generate migration. That's the workflow.

The fix: Add a numbered workflow section before the code examples. Something like:

1. Use MCPSearch to fetch Drizzle docs
2. Create a new schema file (e.g., schema.ts)
3. Define your table using pgTable()
4. Export types for TypeScript safety
5. Generate and run migrations

This would bump your Ease of Use from 22→24 and PDA from 24→25.

Other Things Worth Fixing

1. Add a TOC at the top. At 270 lines, a brief table of contents (even 5-6 sections) helps navigation. Right now someone has to scroll to find the "Gotchas" or "Commands" sections.

2. Reduce template duplication. Your table-schema template mostly repeats what's already in quick_start. Make the template more about variations and edge cases, let quick_start own the canonical example.

3. Call out the MCP fallback. Your MCPSearch reference is great, but what if MCP tools aren't available? Add a note pointing to https://orm.drizzle.team/docs as the fallback.

4. Tighten some writing. A few sentences are still a bit descriptive (like "'near-zero overhead'"). Keep it tighter—you're mostly there, just a few edges to trim.

Quick Wins

• Add 5-step numbered workflow → +2 points
• Add TOC → +1 point
• Reduce template redundancy → +1 point
• Note MCP fallback → +1 point

You're very close to an A. These are all small structural improvements that would push you to 85+.

Checkout your skill here: SkillzWave.ai | SpillWave We have an agentic skill installer that install skills in 14+ coding agent platforms. Check out this guide on how to improve your agentic skills.