Content
78%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 dense, highly actionable command reference with executable examples for every mode and useful tool-quirk notes. Its main weaknesses are minor redundancy and deferred references that point at files absent from the bundle, which undermines navigation.
Suggestions
Ship the referenced files (references/configuration.md and references/cli-reference.md) in this skill's bundle, or remove/repair the pointers so the deferred detail is actually reachable.
State the overlap-clamp rule once (in Common Pitfalls) instead of twice, and trim the cross-language field-name blockquote to the two or three naming forms that matter for the Python/Node callers the skill targets.
Add a one-line verification cue after the chunking examples (e.g., check `chunk_count` or spot-check `chunks[0]`) so readers can confirm the resolved config and output shape.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — it never explains what chunking or RAG is, and the capitalized `chunker_type` and cross-language field-name notes document real tool quirks Claude cannot infer. Minor trimmable redundancy remains (the overlap-clamp rule appears both in "Inline during extraction" and "Common Pitfalls"), matching anchor 4 rather than 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands with real flags cover the common cases: inline chunking (`xberg extract ... --chunk --chunk-size 1500 --chunk-overlap 300`), standalone from flag and stdin, each chunker type, tokenizer sizing, TOML config, and runnable Python via `ExtractionConfig`/`ChunkingConfig`. Matches anchor 5. | 5 / 5 |
Workflow Clarity | Usage paths are unambiguous, "Picking parameters" gives clear decision guidance by use case, and "Common Pitfalls" documents error cases (rejection, clamping, missing feature, empty input). There is no checkpoint for verifying output (e.g., inspecting `chunk_count` or chunk contents) after running, a minor validation gap matching anchor 4 rather than 5; no destructive/batch cap applies. | 4 / 5 |
Progressive Disclosure | Section structure is good and bulk detail is correctly deferred ("See `references/configuration.md` for the full `[chunking]` schema and `references/cli-reference.md` for every chunk flag"), but no `references/` directory exists in this bundle, so those pointers dangle — as do the pointers to a sibling skill's `references/python-api.md` and `references/rust-api.md`. Well-organized content with broken navigation fits anchor 3 rather than 4. | 3 / 5 |
Total | 16 / 20 Passed |