Content
100%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.
Exemplary skill body: a lean overview with a clear sequenced workflow, explicit approval and validation checkpoints, and a well-organized one-level-deep reference bundle containing complete executable catalog queries. Nothing in the body is wasted or misplaced.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~26-line body is dense and lean with zero padding: every sentence adds non-obvious expert guidance (e.g., 'A function marked STABLE or IMMUTABLE is not a safety guarantee', 'placeholders cannot replace SQL identifiers in data queries') and none of it re-explains what Claude already knows. | 5 / 5 |
Actionability | The body gives concrete directives ('Check server_version_num first', 'use a read-only transaction and a reasonable statement timeout', 'validate a vetted read-only query with plain EXPLAIN') and delegates executable queries to reference files that verifiably contain complete, copy-paste-ready SQL with consistent $1/$2 placeholder conventions — appropriate and actionable for an instruction-only skill. | 5 / 5 |
Workflow Clarity | A clear 5-step workflow with explicit checkpoints and feedback loops: approval required before data-derived values, 'Ask the user when semantics remain ambiguous', 'If a query fails due to permissions or version differences, report the limitation instead of guessing', and a stop condition ('Stop once you can answer'). | 5 / 5 |
Progressive Disclosure | The body is a concise overview with well-signaled, verified one-level-deep references — all 12 linked files exist and match their roles (tables, views, routines, triggers, security, extensions, etc.), with cross-references between siblings explicitly gated ('Follow cross-references only when the question requires them'). | 5 / 5 |
Total | 20 / 20 Passed |