Content
72%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 highly actionable — verbatim templates, exact schemas, and per-operation step lists leave nothing abstract — and mostly token-efficient. Its weaknesses are the absence of post-write validation in the batch operations (ingest, inbox), which caps workflow clarity, and a monolithic structure that inlines the CLAUDE.md and note templates instead of shipping them as bundle files.
Suggestions
Move the verbatim CLAUDE.md template and the five note templates into bundle files (e.g., assets/claude-md.md, assets/templates/) and reference them by path, keeping SKILL.md as a lean overview.
Add a post-write validation step to the batch operations: after ingest or inbox runs, verify new wikilinks resolve and the index is in sync (or invoke the lint checks) before reporting success.
Trim the 'Core Insight' section's RAG-vs-compilation explanation and tagline flourishes ('Knowledge compounds.') — Claude can infer the motivation from a one-line statement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk of the body is non-derivable specification that earns its tokens — the vault directory tree, the verbatim CLAUDE.md, the frontmatter schema, per-operation numbered workflows — with only minor trimmable material such as "Traditional RAG re-searches raw documents on every query" (a concept Claude already knows), "Knowledge compounds.", and "Surfaces problems you didn't know existed.". This fits anchor 4 (efficient with minor over-explanation); it is not 3 because almost no section explains known concepts at length, and not 5 because the Core Insight section and occasional flourishes could still be cut. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: a copy-paste-ready CLAUDE.md ("Write `CLAUDE.md` in the vault root (verbatim)"), five complete note templates with frontmatter, exact paths ("`wiki/sources/{slug}.md`", "`output/brain-dump-YYYY-MM-DD.md`"), concrete report formats for lint and brain-dump, and a runnable one-shot command ("`claude --add-dir ~/Documents/Vault \"/obsidian-llm-wiki ingest https://example.com/article\"""). This matches anchor 5's copy-paste-ready coverage of the common cases. | 5 / 5 |
Workflow Clarity | Every operation has a clear numbered sequence and some checkpoints exist ("Announce the plan: list pages you'll create or update", brain-dump's "Ask: 'Fix automatically, or review first?'", and end-of-run reports), but the batch operations lack post-write validation: ingest ("Typically touches 5–15 pages per source") and inbox (routing all items then archiving them to `raw/`) have no verify step or feedback loop — no link check, no lint invocation after writes. Per the guideline capping batch operations without validation at 3, this lands at anchor 3 rather than 4; it is above anchor 2 because sequences are explicit and several checkpoints are present. | 3 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so everything lives in one ~440-line SKILL.md. Sections are well organized and navigable, but large blocks that clearly belong in separate files are inlined — the ~80-line verbatim CLAUDE.md and ~100 lines of note templates — which a maintainer must copy out by hand. This matches anchor 3 (good structure, but content that should be separate is inline); it is not 2 because the file is cleanly sectioned and easy to navigate, and not 4 because there are no references at all and the inlined template blocks are substantial. | 3 / 5 |
Total | 15 / 20 Passed |