Content
56%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 body is highly actionable with concrete commands and a real fallback script, and the workflow is clearly sequenced with validation checkpoints. Its main weaknesses are verbosity (restated warnings/recovery) and weak progressive disclosure, since the bundle file is inlined rather than linked and supporting material is not split out.
Suggestions
Trim redundant sections: fold 'Warnings' and 'Recovery Protocol' into the workflow steps and remove the Critical Rule restatement of the Objective to improve conciseness.
Move examples/extraction_fallback.sh into a real ./scripts/ or ./assets/ file and reference it with a markdown link (e.g. 'See [extraction_fallback.sh](scripts/extraction_fallback.sh)') instead of inlining it.
Extract the Tool-Specific Notes table and detailed per-format fallbacks into a separate reference file, keeping SKILL.md as a concise overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose: 'Critical Rule', 'Warnings', and 'Recovery Protocol' restate the Objective and steps, and the Tool-Specific Notes table duplicates Step 4 fallbacks; padding could be trimmed without losing meaning. | 2 / 5 |
Actionability | Provides concrete executable commands (unzip -p … | xmllint, in2csv, pdftotext) plus a complete guarded shell script, with only minor gaps (no inline Python sandbox snippet). | 4 / 5 |
Workflow Clarity | Six well-sequenced steps with an explicit validation checkpoint (Step 3) and a checklist; the Recovery Protocol adds a feedback loop, though it is reactive rather than a per-step validate-fix-retry loop. | 4 / 5 |
Progressive Disclosure | No references/scripts/assets directories exist; the only bundle file (examples/extraction_fallback.sh) is inlined via an 'Add File' marker rather than a signaled link, and much inline content (Tool-Specific Notes, Recovery Protocol) could live in separate files. | 3 / 5 |
Total | 13 / 20 Passed |