Content
80%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.
An exemplary overview-style skill: token-efficient, dense with non-obvious product-specific facts, and well-structured progressive disclosure with a complete, verifiable reference bundle. The main gaps are the absence of a runnable connection example and of inline validation checkpoints for the destructive operations (schema changes, resharding) it routes to.
Suggestions
Add a minimal executable connection example (e.g., a psql or psycopg connection string using port 5432 and sslmode=verify-full) so the connecting guidance is copy-paste ready.
Include a brief inline validate-before-proceeding pattern for destructive or batch operations (e.g., run EXPLAIN (NEKI_PLAN) and confirm targeting with SHOW before cross-shard DDL, resharding, or VACUUM) instead of only hazard warnings.
Point reference links at relative bundle paths (references/*.md) rather than remote raw.githubusercontent.com URLs so the locally shipped files resolve directly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | A lean ~70-line overview where every fact is Neki-specific and non-obvious (no separate pooler port, typo'd __neki.* settings silently accepted, cross-shard snapshot caveat, VACUUM running on every shard); it assumes Claude's competence and explains nothing Claude already knows. | 5 / 5 |
Actionability | Provides concrete, executable specifics — port 5432 with sslmode=verify-full, the exact session-setting names, EXPLAIN (NEKI_PLAN), SHOW-based verification — but lacks a complete copy-paste example such as a full connection string, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The body is a navigation overview with one good verification checkpoint ('Confirm with SHOW on the real name', 'set them before BEGIN'), but destructive/batch operations it introduces (schema changes, resharding, VACUUM across shards) have no inline validation steps; per the rubric cap this holds at 3. | 3 / 5 |
Progressive Disclosure | Clear overview with 19 one-level-deep references, all of which exist in the local bundle, each with a per-row 'Use for' criterion making navigation easy; the only nit is that link hrefs point to remote raw GitHub URLs rather than relative paths, but link text matches the local references/*.md paths. | 5 / 5 |
Total | 17 / 20 Passed |