Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced CLI skill with strong validation feedback loops and copy-paste-ready commands throughout. Its weaknesses are conciseness (length, repetition, inline version pins) and progressive disclosure (a large monolithic file with no reference-file split despite being far over the simple-skill line).
Suggestions
Move the Report-level recipes, Known Issues & Pitfalls, and Advanced/specialty topics into separate reference files (e.g. RECIPES.md, KNOWN-ISSUES.md) referenced one level deep from SKILL.md to cut the main file and improve progressive disclosure.
Deduplicate the repeated footer/field=page and TOC-pagenumbers prohibitions — state each rule once in Known Issues and link to it, rather than restating across three sections.
Consolidate version-sensitive notes ('1.0.60+', '1.0.61+') into a single version-compat note so inline version pins don't penalize conciseness over time.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuine CLI-specific gotchas rather than basics Claude already knows, but at ~657 lines it is long and repeats several rules multiple times (the footer/field=page and TOC pagenumbers prohibitions appear in 'Hard rules worth repeating', the Common pitfalls table, and Known Issues), and version-sensitive notes ('1.0.60+', '1.0.61+', 'officecli 1.0.60') sit inline in main content rather than a deprecated/old-patterns section. This matches 'mostly efficient but could be tightened'; it is not a 3 because not every token earns its place given the repetition and inline version pins, and not a 1 because it largely assumes Claude's competence rather than explaining elementary concepts. | 2 / 3 |
Actionability | Nearly every section gives fully executable bash — the Quick Start is a complete create→close→validate sequence, the Delivery Gate is a copy-paste gate script, and report recipes include real loops with concrete props and paths. This matches 'fully executable code/commands; copy-paste ready'; it is not a 2 because there is no pseudocode or missing key details. | 3 / 3 |
Workflow Clarity | The Common Workflow gives a 6-step sequenced build with explicit checkpoints ('After each structural op, get it back to confirm shape before stacking on top'), and the QA section adds a 7-step minimum cycle plus a Delivery Gate with a fix-and-rerun feedback loop ('One fix commonly creates another problem'). This matches the anchor for clear sequence with explicit validation, feedback loops, and checklists; it is not a 2 because validation checkpoints are explicit, not implicit. | 3 / 3 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ absent) and the skill is a single ~657-line monolithic SKILL.md with everything inline; the 'Advanced / specialty topics (skip if writing a report)' header is a good skip signal but content that should be separate (report recipes, Known Issues, the full QA gate scripts) is not split into reference files. This matches 'some structure but content that should be separate is inline'; it is not a 3 because there are no one-level-deep reference files, and not a 1 because section headers organize the content reasonably well rather than leaving a poorly organized wall. | 2 / 3 |
Total | 10 / 12 Passed |