Content
85%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 tight, highly executable reference: realistic CLI examples for every mode, a decision table for chunker types, parameter guidance per use case, and valuable non-obvious gotchas. Its main structural weakness is progressive disclosure — the body delegates to `references/configuration.md` and `references/cli-reference.md` that are not present in this bundle, leaving broken navigation.
Suggestions
Ship the referenced files (`references/configuration.md`, `references/cli-reference.md`) in this skill's bundle, or inline the essential `[chunking]` schema and chunk-flag details and drop the dangling references.
State the overlap-vs-size rule once — either in 'Common pitfalls' or in 'Inline during extraction' — instead of repeating it nearly verbatim in both places.
Move the long cross-language field-name alias blockquote (Python/Rust/TOML/Node naming differences) into a reference file (e.g. `references/python-api.md` or a naming section of `references/configuration.md`) so the SKILL.md body stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with runnable commands and non-obvious gotchas (capitalized `chunker_type` in JSON output, cross-language field-name aliases) and explains nothing Claude already knows. Not 5 because of minor trimmable redundancy: the overlap-must-be-smaller-than-size rule is stated in full in 'Inline during extraction' and then restated in 'Common pitfalls' ("Overlap ≥ size — rejected on `extract`; clamped to size / 4..."), and the alias blockquote in Programmatic access runs long. | 4 / 5 |
Actionability | Every section carries copy-paste-ready commands with realistic flags and comments — `xberg extract report.pdf --chunk --format json | jq '.chunks | length'`, `xberg chunk --text ... --chunker-type semantic --topic-threshold 0.6`, a runnable async Python snippet, and a TOML config block — plus a documented output schema (`chunks`, `chunk_count`, `config`, `input_size_bytes`). Fully executable with specific examples covering the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | This is a single-task reference skill with no multi-step process, and the single action is unambiguous: the choice between inline (`--chunk` on extract) and standalone (`chunk` command) is laid out up front, the chunker-type table plus 'Picking parameters' section gives decision rules per use case (RAG, summarization, topic segmentation), and error behavior is documented (rejected overlap, empty-input bail, missing-feature error). Under the simple-skill exception this qualifies for 5; there are no destructive or batch operations that would require a validation checkpoint. | 5 / 5 |
Progressive Disclosure | The in-body structure is good and references are clearly signaled ("See `references/configuration.md` for the full `[chunking]` schema and `references/cli-reference.md` for every chunk flag"), but this bundle contains no `references/`, `scripts/`, or `assets/` directories — the two referenced files do not exist here, so navigation dead-ends. Dangling references plus some inline material that belongs in those files (the full cross-language alias map, the pitfalls list) fit anchor 3 ('references present but not clearly signaled' in effect: they are signaled but not actually shipped) better than anchor 4's 'references mostly clear'. | 3 / 5 |
Total | 17 / 20 Passed |