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.
A well-crafted, self-exemplifying skill body: the workflow is explicitly gated and validated end-to-end, the guidance is maximally concrete via frames, operators, deletion lists, and a worked example, and the prose is dense with no filler. The two residual costs of keeping everything in one ~140-line file are a few trimmable rationale passages and the absence of a reference split for the catalog material.
Suggestions
Trim the audit anecdotes in 'Running it as a command' (live-session audit, injected-paragraph test) to their one-line conclusions, keeping the operative contract — this would lift conciseness to the lean register the skill itself prescribes.
Consider moving the Frames/Operators catalogs or the CLI contract for `omp compress` into a one-level-deep references/ file, keeping SKILL.md as the overview plus procedure.
If the skill ships outside the repo containing packages/coding-agent/src/compress/prompts/system.md, inline or copy the operative subset so the pointer is resolvable wherever the skill is installed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and self-applying — it assumes Claude's intelligence, explains nothing elementary (no 'what a token is', no library tutorials), and nearly every line carries instruction or measured evidence (e.g. the token-cost table in "Symbols do not save tokens; structure does"). It is not a 5 because a few passages carry rationale that could be trimmed — the paragraph on session isolation in "Running it as a command" ("Its session is isolated on purpose, because... Audited on a live session") and the audit anecdote about the injected-paragraph test run longer than the operative instruction they support. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete and executable: a numbered 8-step procedure, a frames table giving English-to-compressed transformations for every claim type, an explicit operator glossary, itemized always/never delete lists, and a worked example with source, compressed output, and a rejected over-compression with reasons. This matches the 5 anchor's 'specific examples cover the common cases' — the guidance leaves no step to invention. | 5 / 5 |
Workflow Clarity | The sequence is explicit with validation checkpoints at both ends: step 0 is a pre-flight density gate with a measured stop condition ("delta under ~10%? STOP"), and the Verification section is a four-step loop with an ambiguity scan ('can a reader assign a second reading? Fix it'), tokenizer-based measurement, declared-loss auditing, and a stop rule. This is the 5 anchor's 'explicit validation steps; feedback loops for error recovery' — well above the 4 anchor, which tolerates minor validation gaps. | 5 / 5 |
Progressive Disclosure | The single file is well-sectioned (Procedure, Frames, Operators, Deletion, Private register, Tool and skill descriptions, Worked example, Verification, CLI section) with clear headings and tables, and its one external pointer (the runtime contract at `packages/coding-agent/src/compress/prompts/system.md`) is clearly signaled. It is not a 5: at ~140 lines of dense material — over the under-50-line simple-skill exception — the frames/operators catalog and the CLI contract section are candidates for a one-level-deep reference file, which is exactly the 'minor organization gap' of anchor 4 rather than the fully appropriate split of anchor 5. It is clearly above anchor 3, whose structure is genuinely weak and references buried. | 4 / 5 |
Total | 18 / 20 Passed |