Content
71%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.
The content is well-structured with a routing decision tree, executable tooling commands, and validation checkpoints in the redlining workflow. Its main weaknesses are duplicated batch-grouping prose, deferred core-edit code, a validation gap in the basic editing path, and references to detailed files (docx-js.md, ooxml.md) that are absent from the bundle.
Suggestions
Add the missing referenced files (docx-js.md and ooxml.md) to the bundle, or inline their essential content so the 'MANDATORY - READ ENTIRE FILE' instructions resolve to real files.
Deduplicate the batch-organization guidance: lines 109-113 and 125-128 cover the same by-section/by-type/by-proximity groupings — keep one canonical list and reference it.
Add a validation checkpoint to the basic 'Editing existing document' workflow (e.g., run a verify/validate script or a pandoc round-trip diff before final pack) to match the redlining path's rigor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean with executable commands and no concept-explanation padding, but the batch-grouping guidance is duplicated (lines 109-113 vs 125-128) and the 'MANDATORY - READ ENTIRE FILE' directive is repeated three times, both of which could be trimmed. | 4 / 5 |
Actionability | Tooling commands (pandoc, soffice, pdftoppm, unpack/pack scripts) and the OOXML redlining code example are concrete and executable, but the central editing operation defers its code to the external ooxml.md reference ('use get_node', 'see ooxml.md') rather than providing inline executable code. | 4 / 5 |
Workflow Clarity | A top-level decision tree routes to clear sequenced workflows, and the redlining workflow has explicit checkpoints (per-batch testing, final grep verification); the minor gap is that the basic 'Editing existing document' path (unpack -> script -> pack) lacks any validation step. | 4 / 5 |
Progressive Disclosure | References to detailed subfiles (docx-js.md, ooxml.md) are clearly signaled and one level deep, but neither file nor an ooxml/ directory exists in the actual bundle, so the prominently-signaled 'READ ENTIRE FILE' references point to missing files and runtime navigation fails. | 3 / 5 |
Total | 15 / 20 Passed |