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 highly actionable, well-organized CLI reference with executable examples everywhere, a clear L1→L2→L3 strategy, and explicit validation and help-first guidance. Its main weaknesses are length — large schema-style enumerations are inlined that the tool's own help system (or separate reference files) could serve on demand — and the absence of any bundle files to split that detail out of SKILL.md.
Suggestions
Move the per-format element-type tables (pptx/docx/xlsx rows) and the marks/watch pipeline details into reference files under references/, keeping a short summary table plus pointers in SKILL.md.
Promote the closing "After modifications, verify with validate and/or view issues" note into an explicit feedback loop inside the edit and batch workflows (validate → fix → re-validate → only then close/save), including what to do when validation fails.
Trim parenthetical property enumerations (e.g. the docx/xlsx type lists) to the commonly used entries and rely on the already-excellent "run officecli help <format> <element>" delegation for the long tail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and tool-specific throughout — commands, tables, and pitfalls with almost no explanation of concepts Claude already knows — but the massive inline element-type enumeration (the pptx/docx/xlsx table rows packed with parenthetical property lists) and the marks/watch detail could be trimmed or delegated to `officecli help`. Not a 5 because those sections carry tokens the help system already provides on demand; not a 3 because there is no real padding or generic explanation. | 4 / 5 |
Actionability | Nearly every section gives copy-paste-ready, fully executable commands with concrete flags, paths, and props (e.g. the Quick Start blocks, batch JSON examples, pivot-table add command, pitfalls table with exact corrected syntax). This matches the fully-executable anchor covering common cases; a 4 would require minor gaps in the concrete examples, which are not evident. | 5 / 5 |
Workflow Clarity | A clear strategy layering ("L1 (read) → L2 (DOM edit) → L3 (raw XML)"), an explicit help-first loop ("ALWAYS run help instead of guessing"), and a validation checkpoint ("After modifications, verify with validate and/or view issues") sequence the work well. Not a 5 because the verify step is a single closing note rather than an explicit validate→fix→re-validate feedback loop woven into the edit and batch workflows; not a 3 because validation guidance and error behavior (batch "Stops on first error") are explicitly present. | 4 / 5 |
Progressive Disclosure | There are no bundle files (references/, scripts/, assets/ are absent) and everything lives inline in a ~410-line SKILL.md; the giant element-type tables, the watch/marks pipeline, and the specialized-skills routing are content that clearly belongs in separate reference files. It is not a 2 because sections are well-organized and the skill does delegate detail one level deep via well-signaled mechanisms (`officecli help`, `load_skill`); not a 4 because substantial reference material is inlined in the main file rather than split out. | 3 / 5 |
Total | 16 / 20 Passed |