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 for each task type. It loses points on conciseness due to repeated instructions and tangential padding, and on progressive disclosure because the referenced reference/script files are absent from the bundle.
Suggestions
Deduplicate the 'MANDATORY - READ ENTIRE FILE' instruction and the batch-organization guidance, stating each once in a shared location.
Remove or trim the Chinese agent/MCP-enhancements section and the generic 'Code Style Guidelines', which restate knowledge Claude already has.
Ensure the referenced bundle files (docx-js.md, ooxml.md, AGENTS.md, ooxml/scripts/unpack.py, ooxml/scripts/pack.py) are actually present in the skill so the progressive-disclosure links resolve.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands and code, but carries unnecessary tokens: the 'MANDATORY - READ ENTIRE FILE' paragraph is repeated three times, batch-organization guidance is duplicated (steps 2 and 4), and the Chinese agent/MCP section plus generic 'Code Style Guidelines' add padding Claude already knows. | 2 / 3 |
Actionability | Provides fully executable commands (pandoc, unpack.py/pack.py, soffice, pdftoppm) and a complete copy-paste-ready OOXML tracked-changes code example with GOOD/BAD contrast. | 3 / 3 |
Workflow Clarity | Multi-step workflows are clearly sequenced, and the redlining workflow includes explicit validation checkpoints — 'Test each batch before moving', grep-before-script, and a final verification step (step 6) with grep checks confirming changes applied and no unintended edits. | 3 / 3 |
Progressive Disclosure | The written structure is well-signaled and one-level-deep (SKILL.md overview pointing to docx-js.md, ooxml.md, AGENTS.md, and ooxml/scripts), but the referenced bundle files do not exist in the workspace, so the navigation is broken and references do not resolve to real files. | 2 / 3 |
Total | 10 / 12 Passed |