Content
92%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 is a lean, highly actionable instruction set: a five-mode selection table, a seven-step workflow with explicit validation and a learning feedback loop, exact output schemas (ledger fields, confidence labels, output template), and clean offloading of detailed map/Feynman procedures to two real one-level-deep reference files. Its only flaw is mild redundancy between the trigger section, Anti-Patterns, and Cross-References.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — mode table, field-level ledger spec, exact confidence labels — with zero padding or explanations of concepts Claude already knows. Minor redundancy keeps it below the 5 anchor: the 'Use This Skill When' bullets restate the frontmatter description, Cross-References repeats the earlier 'Do not use this skill for discovering sources' line, and several Anti-Patterns (e.g. 'Do not quote data without its unit, time range, population...') restate the step-5 checks. It is clearly above the 3 anchor, which requires unnecessary explanation. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: a mode-selection table with deliverables, atomic-unit definitions for the argument tree, an exact evidence-ledger field table, four fixed confidence labels, a Good/Bad central-claim example, and a numbered 9-item default output template. Per the rubric's scoring note, absence of code is not penalized when the guidance is this concrete, so it meets the 5 anchor ('specific examples cover the common cases') rather than the 4 anchor with minor gaps. | 5 / 5 |
Workflow Clarity | A clear 7-step sequence with explicit validation checkpoints — step 1 verifies extraction usability and instructs stopping claims that depend on missing material, step 5 runs a concrete reasoning checklist — and a genuine feedback loop in step 7 (closed-book explanation, compare to ledger, locate the first missing link, repair only that gap, transfer question). This matches the 5 anchor's 'explicit validation steps; feedback loops', not the 4 anchor where checkpoints are only mostly present; no destructive or batch operations apply. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview that defers detailed procedures to two real, well-signaled, one-level-deep references: `references/knowledge-map.md` (pointed to in the mode table) and `references/feynman.md` (pointed to in the mode table and step 7); both files exist and contain no nested references. Detailed mode procedures are appropriately split out of the main body, matching the 5 anchor's clean structure and navigation. | 5 / 5 |
Total | 19 / 20 Passed |