Content
78%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 overview for an instruction-only skill: lean technique summaries, a symptom-to-reference dispatch table, and clean one-level-deep references that all resolve to real files. Minor gaps are the redundant 'When to Use' section, the vague 'apply systematically' process step, and the absence of any worked example or validation checkpoint in the body.
Suggestions
Merge the 'When to Use' bullet list into the Quick Dispatch table to remove redundancy and save tokens.
Add one short worked example (symptom → technique → insight gained) in the body or a shared reference so the Application Process's 'apply systematically' step has a concrete model to follow.
Add an explicit verification step to the Application Process, e.g., 'Confirm the stuck-type diagnosis before loading a reference; if two techniques match, start with the one whose red flag you observed.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: each technique gets only a one-line method, key insight, and red flag (e.g., "Test at extremes (1000x bigger/smaller, instant/year-long)"), with no padding explaining concepts Claude already knows. It sits at 4 rather than 5 because the 'When to Use' bullet list substantially duplicates the Quick Dispatch table, which is redundancy that could be trimmed to one section. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is mostly concrete: each technique has a specific heuristic with parameters ("Spot patterns appearing in 3+ domains", "Force unrelated concepts together"), plus diagnostic red flags ("Just need to add one more case...") that tell Claude exactly what to look for. It stops short of 5 because the Application Process steps like 'Apply systematically - Follow technique's process' are high-level, and no worked example appears in the body (details are correctly deferred to references). | 4 / 5 |
Workflow Clarity | The Application Process is a clear five-step sequence (identify stuck-type, load reference, apply, document insights, combine if needed) fronted by a symptom-to-technique dispatch table, which is above the 3 anchor's implicit checkpoints. It is not 5 because there are no explicit validation checkpoints for whether a technique actually resolved the stuck-ness — step 4's 'Record what worked/failed' is a soft reflection step rather than a verify-then-proceed gate. | 4 / 5 |
Progressive Disclosure | This is a textbook progressive-disclosure structure: a lean ~90-line overview with a Quick Dispatch table mapping each symptom to a specific reference file, all seven referenced files exist in ./references/, and the references are one level deep (when-stuck.md's dispatch table points to sibling technique files, not nested chains). This matches the 5 anchor's clear overview with well-signaled one-level-deep references. | 5 / 5 |
Total | 17 / 20 Passed |