Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with clear, validated workflows and good progressive-disclosure intent. Its main weaknesses are minor verbosity/repetition in the redlining section and several referenced bundle paths (docx-js.md, ooxml.md, ooxml/scripts/unpack.py|pack.py) that are missing from the actual bundle.
Suggestions
Tighten the redlining section: the "Batching Strategy" and step-4 "Suggested batch groupings" overlap — merge them into a single concise batching note to reduce token cost.
Fix or restore the referenced bundle paths (docx-js.md, ooxml.md, and ooxml/scripts/unpack.py|pack.py) so the one-level-deep references resolve, which would move progressive_disclosure to the top anchor.
Drop or trim the "A .docx file is essentially a ZIP archive containing XML files..." sentence, since it explains a concept Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and command-driven, but includes mild background ("A .docx file is essentially a ZIP archive...") and repeats batching guidance twice in the redlining section, so it could be tightened. | 2 / 3 |
Actionability | Provides concrete, executable commands (pandoc, unpack.py, pack.py, soffice, pdftoppm) and a real XML edit example, with copy-paste-ready syntax and options — matching the fully-executable top anchor. | 3 / 3 |
Workflow Clarity | A decision tree routes tasks to sequenced workflows, and the redlining workflow includes explicit batching plus a final verification step with grep-based validation, providing the feedback loop the top anchor rewards. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview pointing one level deep to docx-js.md and ooxml.md, but those referenced files are absent from the bundle and the ooxml/scripts/ paths for unpack.py/pack.py do not exist at the referenced location, so navigation is signaled but partially broken. | 2 / 3 |
Total | 10 / 12 Passed |