Content
71%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.
The body is highly actionable — every workflow is backed by executable commands, complete configs, and a troubleshooting section — with a clear setup sequence and validation step. Its weaknesses are length (inline daemon boilerplate and pipeline internals that could be trimmed or split out) and the complete absence of progressive disclosure: everything lives in one monolithic SKILL.md with no reference files.
Suggestions
Move the macOS launchd plist, Linux systemd unit, and MCP setup details into a references/ file (e.g. references/daemon-setup.md) and keep a one-line pointer plus the core command in SKILL.md.
Trim the 'How the Search Pipeline Works' section to the one-line guidance each mode needs (or move it to a reference), cutting RRF constants and blending percentages Claude does not need to use the tool.
Strengthen the setup verify step: state what healthy `qmd status` output looks like and what to check if `qmd embed` fails, closing the remaining validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient (command tables, terse setup steps), but several sections could be tightened: the full launchd plist XML and systemd unit inline (~50 lines of boilerplate Claude can generate), the "How the Search Pipeline Works" internals (RRF k=60, position-aware blending weights add tokens beyond what is needed to pick a search mode), and the attribution line. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened', not the lean anchor 5 or the padded anchor 2. | 3 / 5 |
Actionability | Every section gives copy-paste-ready commands: install commands with version checks, a Quick Reference command table, concrete search examples per mode, exact YAML MCP configs, structured multi-mode query examples, and troubleshooting commands with fixes. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Setup is a clearly numbered sequence (add collections → add context → embed → verify) with an explicit verify step (`qmd status`) plus a Verify Installation section, and the Troubleshooting section provides error-recovery feedback. It falls short of 5 because the verify step does not state what a healthy result looks like or what to do on failure within the workflow itself, and embed failures have no recovery loop — matching 'Clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The skill is a single ~430-line file with no bundle files at all; headers and a Quick Reference table give it reasonable structure, but content that belongs in separate reference files (launchd/systemd daemon configs, MCP integration details, search pipeline internals) is inlined. This matches 'Some structure but could be better organized; content that should be separate is inline' rather than anchor 4's appropriately split layout. | 3 / 5 |
Total | 15 / 20 Passed |