Content
86%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 is a well-structured, highly actionable overview: executable SQL examples with verification steps, a clear workflow, constraint checklists, and a cleanly signaled one-level-deep reference layer. Remaining improvements are minor — trimming the redundant Knowledge Reference/When-to-Use sections and adding an explicit error-recovery branch to the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and actionable — executable SQL, brief interpretive hints ('Look for: Seq Scan (bad on large tables)'), and no explanation of PostgreSQL basics Claude already knows. Minor trimmable content remains: the 'Knowledge Reference' comma-list duplicates the frontmatter triggers, the persona intro line adds little, and 'When to Use This Skill' restates the description — fitting 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place score-5 anchor. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready SQL covering the common cases: a complete slow-query-to-fix end-to-end example (pg_stat_statements → EXPLAIN → CREATE INDEX CONCURRENTLY with partial index → verification → ANALYZE), a GIN/JSONB containment pattern, bloat monitoring, and replication lag queries. Specific tools and settings are named (pgBouncer, autovacuum_vacuum_scale_factor), matching the score-5 anchor. | 5 / 5 |
Workflow Clarity | The 5-step Core Workflow has a clear sequence with explicit validation checkpoints (verify indexes with EXPLAIN before and after creation, 'verify improvements after each change') plus MUST DO/MUST NOT checklists — database operations do have verification, so the score-3 cap does not apply. However, no explicit error-recovery feedback loop is stated (e.g., 'if the planner still uses a Seq Scan, then...'), which the score-5 anchor requires. | 4 / 5 |
Progressive Disclosure | Clear overview structure with a well-signaled Reference Guide table (Topic | Reference | Load When) pointing to five one-level-deep reference files, all of which exist and none of which nest further references. Common patterns kept inline are appropriately concise, matching the score-5 anchor for clear navigation and appropriate content splitting. | 5 / 5 |
Total | 18 / 20 Passed |