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.
A well-crafted, highly actionable reference skill: complete executable commands for CLI, config-file, and Python access, a clear provider table, and a pitfalls section that doubles as a troubleshooting guide. Verbosity is well controlled with only minor duplication. The main weakness is navigation: the cited references/*.md files are not present in the skill's bundle, and two pointers rely on a sibling skill's files, so progressive disclosure cannot be fully verified.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with tool-specific facts Claude could not know ("silently ignored", preset names, "ngram_range ... Config-file only", "cache warm --all-embeddings"), and explanations of general concepts are absent or minimal (one-line YAKE/RAKE characterizations used to guide algorithm choice). It is not a 5 because of minor trimmable redundancy — e.g. the min_score normalization rule is explained in full in Field notes ("Both YAKE and RAKE normalize their scores to the 0.0-1.0 range with higher-is-better") and then repeated almost verbatim in Common pitfalls. | 4 / 5 |
Actionability | Every section gives copy-paste-ready, complete commands and code: the inline-JSON CLI invocation ("xberg extract paper.pdf --format json --config-json '{...}' | jq '.extracted_keywords'"), a full TOML config block with defaults, "xberg embed --text ... --preset balanced", the provider matrix with the llm example including --model/--api-key, cache pre-warm commands, and a complete runnable Python snippet. This matches the 5 anchor: fully executable, covering the common CLI, config-file, and programmatic cases. | 5 / 5 |
Workflow Clarity | Each task path is unambiguous (enable keywords via config, "--detect-language true", embed via the standalone command), the one real multi-step flow is shown concretely ("xberg extract report.pdf | xberg embed --preset quality"), and the pitfalls section supplies error-avoidance diagnostics (silent feature-gate ignore leaves "result.extracted_keywords ... empty rather than erroring"; cold models fixed by "xberg cache warm"). It stops short of the 5 anchor because there are no explicit validation checkpoints (e.g. how to confirm the keywords feature was actually built in), though no destructive or batch operation triggers the workflow-clarity cap. | 4 / 5 |
Progressive Disclosure | Structure is good: five well-scoped sections, detail appropriately deferred ("See references/advanced-features.md for the embeddings pipeline and references/cli-reference.md for the embed and cache warm flag sets"), matching the 4 anchor. It is not a 5 because navigation has gaps: no references/ directory (or any bundle files) actually exists alongside this SKILL.md, so the two cited reference paths cannot be verified, and two more references ("references/python-api.md and references/configuration.md in the sibling xberg skill") depend on files in a different skill, a fragile cross-skill pointer. | 4 / 5 |
Total | 17 / 20 Passed |