Content
57%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 an accurate, fully concrete, copy-paste-ready syntax reference whose Obsidian-specific sections are excellent. Its weaknesses are that about half the content duplicates standard Markdown knowledge Claude already has, the whole reference is inlined monolithically in SKILL.md with no progressive disclosure into reference files, and there is no workflow or verification guidance for composing a note.
Suggestions
Delete or move the standard-Markdown sections (Basic Formatting, Lists, Quotes, Code, Tables, Horizontal Rules, Footnotes) — Claude already knows GFM; keep only Obsidian extensions (wikilinks, embeds, callouts, properties, %%comments%%, tag rules, Mermaid internal-link classing), roughly halving the token cost.
Split the remaining reference into bundle files (e.g. references/links.md, references/callouts.md, references/properties.md) with a concise SKILL.md overview pointing to them one level deep, instead of the current monolithic 600-line inline reference.
Add a short decision guide or checklist (when to use a wikilink vs. a Markdown link, when to embed vs. link, how to verify callout/callout-type syntax against the supported types table) to give the reference a clear usage workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly half of the ~600-line body re-teaches standard CommonMark/GFM that Claude already knows: 'Basic Formatting' (headings, bold/italic, escaping), 'Lists' (unordered/ordered/tasks), 'Quotes', 'Code' (inline, fenced blocks), 'Tables', 'Horizontal Rules', and 'Footnotes' are all vanilla Markdown. Only the Obsidian-specific sections (wikilinks, embeds, callouts, properties, %%comments%%, tags, Mermaid linking) add information Claude cannot be assumed to know, so the padding guideline for known concepts puts this at 'noticeably verbose; several unnecessary sections'. | 2 / 5 |
Actionability | Every construct is given as exact, copy-paste-ready syntax in fenced examples — wikilinks with heading/block targets, embeds with image sizing ('![[image.png|300]]'), foldable callouts ('> [!faq]-'), frontmatter property types, math, Mermaid — plus a 'Complete Example' showing the constructs composed into a real note. Examples cover all common cases with no gaps. | 5 / 5 |
Workflow Clarity | This is a pure syntax reference with no multi-step process, sequencing, or decision guidance — there are no 'steps' at all, matching the 'sequence present but checkpoints missing or implicit' level at best. The 'Complete Example' section partially demonstrates how to compose a note, but there is no guidance for choosing between constructs or verifying output, and the under-50-line simple-skill exception does not apply to a 600-line reference. | 3 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), so the entire syntax reference is inlined monolithically in SKILL.md. Section headers give good in-page navigation and the closing 'References' section links official docs, but the GFM half of the reference clearly belongs in a separate file (or nowhere), matching 'some structure but content that should be separate is inline'. | 3 / 5 |
Total | 13 / 20 Passed |