Content
92%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.
Excellent action-oriented content: lean, executable, and with strong troubleshooting feedback loops. The one real weakness is navigation — two of its four file references point to paths absent from this skill's bundle, and the other two defer to an external sibling skill.
Suggestions
Ship references/cli-reference.md and references/advanced-features.md inside this skill's bundle, or inline the key layout flags so the body is self-sufficient.
Qualify the cli-reference/advanced-features pointers the same way the python-api/nodejs-api ones are qualified (e.g., "in the sibling xberg skill") if that is where they actually live, so readers know where to resolve them.
Add a one-line Node.js snippet (mirroring the Python example) since the section currently names the API surface without showing it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: every section is tool-specific commands, a model-selection table, or failure-mode fixes, with no explanation of concepts Claude already knows; even asides like "Good for LLM ingestion" serve format-selection decisions. | 5 / 5 |
Actionability | Fully executable throughout: copy-paste CLI commands for both output shapes, a jq inspection pipeline, a model-selection table with concrete flags, and a complete runnable Python example with imports covering the common cases. | 5 / 5 |
Workflow Clarity | This is a single-action skill with unambiguous commands, satisfying the simple-skill carve-out; the jq example shows how to inspect results and "Common failure modes" provides explicit detect-then-fix feedback loops (empty tables → drop --layout-confidence; ragged output → switch table model). | 5 / 5 |
Progressive Disclosure | Section structure and reference signaling are good, but the referenced files do not exist in this skill's bundle — there is no references/ directory, so "references/cli-reference.md" and "references/advanced-features.md" are dangling, and the Python/Node API references point to a "sibling xberg skill" whose presence cannot be assumed. | 3 / 5 |
Total | 18 / 20 Passed |