Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with executable commands and a clear, validated workflow. Its main weaknesses are verbosity from repeated guidance and a monolithic structure that inlines a script and reference material instead of splitting them into bundle files.
Suggestions
Move the embedded bash fallback script into ./scripts/extraction_fallback.sh and reference it from SKILL.md to improve progressive disclosure.
Consolidate the duplicated hallucination/assumption guidance across Critical Rule, Warnings, and Recovery Protocol into a single concise section to improve conciseness.
Extract the Tool-Specific Notes table and per-format fallback details into a ./references/ file referenced from the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly actionable and avoids explaining basic concepts, but it is long (~150 lines) with notable repetition: the Critical Rule, Warnings, and Recovery Protocol restate the same hallucination/assumption guidance multiple times. | 2 / 3 |
Actionability | It provides copy-paste-ready commands (e.g., 'unzip -p file.docx word/document.xml | xmllint --format -', 'in2csv file.xlsx', 'pdftotext file.pdf -') plus a complete, executable bash fallback script with real functions. | 3 / 3 |
Workflow Clarity | Six numbered steps form a clear sequence with an explicit validation checkpoint in Step 3 (truncation, expected-vs-extracted comparison) and a feedback loop through fallback strategies (4a-4d) and Recovery Protocol, plus a checklist. | 3 / 3 |
Progressive Disclosure | No bundle directories or external referenced files exist; the body is a single over-50-line document with an inlined bash script (via an 'Add File' marker) and inline Tool-Specific Notes that would be better split into separate files. | 2 / 3 |
Total | 10 / 12 Passed |