Content
88%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: numbered setup and performance workflows with explicit validation and error-recovery steps, executable commands, and a concrete gotchas section covering real pooled-connection failure modes. The main improvements are trimming the conceptual intro and moving the detailed diagnostics catalog into a reference file, as was done for search.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with platform-specific facts (LFC/prefetch EXPLAIN options, pooled-vs-direct failure signatures, diagnostic distinctions between `long-running-queries`, `outliers`, and `calls`) rather than generic Postgres tutorials, so it is above the anchor-3 "some unnecessary explanation" level. It is not 5 because of minor padding: the lakebase-architecture intro paragraph, the Databricks aside, and "It's fully compatible with Postgres and works with any language, framework, or ORM" restate things Claude can infer or that the parent skill covers. | 4 / 5 |
Actionability | Guidance is copy-paste executable: exact commands (`neon skills -s neon -y`, `neon inspect db <check>`, `neon env pull`), a complete SQL statement (`EXPLAIN (ANALYZE, BUFFERS, PREFETCH, FILECACHE)`), env-var names (`DATABASE_URL` vs `DATABASE_URL_UNPOOLED`), driver-specific notes with install commands, and concrete error signatures users will actually hit (`prepared statement "s0" already exists`, `SQLSTATE 25006`). This matches anchor 5: specific, ready-to-run examples covering the common cases. | 5 / 5 |
Workflow Clarity | Both the Setup Flow (numbered 1-4) and the Performance Workflow (numbered 1-5) are clearly sequenced, and the database-specific risk cap is satisfied: step 5 says "Re-run the same check and workload to verify the change" (explicit feedback loop), "Interpret Results Safely" adds ask-before-mutating checkpoints ("ask before running the suggested `CREATE EXTENSION` statement", confirm before `VACUUM FULL`), and error recovery is spelled out ("retry the relevant check with an explicit `databaseName` to isolate it"). Anchor 5 fits; 4 would understate the validation coverage. | 5 / 5 |
Progressive Disclosure | The Lakebase Search section cleanly offloads detail to four one-level-deep references that all exist in the bundle (references/vector-search.md, full-text-search.md, hybrid-search.md, lakebase-search-drizzle.md), and sibling skills (neon, neon-postgres-branches, postgres-best-practices) are signposted with fetch/install instructions. It is not 5 because the ~130-line troubleshooting/diagnostics section — candidate material for its own reference file, like the search material got — is fully inlined in SKILL.md. | 4 / 5 |
Total | 18 / 20 Passed |