Content
78%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, executable skill body: complete commands verified against the shipped script, a full config example, clear workflow, and appropriate single-file bundle organization. The main issues are a missing requirements.txt referenced in Setup, some non-actionable implementation-detail bullets, and an implicit rather than explicit validation step in the workflow.
Suggestions
Ship a requirements.txt containing psycopg2-binary (or replace the setup line with `pip install psycopg2-binary`) so the documented install command actually works.
Trim Safety Features bullets that describe internal script behavior Claude cannot change (column width cap, memory row cap) down to the one or two that affect usage decisions.
Add an explicit validation step to the Workflow, e.g. "Run --tables/--schema to verify the table exists and its columns before executing a query; if the query errors, check the Troubleshooting table and retry."
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — tables for config fields, database selection, and troubleshooting, with no explanation of concepts Claude already knows — but a few Safety Features bullets describe internal implementation details Claude cannot act on ("Column width cap: 100 char max per column", "Memory protection: Max 10,000 rows"), which is minor over-explanation that could be trimmed. This fits anchor 4 (efficient with minor trimmable instances), not 5 (every token actionable) and clearly not 3 (no padded or unnecessary conceptual sections). | 4 / 5 |
Actionability | Guidance is essentially copy-paste ready: complete executable commands for every operation ("python3 scripts/query.py --db production --query \"SELECT * FROM users LIMIT 10\""), a full connections.json example, and CLI flags that match the actual script. The gap is that Setup says "pip install -r requirements.txt" but requirements.txt does not exist in the bundle, so that command fails as shipped — a minor gap matching anchor 4 rather than 5, and well above anchor 3 (all real commands are executable, not pseudocode). | 4 / 5 |
Workflow Clarity | The Workflow section gives a clear four-step sequence (list → match intent → explore structure → query with LIMIT) with a decision checkpoint ("If unclear, run --list and ask user") and the Troubleshooting table supplies error-to-fix recovery paths. Validation is implicit rather than an explicit step (e.g., verifying a table via --tables before querying), which keeps it at anchor 4; it is above anchor 3 because the sequence and checkpoints are mostly present, and the destructive/batch cap does not apply since the skill is strictly read-only with write-blocking enforced. | 4 / 5 |
Progressive Disclosure | Structure is appropriate: SKILL.md is a well-organized overview (setup, usage, selection, safety, troubleshooting, exit codes) and the only bundle file, scripts/query.py, is correctly referenced and verified. Nothing that belongs in a separate file is inlined, references are one level deep, and navigation is trivial — matching anchor 5. Not 4, since there are no organization gaps or misplaced content. | 5 / 5 |
Total | 17 / 20 Passed |