Content
92%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-crafted skill body: concise, executable, and clearly sequenced with explicit verification gates and a fallback path. The only minor gap is a placeholder product-root path, which is adequately justified, keeping actionability just below perfect.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout — no padding explaining what Obsidian, vaults, or retrieval are; every section and code block earns its place and assumes Claude's competence. | 5 / 5 |
Actionability | Provides concrete, mostly copy-paste-ready bash commands with specific flags ('python3 "$RETRIEVE" --vault "$VAULT" "$QUERY" --top 5 --no-rerank --explain'); the only gap is the placeholder PRODUCT_ROOT path, though its resolution is explicitly justified. | 4 / 5 |
Workflow Clarity | Clear sequence (Select depth → Retrieve → Assess evidence → Answer → Checkpoint) with explicit validation: the 'contracts --verify' capability check gates retrieval, path-stays-in-vault verification, and a documented fallback when retrieval is unavailable. | 5 / 5 |
Progressive Disclosure | Well-organized into clear sections with one-level-deep, clearly signaled references ([wiki-retrieve], [wiki-cli], [provenance.md]) and no nested or buried pointers; navigation is straightforward. | 5 / 5 |
Total | 19 / 20 Passed |