vault-search
Search the Web Capture Obsidian vault for ideation and research. Use when the user wants to find or explore saved content.
86
Quality
83%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Quality
Discovery
75%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has good structure with explicit 'what' and 'when' clauses, and the specific vault name provides distinctiveness. However, it lacks concrete action verbs and could benefit from more natural trigger terms that users would actually say when searching their notes.
Suggestions
Add specific concrete actions like 'retrieve notes', 'search by tag', 'browse saved articles', or 'find web clippings'
Expand trigger terms to include variations like 'look up', 'search notes', 'Obsidian', 'web clippings', 'bookmarks'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Obsidian vault, Web Capture) and general actions ('search', 'find or explore saved content'), but lacks specific concrete actions like 'search by tag', 'retrieve notes', or 'browse collections'. | 2 / 3 |
Completeness | Explicitly answers both what ('Search the Web Capture Obsidian vault for ideation and research') and when ('Use when the user wants to find or explore saved content') with a clear trigger clause. | 3 / 3 |
Trigger Term Quality | Includes some natural terms ('find', 'explore', 'saved content') but misses common variations users might say like 'look up', 'search notes', 'browse vault', 'find in Obsidian', or 'web clippings'. | 2 / 3 |
Distinctiveness Conflict Risk | The specific reference to 'Web Capture Obsidian vault' creates a clear niche that distinguishes it from generic search or document skills; unlikely to conflict with other skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent actionability and workflow clarity. The step-by-step instructions are concrete and executable, with clear sequencing and explicit validation steps for the move operation. The main weakness is that the content could be better distributed across files for a skill of this length, particularly the synthesis mode and move operation details.
Suggestions
Consider moving the 'Synthesis Mode' section to a separate SYNTHESIS.md file and referencing it from the main skill
The move operation workflow (Step 7) with its 5 sub-steps could be extracted to a REORGANIZE.md reference file
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, providing only necessary information without explaining concepts Claude already knows. Every section serves a clear purpose with no padding or unnecessary context. | 3 / 3 |
Actionability | Provides fully concrete guidance with specific CLI commands, exact file paths, JSON structure examples, and copy-paste ready bash commands. The step-by-step instructions are executable and specific. | 3 / 3 |
Workflow Clarity | Clear numbered steps with explicit sequence (Steps 0-7). The move operation includes a complete validation workflow: update index, update topic files, regenerate views, git sync. Filter application order is explicitly specified. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but the skill is somewhat long (~120 lines) and could benefit from splitting detailed synthesis mode or move operations into separate reference files. All content is inline rather than appropriately distributed. | 2 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- 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.