Content
73%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-sequenced, highly actionable research workflow with strong error-recovery behavior, explicit halt conditions, and a closing checklist — the process engineering is excellent. Its weakness is token efficiency: duplicated backend YAML examples and intro/section redundancy add roughly 60-70 lines that could be cut without losing any operational content.
Suggestions
Deduplicate the backend registry material: the Research Backends section shows the same yt-dlp-transcript and perplexity-sonar entries twice (once as the format example, once in the 'Starter registry template'); keep one example and collapse the starter template to a short mention or move it to a references file.
Merge the 'Research Configuration (optional)' and 'Research Backends (optional)' sections with intro steps 4-5, which currently restate them nearly verbatim — state each check once.
Move the full page frontmatter templates (sources/, synthesis/) into a single references/templates file and link to it, keeping the body's per-section guidance inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational instruction with no concept over-explanation, but it carries real padding: the backend registry YAML appears twice (the two-backend example plus a ~30-line "Starter registry template" repeating yt-dlp and perplexity), and the "Research Configuration (optional)" / "Research Backends (optional)" sections restate intro steps 4-5 nearly verbatim. This is more than the "minor instances" of anchor 4 but falls short of anchor 2's pervasive unnecessary explanation. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: the exact `obsidian-wiki memory sync` invocation with arguments, `${QMD_CLI:-qmd} update/embed/ls`, `command -v <binary>` availability checks, per-round search budgets ("3-5 distinct angles", "up to 5 targeted searches"), and full YAML frontmatter templates with explicit confidence formulas (`0.17 + 0.5 × classify(url)`). Minor gaps: "Standard concept frontmatter" and `classify(url)` are deferred to llm-wiki/SKILL.md rather than restated, keeping it at anchor 4 instead of fully self-contained anchor 5. | 4 / 5 |
Workflow Clarity | A clearly sequenced workflow (config resolution → Round 1 survey → Round 2 gap fill → Round 3 synthesis check → filing → cross-linking → tracking → QMD) with an explicit halt condition, genuine feedback loops (backend failure → skip, note, fall back to WebSearch/WebFetch; QMD failure → report separately, never roll back vault writes), pre-write validation (check index.md to merge rather than duplicate), and a closing Quality Checklist including backend status reporting. This matches anchor 5's explicit validation + feedback loops + checklist. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent), so the single file must carry everything; framework details are properly deferred one level deep to llm-wiki/SKILL.md and .skills/llm-wiki/references/MEMORY.md with clearly signaled paths and section names. Structure is good, but the inlined starter registry template and full page frontmatter templates would sit better in a references file — minor organization gaps per anchor 4, not the misorganized/inline-burdened profile of anchor 3. | 4 / 5 |
Total | 16 / 20 Passed |