Content
82%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 strong, highly actionable single-file skill: it is dense with non-obvious, Obsidian-specific operational facts (rename inside the app, never move_file) and provides concrete templates, queries, and a final checklist. The main improvement levers are de-duplicating the repeated unlinked-mentions guidance, adding error-recovery steps to workflows, and splitting templates/query catalogs into reference files.
Suggestions
De-duplicate the 'unlinked mentions' guidance, which is explained in both the Wikilinks and Orphan sections, into one location with a cross-reference.
Add feedback loops to the destructive workflows — e.g. what to do when a start_search for inbound links returns unexpected results, or when edit_block fails — so the cleanup and dedupe workflows reach top workflow-clarity marks.
Move the MOC template, frontmatter baseline block, and Dataview query catalog into a references/ file (e.g. references/templates.md) linked from the body to improve progressive disclosure and shrink the SKILL.md body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with Obsidian-specific facts Claude cannot be assumed to know (filename-resolved wikilinks, rename-in-app vs. move_file breaking links, Bases vs. Dataview tradeoffs), but there are minor instances that could be trimmed: "unlinked mentions" is explained in both the Wikilinks and Orphan sections, the intro paragraph restates the frontmatter description, and "Bases is built in since Obsidian 1.9" embeds a version number. This fits the score-4 anchor (efficient, minor over-explanation) better than score 5 (every token earns its place). | 4 / 5 |
Actionability | Fully concrete, copy-paste-ready guidance throughout: exact wikilink syntax variants, a complete MOC template, a full frontmatter baseline block, three executable Dataview queries, a folder layout, and named tool commands (start_search, edit_block, write_file). It fits the score-5 anchor (specific examples covering the common cases), not score 4, which allows minor gaps. | 5 / 5 |
Workflow Clarity | The Workflows section sequences four multi-step processes and the "Checklist before finishing" provides explicit verification, and destructive/batch operations (delete-after-dedupe, repointing links) include a pre-delete check ("start_search for inbound [[links]] to the discarded note and repoint them before deleting"), so the destructive-operation cap at 3 does not apply. However, there are no error-recovery feedback loops (what to do when a search or edit fails), which keeps it at the score-4 anchor rather than score 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the single 190-line body is well-sectioned with clear headers, so navigation is easy. But reference-like material (the MOC/frontmatter templates and the Dataview query catalog) is inlined with no external references at all, which fits the score-4 anchor (good structure, minor organization gaps) rather than the score-5 anchor, which expects well-signaled one-level-deep references. | 4 / 5 |
Total | 17 / 20 Passed |