Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is highly actionable with executable commands and a reusable function, and it is well-organized as a self-contained file. Its main weaknesses are repetition of the same command and a shallow verification step without an error-recovery feedback loop.
Suggestions
Collapse the repeated unzip|sed one-liner into a single canonical example and reference it from the variations, removing redundant sections.
Remove or shorten the "DOCX files are ZIP archives containing XML files" concept explanation, which Claude already knows.
Strengthen the verification step into an explicit feedback loop, e.g. check that output is non-empty and advise re-checking the file path or format if extraction returns nothing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body explains a concept Claude already knows ("DOCX files are ZIP archives containing XML files") and repeats the same unzip|sed one-liner across five sections, so it could be tightened considerably. | 2 / 3 |
Actionability | It provides fully executable shell commands and a complete, copy-paste-ready parse_docx function with error handling. | 3 / 3 |
Workflow Clarity | Steps are sequenced (1-5) with a verification section, but the verification is shallow ("| head -20") and there is no validate->fix->retry feedback loop for the XML manipulation. | 2 / 3 |
Progressive Disclosure | It is a single self-contained file organized into clear, well-labeled sections with no nested references and no need for external bundle files. | 3 / 3 |
Total | 10 / 12 Passed |