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.
A well-structured, token-efficient body: clear environment handling, a concrete script invocation with input format, four check dimensions with specific examples, and a severity-based output template in existing reference files. The single soft spot is the visual-verification section, which names the checks to run but not how to run them per environment.
Suggestions
Add one or two concrete visual-verification steps (e.g., what tool or procedure to use for screenshot/render inspection in the add-in vs chat), since 'run standard visual verification checks' is currently a high-level hint.
Specify how to extract slide text per environment (which add-in tool vs how to parse the uploaded .pptx) so the 'read the deck' step is executable in both modes, not just well-scoped.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At ~75 lines the body is lean throughout: no padding, no explanation of concepts Claude already knows, and motivational asides are single sentences that act as priority cues ('Don't skip it — a chart with no source citation looks the same as a properly sourced one in the text dump'). Every section earns its place, matching the lean-and-efficient top anchor rather than anchor 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Provides an executable command ('python scripts/extract_numbers.py /tmp/deck_content.md --check'), the exact slide-marker input format the script expects, concrete scan targets ('pretty good', 'a lot of'), and real reference files. However, 'Run standard visual verification checks on each slide' is a high-level hint without procedure, and how to read slides in the add-in vs chat environments is not spelled out — concrete guidance with minor gaps, anchor 4 rather than fully copy-paste-ready anchor 5. | 4 / 5 |
Workflow Clarity | The sequence is explicit and well-ordered: read every slide with attribution → write extraction to a file in the script's format → run the script → four numbered dimension checks → severity-categorized report ('Lead with criticals. If there aren't any, say so explicitly'). The skill is read-and-report only, so the destructive/batch validation cap does not apply; per-dimension bullet lists act as checklists. | 5 / 5 |
Progressive Disclosure | The body is an overview that delegates detail to clearly signaled, one-level-deep references that all exist in the bundle: 'See references/ib-terminology.md for replacement patterns' at the language-polish step, 'Use references/report-format.md as the structure' at the output step, and scripts/extract_numbers.py for number checking. Nothing that belongs in a separate file is inlined, and navigation is easy. | 5 / 5 |
Total | 19 / 20 Passed |