CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

76

Quality

93%

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

87%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, well-structured skill that efficiently communicates Obsidian vault conventions and provides executable commands for common operations. Its main weakness is the lack of validation steps in the create workflow—there's no verification that links resolve correctly or that index notes are updated. Overall, it's a strong example of a concise, actionable skill.

Suggestions

Add a validation step to the 'Create a new note' workflow to verify that wikilinks resolve to existing notes (e.g., a grep check for each linked note's existence).

Add guidance on updating relevant index notes when creating a new note, with a verification step to confirm the index was updated.

DimensionReasoningScore

Conciseness

Every line serves a purpose. No unnecessary explanations of what Obsidian is, what wikilinks are conceptually, or how bash works. The vault path, conventions, and commands are stated directly without padding.

3 / 3

Actionability

Provides fully executable bash commands for searching by filename, content, and backlinks. The create workflow gives concrete steps with specific conventions. Commands are copy-paste ready with actual vault paths.

3 / 3

Workflow Clarity

Workflows are clearly listed and sequenced, but the 'Create a new note' workflow lacks a validation step—there's no check that wikilinks resolve to existing notes or that the note was properly added to a relevant index. For a vault management skill, verifying link integrity would be important.

2 / 3

Progressive Disclosure

This is a simple, single-purpose skill under 50 lines with no need for external references. Content is well-organized into clear sections (location, naming, linking, workflows) with logical grouping. No bundle files are needed.

3 / 3

Total

11

/

12

Passed

Description

100%Scale 1-3

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

This is a well-crafted skill description that concisely covers specific capabilities, includes natural trigger terms, and explicitly states both what the skill does and when to use it. The Obsidian-specific terminology (vault, wikilinks, index notes) provides strong distinctiveness. It uses proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Search, create, and manage notes' along with specific features like 'wikilinks and index notes'. These are concrete, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (search, create, manage notes with wikilinks and index notes) and 'when' (explicit 'Use when user wants to find, create, or organize notes in Obsidian').

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'notes', 'Obsidian', 'vault', 'wikilinks', 'find', 'create', 'organize'. These cover common user language when working with Obsidian note management.

3 / 3

Distinctiveness Conflict Risk

Clearly scoped to Obsidian vault specifically, with distinct features like wikilinks and index notes. Unlikely to conflict with generic note-taking or file management skills due to the Obsidian-specific terminology.

3 / 3

Total

12

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
SnowingFox/ai-skills
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.