Content
90%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.
An excellent, token-efficient CLI reference: fully executable commands, a tight backend matrix, and practical failure-mode recovery guidance. The only weaknesses are a missing explicit output-verification step (notable for batch runs) and external references that live in a sibling skill's bundle rather than this skill's own files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command/flag-focused throughout (e.g., "Pick Tesseract first. Switch only when accuracy is unacceptable.", "Xberg fails fast with a helpful error... Read the error — it names the missing file.") with no explanation of concepts Claude already knows and no padded sections. Every section adds CLI-specific knowledge, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | All guidance is executable and copy-paste ready: concrete commands ("xberg extract scan.pdf --force-ocr=true", "brew install tesseract-lang", "sudo apt install tesseract-ocr-deu..."), a backend comparison table with exact flags, a complete xberg.toml example, and specific failure-mode fixes. Common cases (force-OCR, multi-language, backend choice, troubleshooting) are all covered. | 5 / 5 |
Workflow Clarity | A clear decision flow (when to force OCR → backend choice → language packs → troubleshoot) is present, and 'Common failure modes' provides symptom→cause→fix recovery loops (e.g., empty content → bogus zero-width text layer → re-run with --force-ocr=true). However, there is no explicit validation checkpoint such as verifying extracted output is non-empty/readable, and the batch tip lacks a verification step — so it falls short of the explicit-validation 5 anchor but above the implicit-checkpoint 3 anchor. | 4 / 5 |
Progressive Disclosure | Sections are well organized and the detail is appropriately split for a single-purpose CLI skill, with a clearly signaled closing pointer for deeper material. However, the body has no reference files of its own — the pointer resolves to "references/cli-reference.md and references/configuration.md in the sibling xberg skill", which are not part of this bundle and may dangle if that skill is absent. This is good structure with minor organization gaps rather than the fully self-contained clear-overview 5 anchor. | 4 / 5 |
Total | 18 / 20 Passed |