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
93%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%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 strong, well-crafted description that concisely covers specific capabilities, includes natural trigger terms, explicitly states when to use the skill, and is clearly distinguishable from other skills through Obsidian-specific terminology. It follows the recommended pattern of listing actions followed by a 'Use when' clause, and uses third person voice appropriately.
| Dimension | Reasoning | Score |
|---|---|---|
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 variations of how users would describe note-taking tasks in Obsidian. | 3 / 3 |
Distinctiveness Conflict Risk | The mention of 'Obsidian vault', 'wikilinks', and 'index notes' creates a very clear niche. This is unlikely to conflict with generic note-taking or document management skills due to the Obsidian-specific terminology. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%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 provides concrete, executable guidance for managing an Obsidian vault. Its main strength is conciseness—it communicates all necessary conventions and commands without wasted tokens. The only notable gap is the lack of validation steps in the create workflow (e.g., verifying wikilinks resolve correctly or confirming index note updates).
Suggestions
Add a validation step to the 'Create a new note' workflow, such as verifying that wikilinks point to existing notes (e.g., a grep check) and confirming the note is linked from a relevant index note.
Consider adding a brief 'Update an index note' workflow since index notes are a core organizational mechanism but there's no explicit guidance on when/how to update them after creating new notes.
| Dimension | Reasoning | Score |
|---|---|---|
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 a flat, well-organized structure using clear section headers. No external references are needed, and the content is appropriately scoped for its purpose. | 3 / 3 |
Total | 11 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- mattpocock/skills
- Commit
b8be62f
- 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.