Content
72%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 excellent, information-dense reference with copy-paste-ready SQL and precise PostgreSQL-specific guidance, weakened only by internal redundancy and the absence of any explicit design workflow or verification steps. The lack of any bundle structure means all detail is inlined in SKILL.md rather than progressively disclosed.
Suggestions
Add a short sequenced design workflow with verification checkpoints (e.g., 1. gather access patterns, 2. normalize, 3. pick types/constraints, 4. add indexes, 5. verify with EXPLAIN ANALYZE and test in a transaction with ROLLBACK) — the current body is a catalogue with no explicit process.
Split detail-heavy sections (Extensions, JSONB Guidance, the type-by-type catalogue) into one-level-deep reference files with clearly signaled pointers from SKILL.md, keeping the core rules inline.
Deduplicate the "Do not use the following data types" section against the "Data Types" and "Core Rules" sections — the same prohibitions (timestamp, char(n), money, geometric types) are stated two or three times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, terse, and assumes Claude's competence — every bullet carries a concrete recommendation (e.g., "Prefer TIMESTAMPTZ for event time; NUMERIC for money", TOAST strategies with exact ALTER syntax) rather than explaining concepts. Not a 5 because there is noticeable redundancy: the "Do not use the following data types" section and parts of "Core Rules" restate guidance already given in "Data Types". | 4 / 5 |
Actionability | Guidance is fully executable throughout: exact DDL ("BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY", "CREATE INDEX ON tbl (user_id) WHERE status = 'active'", "EXCLUDE USING gist (room_id WITH =, booking_period WITH &&)"), three complete copy-paste CREATE TABLE examples, and concrete query patterns for JSONB indexing. Specific examples cover the common cases (users, orders, JSONB profiles). | 5 / 5 |
Workflow Clarity | The content is a well-organized reference catalogue, but there is no explicit design workflow — no sequenced steps (e.g., requirements → access patterns → normalize → types → constraints → indexes) and no verification checkpoints such as using EXPLAIN to confirm index usage. Safe-testing guidance exists ("BEGIN; ALTER TABLE...; ROLLBACK;" for transactional DDL), which keeps it from scoring lower, but checkpoints remain implicit, matching the anchor-3 profile. | 3 / 5 |
Progressive Disclosure | Section structure is clear and consistent (Core Rules, Gotchas, Data Types, Constraints, Indexing, Partitioning, workload-specific sections), but the entire ~200-line reference is inlined in SKILL.md with no bundle files or pointers — detail-heavy sections like Extensions, JSONB Guidance, and the type-by-type catalogue are prime candidates for one-level-deep reference files. This lands between the anchor-2 inlined-content case and better organization, matching anchor 3. | 3 / 5 |
Total | 15 / 20 Passed |