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.
The body is a dense, highly actionable retrieval pipeline with explicit sequencing, guarded fallbacks, and concrete commands throughout. Its weaker dimensions are conciseness (some trim opportunities in the QMD section) and progressive disclosure (reference material inlined rather than split into bundle files).
Suggestions
Move the QMD CLI command catalog (Step 2b) and the graph-query output-field dictionary (Step 0) into a reference bundle file, leaving a one-line pointer so the SKILL.md body stays an overview.
Trim redundant routing statements — the 'do not edit, route to wiki-capture/wiki-update' guidance appears in both the READ-ONLY section and Step 5; consolidate to one.
Cut the bookkeeping-files exclusion rationale or compress it to one line, since it restates behavior the decision tree already implies.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly all of the ~290 lines are skill-specific procedural instruction that assumes Claude's competence — there is no padding explaining what a wiki or grep is — but the QMD CLI command catalog and a few redundant routing/escalation notes could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready bash commands (obsidian-wiki graph-query, graph-analyse), exact MCP tool fields, concrete grep patterns, BFS bounds, and an exact log-format string, covering the common query shapes (structural, path, relationship, index-only). | 5 / 5 |
Workflow Clarity | A clearly sequenced Step 0–6 pipeline with an explicit decision tree, guard checkpoints (QMD unset, index-only stop, frontier cap), and escalation reporting that acts as feedback for the read-only retrieval flow. | 5 / 5 |
Progressive Disclosure | Well-organized with labeled steps, decision trees, and tables, and external references are signaled by named skill/path, but reference material such as the QMD command catalog and graph-query field dictionary is inlined in one ~290-line file with no bundle files to offload it to. | 4 / 5 |
Total | 18 / 20 Passed |