Content
53%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 well-written, lean router with concrete classification criteria, a fallback question, and specific file paths. Its structure is undermined by the fact that every referenced follow-up file (correction-driven.md, informative-capability.md, placement.md) is missing from the bundle, leaving the core workflow unexecutable, and the procedure lacks any post-edit verification checkpoint.
Suggestions
Add the three referenced files (correction-driven.md, informative-capability.md, placement.md) to a references/ directory, or inline their essential guidance — currently every "Load X" instruction points to a nonexistent file.
Make the procedure explicit as ordered steps (classify → load guide → choose placement → edit → confirm), adding a post-edit checkpoint such as re-reading the finished artifact with Josh to confirm the voice and location match the classification.
Extend the concreteness already present in the fallback question and file paths to the routed voices/processes themselves, so the skill remains actionable even before the reference files are opened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Quotes: the whole body is lean — "Before touching anything, identify which kind of work this is", the bulleted "When this skill fires" list, and the four-line "What this skill is NOT" guardrails. It never explains concepts Claude already knows, matching anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed"). Not 5: lines like "classifying wrong is the single biggest way this skill gets misapplied" are editorial padding beyond the instruction needed; not 3: there is no genuine over-explanation, only minor tightening opportunities. | 4 / 5 |
Actionability | Quotes: 'ask Josh in one sentence: "Is this you correcting a behavior, or you wanting me to know about a capability?"', "Editing the flat behavioral rules in claude/CLAUDE.md", "Load correction-driven.md before editing", "Load placement.md for both decisions". The classification procedure, fallback question, and file paths are concrete, but the pivotal "Load X" instructions point to files that do not exist anywhere in the bundle (no references/ directory), so the guidance cannot be executed as written — anchor 3 ("Some concrete guidance but incomplete... missing key details"). Not 4: the gap is broken executable links, not minor details; not 2: the decision procedure given inline is fully concrete. | 3 / 5 |
Workflow Clarity | Quotes: "Before touching anything, identify which kind of work this is", "Load correction-driven.md before editing", "Get either wrong and the artifact pollutes every project, silently stops applying, or lands in the wrong voice". A sequence is discernible (classify → load voice guide → decide placement → edit under guardrails) but it is implicit in section order rather than an explicit procedure, and there are no checkpoints verifying the classification or the finished artifact — anchor 3 ("sequence present but checkpoints missing or implicit"). Not 4: validation is entirely absent rather than a minor gap; not 2: the ordering and the explicit fallback question give a coherent flow. | 3 / 5 |
Progressive Disclosure | Quotes: 'Load **`correction-driven.md`**', 'Load **`informative-capability.md`**', 'Load **`placement.md`**'. The body is written as an ideal one-level router with clearly bolded references, but scored against the actual bundle structure (per the judging guideline), no references/, scripts/, or assets/ directories exist — all three referenced files are missing, so the disclosure structure is nominal and navigation to the detail content is impossible. This lands at anchor 2 (effectively broken/minimal reference structure). Not 3: the references, though clearly signaled, do not resolve to real files; not 1: there is no nested reference chain and the SKILL.md itself is well-organized. | 2 / 5 |
Total | 12 / 20 Passed |