Content
81%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, read-only query workflow with concrete CLI commands, explicit verification gates, tiered read budgets, and thorough provenance rules. The main weaknesses are a placeholder product-root resolution that is not copy-paste executable, a redundant closing Checkpoint section, and external references that do not resolve within the bundle as shipped.
Suggestions
Replace the placeholder "PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian" with a concrete derivation from the skill's own location (e.g., using dirname on the SKILL.md path), so the resolution block is executable as written.
Drop or merge the Checkpoint section into Assess evidence / Answer, since it restates rules already stated there, trimming token cost without losing guidance.
Ship the referenced files (provenance.md, wiki-retrieve, wiki-cli) inside the skill bundle or point the links to files that resolve, so the one-level-deep references are actually navigable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational rules (depth tiers with KiB budgets, exact ledger paths, per-claim-state rules) and teaches nothing Claude already knows, so it is well past anchor 3. Not 5 because the Checkpoint section ("Observe what the vault actually contains, think about contradictory or missing evidence, verify every material citation...") largely restates the Retrieve/Assess/Answer sections, and the untrusted-evidence paragraph enumerates example payloads that could be trimmed. | 4 / 5 |
Actionability | Concrete, executable commands are given with flags ("python3 \"$CORE\" contracts --vault \"$VAULT\" --verify --capability wiki-retrieve", "python3 \"$RETRIEVE\" --vault \"$VAULT\" \"$QUERY\" --top 5 --no-rerank --explain") plus specific ledger paths and a citation format ("[[Page#Heading]]"). Not 5 because the PRODUCT_ROOT block is a non-executable placeholder ("PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian") — the skill says to resolve it from its own location but never shows how — and $VAULT/$QUERY resolution is left implicit. | 4 / 5 |
Workflow Clarity | The Retrieve section is a numbered sequence with an explicit verification gate (contracts --verify before using the index), a path-containment check ("Read candidate pages only after confirming each reported path stays inside $VAULT/wiki/"), branch handling for Quick vs Standard/Deep, and a defined error-recovery fallback ("If retrieval is unavailable, degraded, empty, or stale, fall back to wiki/index.md... Say which fallback was used"). This matches the anchor-5 pattern of explicit validation steps with feedback loops; a 4 would require missing checkpoints, which are present throughout. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned and its three outgoing links are one level deep with stated purpose ("[wiki-retrieve](../wiki-retrieve/SKILL.md) for cache and rerank behavior", "[wiki-cli](../wiki-cli/SKILL.md) for read/search transport selection", the provenance rules reference). Not 5 because none of the referenced targets exist in the shipped bundle — there are no references/, scripts/, or assets/ directories and the ../wiki, ../wiki-retrieve, and ../wiki-cli paths do not resolve — so the references cannot actually be navigated from this skill as packaged. | 4 / 5 |
Total | 17 / 20 Passed |