Content
42%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 body has a sensible index-style design (priority table, per-category prefixes, signaled references), but it is undermined by referencing bundle files (rules/*.md, AGENTS.md) that are absent, providing no actionable content of its own, and ending with a duplicated, vacuous "When to Use" section. As shipped, the skill directs Claude to files that do not exist.
Suggestions
Ship the referenced bundle files (rules/query-missing-indexes.md, rules/schema-partial-indexes.md, rules/_sections.md, and AGENTS.md) or remove the references — as delivered, every pointer in the body is dangling and the skill has no usable content.
Delete the duplicate trailing "When to Use" section and its filler sentence ("This skill is applicable to execute the workflow or actions described in the overview.") — it duplicates the earlier section and conveys nothing.
Add one concrete worked example to the body (e.g., a single rule with incorrect SQL, correct SQL, and its EXPLAIN signal) so the skill is actionable even before the reader opens a rule file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and mostly efficient (priority table, terse bullets), but it contains a duplicated "When to Use" heading and a vacuous filler sentence ("This skill is applicable to execute the workflow or actions described in the overview.") that add tokens without information. This matches 'mostly efficient but could be tightened'; it is not a 2 because the padding is limited to one redundant section rather than several. | 3 / 5 |
Actionability | The body only describes rather than instructs: "Contains rules across 8 categories", "Each rule file contains: Brief explanation... Correct SQL example...". There is no executable guidance (no SQL, no commands, no concrete rule) in the body itself, and the referenced rule files (rules/query-missing-indexes.md, rules/schema-partial-indexes.md, AGENTS.md) do not exist in the bundle, so even the navigation guidance cannot be followed. This fits 'minimal concrete guidance; high-level hints but missing the specific steps to execute'; not a 1 because the category/priority table with prefixes is concrete navigational guidance. | 2 / 5 |
Workflow Clarity | An implied lookup workflow exists (consult the priority table, then read the relevant rule file, with AGENTS.md as the compiled fallback), but the sequence is implicit, the referenced files are missing, and the duplicate "When to Use" section with a meaningless sentence muddies the structure. This matches 'sequence present but checkpoints missing or implicit'; not a 2 because the priority table does give a clear prioritization scheme. | 3 / 5 |
Progressive Disclosure | The body is structured as an index with one-level-deep references that are clearly signaled (paths listed in a code block, a dedicated "Full Compiled Document" section), but none of the referenced files exist in the bundle — there is no rules/ directory and no AGENTS.md — so the disclosure structure is broken in practice. Per the guideline to score against the actual bundle structure, this lands at 'some structure but could be better organized'; not a 4 because dangling references are more than a minor organization gap. | 3 / 5 |
Total | 11 / 20 Passed |