Content
71%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 content is highly actionable and dense, built around executable SQL and a concrete scoring rubric with a clear analysis→scoring workflow and a defined decision threshold. Its main weaknesses are repetition in the pattern examples, absent feedback loops for ambiguous outcomes, and a monolithic structure with no progressive disclosure into reference files.
Suggestions
Move the 'Common Patterns' schema catalog (the four good-candidate and three poor-candidate CREATE TABLE examples) into a references/ file (e.g., references/patterns.md) and keep a one-line summary with a clearly signaled link in SKILL.md, enabling one-level-deep progressive disclosure.
Trim duplication: the poor-candidate examples (users, user_settings) restate the Option B '❌ POOR' schema indicators — consolidate them into a single section to tighten conciseness.
Add a short validation/feedback step at the end of Step 2, e.g., what to do when a table scores near the threshold (6–8 points) or when no candidates are found (report why and confirm with the user), and add the missing growth-rate query needed for the 'Size: current size and growth rate' output requirement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — SQL, terse bullets, and point values — with no explanation of concepts Claude already knows, placing it above 3. It falls short of 5 because the 'Common Patterns' section repeats four nearly identical good-candidate schemas and the poor-candidate examples restate the Option B schema indicators, which could be trimmed. | 4 / 5 |
Actionability | Nearly all guidance is executable: copy-paste-ready SQL for table stats, indexes, pg_stat_statements (with an availability check), and constraints, plus a concrete point-based scoring rubric ('Has timestamp/timestamptz column: **3 points**'). Minor gaps — e.g., the required output 'Size: Current size and growth rate' has no query for growth rate, and several queries need placeholder substitution — hold it at 4 rather than 5. | 4 / 5 |
Workflow Clarity | A clear two-step sequence (schema analysis via Option A/B → candidacy scoring) with per-query 'Look for' checkpoints and an explicit decision gate ('8+ points = good candidate') plus an availability check for pg_stat_statements, matching the 4 anchor. It lacks 5's feedback loops — no guidance for ambiguous results, zero-candidate outcomes, or how to re-check when data is inconclusive. | 4 / 5 |
Progressive Disclosure | The file is well-sectioned with headers and a clear pointer to the companion 'migrate-postgres-tables-to-hypertables' skill, but it is a ~300-line monolith with no bundle files or reference structure — the 'Common Patterns' schema catalog and the ID-based special case are content that belongs in a separate references file. This matches the 3 anchor ('some structure but... content that should be separate is inline') rather than 4, which requires most bulk content placed in clearly signaled external files. | 3 / 5 |
Total | 15 / 20 Passed |