Content
67%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 operational skill with clearly separated modes, explicit validation loops, and a well-used bundle reference. Its weaknesses are motivational padding, an internal contradiction between the quick-mode stop instruction and Step 5b's quick-mode exception, and bulk spec content (correction schema, body templates) inlined rather than disclosed progressively.
Suggestions
Resolve the quick-mode contradiction: either scope Step 5b into the quick-mode procedure explicitly or remove 'In quick mode, do this step but skip Step 6' from the full-mode section.
Trim motivational padding in Step 5b and elsewhere ('This is the step that keeps it alive...') to pure instruction.
Move the correction-mode YAML schema and the four full-mode body templates into references/ files, keeping only the essential template skeleton inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient operational detail Claude cannot know (commands, frontmatter specs, gate criteria), but padded in places — e.g. 'The memory surface is only as good as what gets written into it. This is the step that keeps it alive — without it the profile stays empty and the session recap has nothing to inject' is motivational fluff, and several rationale passages could be tightened. | 3 / 5 |
Actionability | Concrete copy-paste-ready commands with flags ('obsidian-wiki memory profile set <key> "<value>" --confidence 0.85', 'sync CAPTURE type=<type> page="<path>"', '${QMD_CLI:-qmd} update'), exact paths, slug examples, and confidence calibration. Minor gaps keep it from 5: correction mode's 'update an existing derived page when one owns the claim' lacks a concrete lookup procedure, and '<obsidian-wiki memory now>' is an unexplained placeholder. | 4 / 5 |
Workflow Clarity | Three modes cleanly separated with sequenced steps, an explicit KEEP/SKIP gate, a mandatory sha256 pre/post verification loop in correction mode, and QMD failure recovery ('do not roll back the vault changes; report the QMD status separately'). Falls short of 5 because quick mode says 'Stop here; do not run the full-mode steps below' while Step 5b instructs 'In quick mode, do this step but skip Step 6' — an internal contradiction — and the unnumbered 'Before You Start' / 'Step 5b' disrupt the sequence. | 4 / 5 |
Progressive Disclosure | The raw-file spec is properly offloaded to a real, one-level-deep, clearly signaled reference ('Read references/RAW-FORMAT.md for the full frontmatter spec'), which exists in the bundle. However, the body leans on three separate sections of an external llm-wiki/SKILL.md plus .skills/llm-wiki/references/MEMORY.md, and inlines the large correction-mode YAML schema and four full body templates that could live in reference files. | 4 / 5 |
Total | 15 / 20 Passed |