Content
85%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 tight, command-driven skill body with excellent sequencing, error-recovery fallbacks, and clean section structure for a single-purpose skill. The only deductions are minor: a duplicated fallback note, slightly over-explained rationale in Step 3, and an unresolved install-dir placeholder in the primary command that blocks copy-paste execution.
Suggestions
Replace the `__INSTALL_DIR__` placeholder in the collection-derivation command with a concrete resolution step (or document where it is substituted at install time) so the primary command is copy-paste executable.
State the `uvx memsearch` fallback once (e.g., in a short preamble note) instead of repeating it in both Steps 1 and 4.
Trim the Step 3 fallback to the essential instruction — 'if expand fails with a lock/permission error, read the source file using the provided `source` and `start_line`/`end_line`' — dropping the sandbox/Milvus rationale.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and assumes competence (no concept explanations, terse command-first steps), but has minor redundancy: "If memsearch is not found, try/use uvx memsearch instead" appears in both Steps 1 and 4, and the Step 3 fallback paragraph over-explains the sandbox rationale. This sits between anchor 5's 'every token earns its place' and anchor 3's 'some unnecessary explanation' — noticeably above the midpoint. | 4 / 5 |
Actionability | Mostly executable: concrete commands like `memsearch search "<query>" --top-k 5 --json-output --default-collection` and fully-formed `MDIR=...` exploration snippets. However the entry-point collection-derivation command embeds an unresolved `__INSTALL_DIR__` placeholder and several commands use placeholder args, so it is not fully copy-paste ready — matching anchor 4's 'concrete code or commands with minor gaps' rather than anchor 5. | 4 / 5 |
Workflow Clarity | Clear 5-step sequence (Search → Evaluate → Expand → Deep drill → Return) with explicit error-recovery feedback loops: uvx fallback when the binary is missing, direct file read when expand hits a lock error, and direct transcript-file exploration for unrecognized formats. The Evaluate step acts as a quality checkpoint; this is not a destructive/batch operation, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the body is under 50 lines with no need for external references — per the rubric's simple-skill guidance, well-organized sections alone warrant the top score. Sections (Project Collection, Steps, When unsure what to search, Output Format) are clear and each is appropriately scoped with nothing that belongs in a separate file. | 5 / 5 |
Total | 18 / 20 Passed |