Content
81%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-structured skill body: executable commands and snippets dominate, workflows are sequenced with validation and error-recovery loops, and all referenced bundle scripts are real. The main improvement areas are de-duplicating the table-width rules and splitting the XML Reference / docx-js catalog into one-level-deep reference files to trim SKILL.md.
Suggestions
Consolidate the table-width guidance (currently stated in the Tables code example, the 'Width rules' bullets, and the 'Critical Rules for docx-js' list) into a single location to remove repetition.
Write out the full relationship and picture URIs in the Images XML snippet instead of '.../image' and '.../picture' placeholders so the snippet is copy-paste executable, and add the missing fs require to the docx-js setup snippet.
Move the XML Reference (tracked changes, comments, image insertion patterns) into a separate reference file linked from the body, keeping SKILL.md as a leaner overview for tasks that don't need raw XML editing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and code-heavy with essentially no explanation of concepts Claude already knows, but the table-width rules are stated three times (in the Tables code, the 'Width rules' bullets, and the 'Critical Rules for docx-js' list), so not every token earns its place. It fits 'Efficient; minor instances of over-explanation that could be trimmed' rather than the lean anchor 5, and is well above anchor 3's 'unnecessary explanation'. | 4 / 5 |
Actionability | Nearly all guidance is copy-paste ready — complete bash commands (unpack/pack/validate/soffice) and complete JS snippets for lists, tables, hyperlinks, footnotes, and columns. Minor gaps keep it from anchor 5: the image XML snippet uses placeholder URIs (`Type=".../image"`, `uri=".../picture"`) that are not literally executable, and the setup snippet calls `fs.writeFileSync` without requiring `fs`. This fits 'Mostly executable guidance; concrete code or commands with minor gaps'. | 4 / 5 |
Workflow Clarity | The editing workflow is explicitly sequenced ('Follow all 3 steps in order' with unpack → edit XML → pack, validation built into pack.py with a detailed auto-repair fixes/won't-fix list), and the creation workflow has an explicit feedback loop ('If validation fails, unpack, fix the XML, and repack') plus a consolidated critical-rules checklist. This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'. | 5 / 5 |
Progressive Disclosure | The Quick Reference table provides clear top-level navigation and every referenced script path (scripts/office/unpack.py, pack.py, validate.py, soffice.py, scripts/comment.py, scripts/accept_changes.py) exists in the bundle, one level deep. However, all instructional content (~585 lines, including the full XML Reference and complete docx-js feature catalog) is inlined in SKILL.md with no split into reference files, so it fits 'Good structure; most content is appropriately placed; minor organization gaps' rather than the anchor-5 'content appropriately split'. | 4 / 5 |
Total | 17 / 20 Passed |