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 efficient, highly actionable reference skill: every section is copy-paste-ready commands or code, with a useful model-selection table and a concrete failure-mode troubleshooting guide. The only weaknesses are the absence of an explicit output-validation checkpoint and slightly ambiguous resolution of the referenced files given no local references/ directory in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-dense with no padding: it never explains what a PDF or table model is, and every section (output shapes, model table, config alternative, failure modes) delivers operational detail that Claude would not already know. Phrases like "(`bounding_box` is omitted when no position data is available.)" add edge-case value per token, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | All guidance is executable and copy-paste ready: complete CLI invocations (`xberg extract report.pdf --layout --content-format markdown`), a jq pipeline for inspecting `result.tables`, a runnable Python example with imports and field access, and a TOML config block. Common cases (markdown vs JSON output, model choice, noisy scans, spreadsheets) each get a specific example. | 5 / 5 |
Workflow Clarity | The single extraction operation is unambiguous and the "Common failure modes" section provides explicit error-recovery feedback loops ("Empty `tables` with `--layout` on — ... Drop `--layout-confidence` to 0.3, try `--layout-table-model tatr`"). It falls short of a 5 because there is no explicit validation checkpoint (e.g., inspecting `result.tables` before proceeding) — recovery guidance exists but is remedial rather than a sequenced check. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and deep material is pushed to clearly signaled one-level-deep references ("See `references/cli-reference.md` for the full layout flag set"). However, the bundle ships no references/ directory, and the four referenced paths are split between an explicitly qualified "sibling `xberg` skill" (python-api.md, nodejs-api.md) and two unqualified paths (cli-reference.md, advanced-features.md) whose location is ambiguous — a minor navigation gap against the 'easy navigation' anchor. | 4 / 5 |
Total | 18 / 20 Passed |