CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

69

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, well-structured skill body with excellent token efficiency and executable search commands. The only weakness is the note-creation workflow, which defers to undefined 'vault rules' and an unexplained 'hierarchical numbering scheme', leaving the reader unable to fully execute that workflow from the skill alone.

Suggestions

Define what 'a unit of learning (per vault rules)' means in one or two lines, or add a reference file containing the vault content rules and link to it, so the note-creation workflow is self-contained.

Show the hierarchical numbering scheme with a concrete example (e.g., '3.2 Dependent Note Title.md') so the instruction is executable without guessing the format.

Add a light post-creation check, such as grepping the new note's wikilinks to confirm the target notes exist, to close the create workflow with a verification step.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: vault location, naming conventions, linking rules, and copy-paste bash commands with zero padding or explanation of concepts Claude already knows (e.g., "Mostly flat at root level" conveys structure in four words). Every token earns its place, matching the top anchor.

5 / 5

Actionability

The search, backlink, and index workflows give fully executable copy-paste bash commands, but the create workflow references undefined conventions: "Write content as a unit of learning (per vault rules)" and "use the hierarchical numbering scheme" without specifying either. This fits 'mostly executable guidance with minor gaps' rather than the fully copy-paste-ready top anchor.

4 / 5

Workflow Clarity

Each workflow is a clear, unambiguous single-action sequence, and the operations are non-destructive so no validation checkpoints are required. It falls short of 5 because the note-creation steps depend on the unspecified "vault rules" and "hierarchical numbering scheme", leaving that workflow incompletely defined; it is above 3 because sequences are explicit and steps are well-separated.

4 / 5

Progressive Disclosure

This is a simple skill (~54-line body, single purpose, no bundle files) whose content fits entirely in SKILL.md with no need for external references. Sections (Vault location, Naming conventions, Linking, Workflows) are well-organized and easy to navigate, which the rubric's simple-skill guidance says can score 5 with just well-organized sections.

5 / 5

Total

18

/

20

Passed

Description

83%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.

A strong description that clearly states capabilities and includes an explicit, natural 'Use when' trigger clause mirroring the stated actions. The main gaps are the slightly generic verb "manage" and missing common synonyms (e.g., knowledge base, backlinks) that would broaden trigger coverage.

DimensionReasoningScore

Specificity

The description lists several specific actions ("Search, create, and manage notes") and adds concrete mechanism detail ("with wikilinks and index notes"), matching the anchor for several specific actions with minor gaps. It is not a 5 because "manage" is generic compared to a fully concrete action list, and not a 3 because more than 1-2 concrete actions are explicitly named.

4 / 5

Completeness

It explicitly answers both what ("Search, create, and manage notes in the Obsidian vault with wikilinks and index notes") and when ("Use when user wants to find, create, or organize notes in Obsidian") with concrete trigger phrases, matching the top anchor exactly. The when-clause specificity exceeds the anchor-4 example ('Use when working with PDF files').

5 / 5

Trigger Term Quality

Natural phrases like "find, create, or organize notes in Obsidian" map well to what users would actually say, giving good keyword coverage. It falls short of the comprehensive anchor (5) because common synonyms such as "knowledge base", "backlinks", or "linking notes" are missing, but it is well above the partial-coverage anchor (3).

4 / 5

Distinctiveness Conflict Risk

"Obsidian vault" pins a clear niche with distinct triggers, but the skill could still fire for generic note requests ("create a note") where Obsidian is not mentioned, creating minor overlap risk with generic note-taking skills. This fits 'mostly distinct; minor overlap risk' rather than the minimal-conflict top anchor.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

SnowingFox/ai-skills

Path

.cursor/skills/obsidian-vault/SKILL.md

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.