CtrlK
BlogDocsLog inGet started
Tessl Logo

obsidian-vault

Organize Obsidian vaults with MOCs, wikilinks, frontmatter/properties, dashboards, orphan-note checks, and cleanup workflows. Use ONLY when the user explicitly refers to Obsidian — by naming "Obsidian", an Obsidian "vault", or an Obsidian-specific feature such as wikilinks ("[[ ]]"), the Dataview or Bases plugins, or Obsidian Properties. Within that Obsidian context it covers creating Maps of Content, adding/fixing wikilinks, finding orphan notes, normalizing YAML frontmatter, generating Dataview/Bases dashboards, organizing folders, deduplicating or renaming notes, and preparing the vault for AI use. Do NOT use this skill for generic note-taking, Markdown, or knowledge-base requests that don't mention Obsidian.

73

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is obsidian-vault in wonderwhy-er/DesktopCommanderMCP

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it names a clear Obsidian-only niche, enumerates comprehensive concrete capabilities, gives explicit positive and negative trigger guidance with natural user vocabulary, and stays in third person throughout. The only nitpick is slight verbosity from restating the capability list, but none of it is fluff.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: "creating Maps of Content, adding/fixing wikilinks, finding orphan notes, normalizing YAML frontmatter, generating Dataview/Bases dashboards, organizing folders, deduplicating or renaming notes, and preparing the vault for AI use" — matching the score-5 anchor rather than the score-4 anchor, which requires minor gaps in coverage.

5 / 5

Completeness

It explicitly answers both what (the enumerated action list) and when ("Use ONLY when the user explicitly refers to Obsidian — by naming 'Obsidian', an Obsidian 'vault'... or the Dataview or Bases plugins"), plus a negative boundary ("Do NOT use this skill for generic note-taking, Markdown, or knowledge-base requests"). This exceeds the score-4 anchor, whose 'when' clause is less explicit.

5 / 5

Trigger Term Quality

Natural trigger terms are comprehensive and include synonyms and feature-specific vocabulary users would actually say: "Obsidian", "vault", "wikilinks ([[ ]])", "Dataview", "Bases", "Properties", "orphan notes", "MOCs", "dashboards". It fits the score-5 anchor (natural terms including synonyms); score 4 would require natural terms to be missing, and the only omissions (e.g. "backlinks") are peripheral to triggering.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Obsidian-only) with distinct triggers and an explicit exclusion clause preventing overlap with generic Markdown, note-taking, and knowledge-base skills — minimal conflict risk, matching the score-5 anchor. Score 4 would require minor overlap risk with closely related skills, which the exclusion clause largely forecloses.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
wonderwhy-er/DesktopCommanderMCP
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.