Content
80%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 command reference with excellent copy-paste examples and no wasted tokens. Its weaknesses are operational: the batch workflow lacks a concrete per-file validation command and retry loop (capping workflow clarity at 3), and its key reference target does not exist in the bundle.
Suggestions
Add a concrete validation step to the Error recovery section, e.g. a jq filter like `xberg batch ... | jq '.[] | select(.error != null)'` plus a retry recipe for failed files, to turn the implicit 'inspect results' checkpoint into an executable feedback loop.
Fix the dangling `references/cli-reference.md` pointer — either include the file in this skill's bundle or state explicitly (as done for the API references) that it lives in the sibling `xberg` skill, so navigation is unambiguous.
Clarify the sibling-skill API references with the same explicit location phrasing used elsewhere, and consider consolidating them into a single clearly-signaled 'Further reference' section for easier discovery.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section delivers xberg-specific facts Claude would not know (default `--format json` vs `text`, layout concurrency limits of 1/2, `--output-dir` must exist, path-key matching rules) with zero padding or explanation of known concepts. This matches anchor 5 — lean, assumes competence, every token earns its place — and shows none of the over-explanation that would drop it to 4. | 5 / 5 |
Actionability | Nearly every section contains copy-paste-ready commands: `xberg batch *.pdf`, a jq post-processing pipeline, a complete `--file-configs` JSON example, `mkdir -p` + `--output-dir`, a TOML config, and a runnable Python `extract_batch` snippet covering the common cases. The only nit is `await` shown at top level, which is the standard convention for illustrating async APIs and keeps it at anchor 5 rather than revealing a real gap. | 5 / 5 |
Workflow Clarity | For a batch operation the rubric caps workflow_clarity at 3 without concrete validation, and this skill's checkpoint is implicit: "Inspect results for partial content and surfaced errors rather than relying on the process exit code alone" gives direction but no executable validation command (e.g., a jq filter for per-file errors) and no retry/fix loop for failed files. This fits anchor 3 (checkpoints missing or implicit); it does not reach 4 because the verification step lacks a concrete command, and is above 2 because error handling is at least explicitly addressed. | 3 / 5 |
Progressive Disclosure | Sections are well-organized and the bulk flag detail is correctly deferred ("See `references/cli-reference.md` for the full `batch` flag set"), but the bundle contains no `references/` directory at all — that pointer is dangling, and the API references are ambiguously located "in the sibling `xberg` skill". Per the guideline to score against the actual bundle structure, this matches anchor 3 (references present but not clearly signaled/verifiable) rather than 4's 'references mostly clear'. | 3 / 5 |
Total | 16 / 20 Passed |