Content
88%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 content is a strong example of an instruction-plus-script skill: an executable command, a validated retry workflow with safe failure handling for a destructive overwrite, concrete compression rules, and worked examples. Its only real weakness is mild redundancy in the preservation rules and no reference-file split for the operational detail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no explanations of concepts Claude already knows, just purpose, trigger, process, rules, patterns, and boundaries. Minor redundancy keeps it from anchor 5: the code/inline-code preservation rule is stated three times ('Preserve EXACTLY - Code blocks/Inline code', 'CRITICAL RULE: Anything inside ``` ... ``` must be copied EXACTLY', and 'Inline code (`...`) must be preserved EXACTLY'), and the out-of-tree backup location is repeated in Purpose and Boundaries. It is well above anchor 3's 'some unnecessary explanation'. | 4 / 5 |
Actionability | Guidance is fully executable: a copy-paste-ready command ('From the directory containing this SKILL.md, run: python3 -m scripts <absolute_filepath>'), a concrete CLI behavior contract (detect, compress, validate, cherry-pick fix, retry up to 2, leave original untouched on failure), specific remove/preserve/compress word lists, and two worked before/after examples covering the common cases. All referenced files (scripts/__main__.py, scripts/compress.py) exist in the bundle. | 5 / 5 |
Workflow Clarity | The 4-step Process has an explicit sequence with validation and feedback loops built in: the CLI 'validate output (no tokens)', 'cherry-pick fix with Claude', 'retry up to 2 times', and on persistent failure 'report error to user, leave original file untouched'. For a destructive operation (original file is overwritten) it also mandates a pre-write backup and skips FILE.original.md, matching anchor 5's explicit validation steps with error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body is well-organized into clear sections (Purpose, Trigger, Process, Compression Rules, Pattern, Boundaries) and correctly delegates implementation to the scripts/ bundle ('The compression scripts live in scripts/... search for scripts/__main__.py') without inlining any of the 47KB compress.py. It sits at anchor 4 rather than 5 because there is no references/ split — the rules, patterns, and boundaries (~70 lines of operational detail) are all inline in SKILL.md with no one-level-deep reference files for cases like mixed prose/code handling, and the Trigger section's guard-rail explanation runs a bit long. | 4 / 5 |
Total | 18 / 20 Passed |