Content
47%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.
The body reads as a lean pattern reference with correct core facts (pooled URL for the client, direct URL for migrations, PgBouncer limits), but it is not actionable: no code examples, no ordered setup steps, and the Sharp Edges and When to Use sections are non-informative placeholders. Fixing the placeholder table and adding concrete configuration examples would most improve it.
Suggestions
Replace the placeholder Sharp Edges table ("Issue | high | See docs") with real issues and concrete solutions, e.g. prepared-statement errors under PgBouncer transaction mode resolved via pgbouncer: true in the Prisma datasource block.
Add executable examples: a schema.prisma datasource block showing url = env("DATABASE_URL") and directUrl = env("DIRECT_URL"), plus example env values with the Neon -pooler suffix.
Remove the boilerplate "When to Use" sentence referencing a nonexistent overview and replace it with genuine applicability guidance (e.g., when to choose neon-http vs neon-serverless for Drizzle).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Patterns sections are lean bullet lists with no over-explanation of concepts Claude already knows, but the eight identical placeholder rows ("Issue | high | See docs") and the boilerplate "When to Use" sentence are wasted tokens. This matches "efficient with minor instances that could be trimmed", not 5, because the filler sections mean not every token earns its place. | 4 / 5 |
Actionability | There is no code, no commands, and no example connection strings; guidance like "Use two connection strings: DATABASE_URL: Pooled connection for Prisma Client / DIRECT_URL: Direct connection for Prisma Migrate" is a high-level hint missing the specifics to execute, and the Sharp Edges table provides no actual solutions. It is not 3 because nothing in the body is executable or copy-paste ready, and not 1 because the env-var names and their roles are concrete hints. | 2 / 5 |
Workflow Clarity | Configuration guidance is scattered as unordered pattern fragments: there is no sequence (no steps for obtaining the two URLs, configuring schema.prisma, or running migrations) and no validation checkpoints for database operations; "the workflow or actions described in the overview" references an overview that does not exist. It is not 3 because even a rough ordered sequence is absent, and not 1 because the content is coherent and the pooled-vs-direct distinction is clearly stated. | 2 / 5 |
Progressive Disclosure | The skill is under 50 lines with well-organized sections (Patterns subsections, Sharp Edges, When to Use) and no bundle files to disclose. It is not 5 because "See docs" in the Sharp Edges table is a dangling reference pointing to no actual document, and "described in the overview" points to a nonexistent section. | 4 / 5 |
Total | 12 / 20 Passed |