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 highly actionable, information-dense body: every section gives real commands, flags, and config with honest feature-gating caveats. The main weaknesses are redundancy between Field notes and Common pitfalls, absent verification steps, and reference paths that don't resolve within this bundle.
Suggestions
De-duplicate the Field notes and Common pitfalls sections — the `min_score` direction, `max_keywords` default, and no-`--keywords`-flag points each appear twice.
Verify or create `references/advanced-features.md` and `references/cli-reference.md` — they are cited as bundle paths but no `references/` directory exists in this skill.
Add a quick verification cue for keyword extraction (e.g., check `result.extracted_keywords` is non-empty, and remember the silent-ignore behavior on non-`full` builds).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and competence-assuming — no concept tutorials, real flags only — but there is noticeable duplication: the `max_keywords` default is stated in both the TOML comment and Field notes, the `min_score` higher-is-better direction is explained in Field notes and again in Common pitfalls, and the missing `--keywords` flag is stated in both the Keywords section and pitfalls. Anchor 4 (efficient with minor trimming opportunities) fits better than 5. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste CLI commands with real flags (`--config-json` with a `keywords` JSON block, `--detect-language true`, `xberg embed --preset quality`), jq pipelines, complete TOML config blocks with per-field comments, and a runnable Python snippet. The provider table and cache-warm commands cover the common cases. | 5 / 5 |
Workflow Clarity | A reference-style skill with clearly organized per-feature sections and a useful diagnostic note (feature-gated builds silently ignore `[keywords]` rather than erroring), and the pitfalls section anticipates failure modes. However, there are no explicit verification checkpoints (e.g., confirming expected output shape or that keywords actually landed on the result), so anchor 4 fits better than 5. | 4 / 5 |
Progressive Disclosure | Good structure with clearly signaled one-level references ("See `references/advanced-features.md` for the embeddings pipeline and `references/cli-reference.md` for the `embed` and `cache warm` flag sets"), and the Python/config refs are honestly scoped to the sibling `xberg` skill. But the two `references/*.md` paths have no corresponding files in this bundle (no `references/` directory exists), and some inlined reference material (full config-field annotations, provider table) could live in those files — minor organization gaps keep this at anchor 4. | 4 / 5 |
Total | 17 / 20 Passed |