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 hub skill: the body stays lean, defers all SQL detail to 35 one-level-deep reference files, and communicates rule priorities through a compact table. Its weaknesses are incomplete navigation (only 3 of 35 rule files named, no task-to-file mapping beyond prefixes) and the absence of any validation/verification checkpoint in the workflow, which the rubric caps at 3 for database skills.
Suggestions
Replace the three arbitrary example paths in 'How to Use' with a complete task-to-file mapping, e.g. 'Writing or reviewing a query? Read references/query-*.md; designing a table? references/schema-*.md', so Claude can locate the right rule file without guessing from prefixes.
Add a verification step to the workflow, such as 'After applying a fix, confirm the improvement with EXPLAIN ANALYZE (see references/monitor-explain-analyze.md)' — the rubric expects a feedback loop for database operations and currently caps workflow clarity at 3 for its absence.
Drop references/_sections.md from the 'How to Use' block (it is an internal section-definitions file, not a rule file) and instead explain the filename prefix convention explicitly, e.g. one line noting that every rule file is named <prefix>-<topic>.md per the category table.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: a two-line overview, six 'when to apply' bullets, an 8-row priority table, and a short file-usage explanation with external links. Nothing explains Postgres basics Claude already knows, and every section carries information (priorities, prefixes, file layout) that is not derivable from the description. It matches the top anchor 'every token earns its place'; 4 would require over-explanation worth trimming, and none is present. | 5 / 5 |
Actionability | The navigation mechanism is partially concrete — the category table maps tasks to filename prefixes ("query-", "conn-", "security-"...) and the file inventory in references/ matches — but the body gives no executable SQL or commands itself and the 'How to Use' code block names only 3 of the 35 rule files, with no instruction for mapping a task to the right file or a complete index. It sits at 'some concrete guidance but incomplete; missing key details' rather than 4, which would require the lookup guidance to be complete with only minor gaps. | 3 / 5 |
Workflow Clarity | The implied sequence (identify the task category → read the matching rule files → apply the incorrect/correct patterns) is present via the table and 'How to Use', but steps are never explicitly ordered and there are no validation checkpoints, e.g. no 'verify the fix with EXPLAIN ANALYZE' loop. Per the rubric's scoring notes, database-operation skills missing feedback loops are capped at 3; it is not 2 because the table-plus-prefix structure does convey a usable rough sequence. | 3 / 5 |
Progressive Disclosure | The bundle structure is genuinely good: SKILL.md is a short overview, all detail lives in one-level-deep references/*.md rule files (verified to exist), and the prefix convention makes files discoverable. It falls short of 5 because the body points to only three arbitrarily chosen files out of 35 and includes _sections.md (an internal section-definitions file) in the 'How to Use' block without explaining it, leaving navigation partially implicit — 'references mostly clear; minor organization gaps'. | 4 / 5 |
Total | 15 / 20 Passed |