Content
82%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 an unusually tight, expert-level overview: excellent token efficiency, copy-paste commands, a real triage tool, and high-value gotchas. Its one serious defect is that the entire detail layer it routes to (four referenced sub-guides) is missing from the bundle, so progressive disclosure is structurally sound on paper but broken in practice, and the in-body validation loop is named rather than spelled out.
Suggestions
Ship the four referenced sub-guides (extract.md, transform.md, compose.md, interactive.md) or move them into a references/ directory matching the links — as delivered, the routing table's central instruction cannot be followed.
Add one inline validate-and-fix step (e.g., 'run scripts/sanity_check.py output.pdf; on exit 1 fix the reported findings and re-run') so the feedback loop lives in the body, not only in the missing sub-guides.
Include a minimal inline code snippet for the single most common case (e.g., pdfplumber text extraction) so the skill remains actionable even if a sub-guide is unavailable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense: routing and library-choice tables, terse install blocks, a one-command triage with sample JSON, and gotchas that are genuinely non-obvious (coordinate origins, CJK font fallback ladder, XFA vs AcroForm, RC4 default). It explains nothing Claude already knows, matching 'Lean and efficient; assumes Claude's competence; every token earns its place'; there is no padded section to trim for score 4. | 5 / 5 |
Actionability | Concrete, copy-paste-ready commands throughout: 'python3 -m pip install --upgrade pypdf pdfplumber pypdfium2 reportlab Pillow', 'scripts/survey.py path/to/file.pdf --pretty' with sample output, and 'qpdf --password=… --decrypt', plus a survey-flag routing list and a library-per-task decision table with fallbacks. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'; score 4 would require missing key details, and none are apparent. | 5 / 5 |
Workflow Clarity | There is a clear pipeline order ('probe → plan → extract or compose → validate'), every path starts with the survey probe, and validation is made concrete via documented exit codes ('3 validation failure', 'sanity_check.py reports findings with exit 1') and a promised Validation section per sub-guide. This sits between anchors: better than 'most checkpoints present' alone but short of a 5, because the actual validate-and-fix feedback loop is only pointed at, not spelled out in the body (e.g., no inline 'run sanity_check.py, fix, re-run' step). | 4 / 5 |
Progressive Disclosure | The routing table and 'What's next' section direct the reader to four sub-guides — extract.md, transform.md, compose.md, interactive.md — but none of these files exist in the bundle (no references/ directory; a filesystem check finds only SKILL.md and scripts/). The references are clearly signaled and one level deep, but they are dangling: following the skill's central instruction ('Open the sub-guide from the routing table and work through it end to end') fails immediately, which is worse than the 'minor organization gaps' of a 4 and closer to navigation being broken. The 11 scripts referenced (survey.py, probe_fields.py, apply_values.py, overlay_text.py, sanity_check.py) do all exist. | 2 / 5 |
Total | 16 / 20 Passed |