Content
82%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable skill body with copy-paste code and a clear numbered setup flow, supported by verified one-level references; the main weaknesses are some Claude-known orientation prose and the absence of explicit validation feedback loops.
Suggestions
Tighten the "What Is Neon" intro and the repeated "Key points" bullets to only Neon-specific facts Claude would not already know, trimming orientation padding.
Add an explicit validate→fix→retry checkpoint in the Setup Flow (e.g., confirm DATABASE_URL resolves and a test query succeeds before proceeding to ORM/schema steps).
Consider moving the full neon.ts defineConfig example into a reference file, keeping only a minimal snippet and a pointer inline to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and dense with actionable code and links, but includes orientation prose Claude already knows ("Neon is a serverless Postgres platform that separates compute and storage...", explanatory "Key points" lists) that could be trimmed; not below midpoint because the bulk earns its place. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance throughout — `npx -y neon@latest init --agent <agent-name>`, Drizzle + node-postgres and Drizzle + neon-http code blocks, neon.ts `defineConfig`, and `neon config plan/apply` commands covering the common cases. | 5 / 5 |
Workflow Clarity | The Getting Started section gives a clear numbered Setup Flow (steps 1–6) with a Check Status Quo pre-check and Resume Support, but lacks explicit validate→fix→retry feedback loops, so it sits at "clear sequence with most checkpoints" rather than the top anchor. | 4 / 5 |
Progressive Disclosure | Good structure as an overview pointing to one-level-deep references (verified real `references/neon-sdk.md`, the neon-postgres-branches skill, and docs URLs), though the inline neon.ts config section (~50 lines) is heavier than a pure overview would warrant. | 4 / 5 |
Total | 17 / 20 Passed |