Content
68%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, token-efficient overview that correctly delegates detail to per-rule reference files. It falls short on actionability and workflow clarity: the body names almost none of the actual rule files, gives no explicit usage sequence, and omits validation guidance (e.g. verify optimizations with EXPLAIN ANALYZE) even though the bundle's own rules emphasize it.
Suggestions
In 'How to Use', state the file naming pattern (references/<prefix>-<topic>.md) or list the full rule-file index so any category in the priority table resolves to concrete files, instead of naming only 3 of ~35.
Add a short numbered workflow with a validation step, e.g. 1) identify the task's category, 2) read the matching references/<prefix>-*.md rules, 3) apply the correct SQL pattern, 4) verify with EXPLAIN ANALYZE / pg_stat_statements as shown in monitor-explain-analyze.md.
Remove the pointer to references/_sections.md (internal scaffold text) and other underscore-prefixed dev files (_contributing.md, _template.md) from user-facing navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: a terse 'When to Apply' bullet list, a compact 8-row category/priority table, and a short pointer to reference files. It explains nothing Claude already knows and contains no padding, matching 'Lean and efficient; assumes Claude's competence; every token earns its place'. | 5 / 5 |
Actionability | The only executable instruction is 'Read individual rule files', backed by a prefix table and three example paths (references/query-missing-indexes.md, query-partial-indexes.md, _sections.md). No SQL or commands appear in the body itself, and only 3 of the ~35 actual rule files are named, so a user with an RLS or pooling problem has no direct file to open — this is 'Some concrete guidance but incomplete ... missing key details' rather than the mostly-executable level-4 anchor. | 3 / 5 |
Workflow Clarity | 'How to Use' implies a loose process (pick a category, read its rule files, apply the correct SQL patterns) but never sequences it as steps, and there are no checkpoints such as verifying the fix with EXPLAIN ANALYZE after applying a rule. This matches 'sequence present but checkpoints missing or implicit'; the level-4 anchor requires a clearly laid-out sequence with most checkpoints present. | 3 / 5 |
Progressive Disclosure | The bundle structure is good: 35 one-level-deep rule files in references/, organized by filename prefix, with the body's priority table mapping categories to prefixes. But navigation is only inferable — the body lists just 3 example files without stating the references/<prefix>-<topic>.md naming pattern, and it points to _sections.md, an internal scaffold file whose own text says 'Take the examples below as pure demonstrative', which should not be surfaced to skill consumers. This is 'Good structure ... references mostly clear; minor organization gaps' rather than the fully navigable level-5 anchor. | 4 / 5 |
Total | 15 / 20 Passed |