Content
86%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 multi-language reference skill: fully executable examples, deep coverage of language-specific quirks, and a clean overview-plus-references structure with all bundle files present and one level deep. The only notable improvements are trimming the inline full-extension table (duplicated in supported-formats.md) and adding an explicit retry/verification loop for batch failures.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and library-specific with no concept-explaining padding, but a few things could be trimmed: the inline Supported Formats table enumerates all ~140 extensions despite "references/supported-formats.md" holding the full reference, and pinned versions ("xberg-cli@1.3.10", "uvx --from xberg-cli==1.3.8") add time-sensitive detail. Not 3 because there is no unnecessary explanation of things Claude already knows; not 5 because of the duplicated extension list and version pins. | 4 / 5 |
Actionability | Every section provides copy-paste-ready, complete examples across Python, Node.js, Rust, and CLI — imports, asyncio wrappers, error handling, and exact flag values ("--format json", "--content-format markdown") are all shown. Edge cases are documented concretely, e.g. "The single-string shorthand (\"eng+deu\") is only accepted in config files / --config-json, not in the OcrConfig constructor", fully covering the common cases per anchor 5. | 5 / 5 |
Workflow Clarity | The skill's single action (build an ExtractInput, call extract, read the envelope) is unambiguous and reinforced by pitfall #1 and the result-fields table, and batch error checkpoints are explicit ("Per-input failures ... are reported non-fatally in result.errors" with inspection code in all three languages). It falls short of anchor 5 because no explicit fix-and-retry loop or output verification (e.g. checking for empty content) is given — error detection is shown but not remediation. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a clear overview with well-signaled, one-level-deep references: the Additional Resources section lists all 8 reference files with one-line descriptions, and every linked file (python-api.md, nodejs-api.md, rust-api.md, cli-reference.md, configuration.md, supported-formats.md, advanced-features.md, other-bindings.md) exists in references/. Content is appropriately split — quick-start and pitfalls inline, exhaustive API/config/format detail external — matching anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |