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 well-structured, highly actionable tiered retrieval protocol with explicit escalation guards, concrete commands, and useful output templates. The main gaps are minor verbosity, a missing answer-verification checkpoint, and a dangling dependency on an external file (`llm-wiki/SKILL.md`) that is not part of this skill's bundle.
Suggestions
Trim explanatory asides (e.g., "This preserves existing behavior — nothing changes unless the user asks for it" and "this is the expensive path and they should know") to improve token efficiency without losing the behavioral rules.
Add an explicit verification checkpoint in Step 5, such as confirming that every cited `[[page-name]]` exists in the vault and matches content actually read, before presenting the answer.
Inline the Retrieval Primitives table (or copy it into a `references/` file in this skill's bundle), since the body's core protocol currently depends on `llm-wiki/SKILL.md`, which is not shipped with this skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational with useful cost rationale ("Reading is the dominant cost of this skill", "This usually returns 15–30 lines per hit instead of 100–500"), but contains a few trimmable asides like "This preserves existing behavior — nothing changes unless the user asks for it" and "this is the expensive path and they should know". It is not a 5 because of these minor over-explanations, and not a 3 because nearly all content is actionable instruction rather than concept explanation. | 4 / 5 |
Actionability | Guidance is concrete and near copy-paste ready: specific paths ("Read `~/.obsidian-wiki/config` to get `OBSIDIAN_VAULT_PATH`"), a concrete grep pattern ("`^(title|tags|aliases|summary):`"), an executable command ("`Grep -A 10 -B 2 "<query-term>" <candidate-file>`"), a full QMD invocation block, and templates for the log line and answer format. Not a 4 because the specific commands, file paths, and templates cover the common cases end to end. | 5 / 5 |
Workflow Clarity | Steps 1–6 are clearly sequenced with explicit escalation conditions and guards ("only if Steps 2/2b are inconclusive", "GUARD: If `$QMD_WIKI_COLLECTION` is empty or unset, skip this entire step", "If you're still short, **then** fall back to a broad content grep") and conditional exits at every tier. It is not a 5 because there is no explicit verification checkpoint on the output (e.g., confirming cited `[[page]]` names actually exist), and not a 3 because decision points and fallbacks are explicit at each step. | 4 / 5 |
Progressive Disclosure | Sections are well organized (Before You Start, Visibility Filter, Retrieval Protocol, Answer Format) and references are one level deep and clearly signaled ("Follow the Retrieval Primitives table in `llm-wiki/SKILL.md`", "See `.env.example` for setup"). It is not a 5 because the body depends on `llm-wiki/SKILL.md` and `.env.example`, neither of which exists in this skill's bundle (no references/, scripts/, or assets/ directories are present), and not a 3 because structure and reference signaling are otherwise good and the inline protocol content is appropriately placed. | 4 / 5 |
Total | 17 / 20 Passed |