Content
88%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.
Highly actionable, executable content with an explicit numbered workflow, error-recovery fallbacks, and a real one-level reference for MCP setup. Nearly every token teaches tool-specific behavior Claude could not infer; the main improvements are consolidating the repeated query-expansion exhortation and splitting metadata-filter detail into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and almost entirely tool-specific knowledge Claude cannot know (the ':from:count' suffix, --full-path semantics, the filter/match predicate AST, line-numbered output headers), with no padding about general concepts. It matches anchor 4 rather than 5 because the 'write intent:/lex:/vec: yourself — do not lean on query expansion' exhortation is repeated in three or more places and could be consolidated into one. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: search/query/multi-get invocations with flags, a wrong/right pair for line slicing ("Wrong: qmd get '#abc123' | sed -n '120,160p'" / "Right: qmd get '#abc123:120:40'"), complete filter-AST JSON examples, the MCP query payload, and troubleshooting commands — specific examples cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | An explicit numbered core workflow ("The workflow is always: 1. Search for candidate documents. 2. Retrieve the full source... 3. Answer from retrieved text, citing paths or docids") reinforced by a typical loop, with explicit error-recovery feedback: fall back to 'qmd search' when model/GPU setup fails, run 'qmd doctor' before changing configuration, use '--explain' to inspect ranking, and check metadata coverage before filtering. The Pitfalls section acts as a checklist; core operations are read-only so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | Well-sectioned body with a clearly signaled, verified, one-level-deep reference ("See references/mcp-setup.md") that exists in the bundle and contains no nested references. It matches anchor 4 rather than 5 because the 355-line SKILL.md is a full usage manual — roughly 90 lines of metadata filter/discovery detail and the MCP 'query' tool section (which overlaps references/mcp-setup.md) could be split into reference files. | 4 / 5 |
Total | 18 / 20 Passed |