Composable Obsidian vault operations via CLI. Use when ANY task needs to read, write, search, tag, or query the Obsidian vault. This is the ONLY correct way to interact with the vault. Provides typed wrappers around the Obsidian CLI (v1.12+). Requires Obsidian to be running. Use when user says "save to vault", "obsidian", "research note", "daily note", "tag", "summarize and save", or any vault operation.
64
77%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/obsidian/SKILL.mdQuality
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 skill description that clearly defines its scope (Obsidian vault operations via CLI), lists concrete actions (read, write, search, tag, query), and provides explicit trigger guidance with natural user phrases. The description also includes helpful technical context (CLI version, runtime requirement) and assertively claims exclusivity for vault interactions, which aids in skill selection. Minor concern: the use of 'ANY' and 'ONLY' in caps feels slightly aggressive but serves a functional purpose for disambiguation.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: read, write, search, tag, query the Obsidian vault. Also mentions typed wrappers around the Obsidian CLI with version specificity (v1.12+) and the requirement that Obsidian must be running. | 3 / 3 |
Completeness | Clearly answers both 'what' (composable Obsidian vault operations via CLI — read, write, search, tag, query) and 'when' (explicit 'Use when' clause with specific trigger phrases and a general rule about any vault operation). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'save to vault', 'obsidian', 'research note', 'daily note', 'tag', 'summarize and save', plus the general 'vault operation'. These are realistic phrases users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — targets Obsidian vault specifically, mentions the CLI tool, version requirement, and that Obsidian must be running. The emphatic 'ONLY correct way to interact with the vault' further reduces conflict risk by asserting exclusivity for vault operations. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
55%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is highly actionable with excellent executable examples and clear workflow sequences including validation steps. However, it is severely bloated — cramming at least 5-6 distinct concerns (core API, agent memory, research reports, self-healing, Obsidian markdown formatting, upgrade procedures) into a single file. Much of the Obsidian-specific markdown syntax (callouts, wikilinks, highlights) is knowledge Claude already possesses and wastes tokens.
Suggestions
Split Agent Memory, Research Reports, Friction Self-Healing, and Output Formatting into separate referenced files (e.g., AGENT-MEMORY.md, REPORTS.md, SELF-HEALING.md, FORMATTING.md) with one-line references from the main SKILL.md.
Remove the Output Formatting Rules section entirely or reduce to 2-3 Obsidian-specific reminders — Claude already knows standard markdown, callout syntax, and frontmatter conventions.
Remove the 'Composing with Other Skills' section or move it to a separate INTEGRATION.md — the examples largely repeat the Quick Reference API patterns.
Trim the trigger signal tables in Agent Memory and Self-Healing sections to just the threshold rule and 2-3 examples instead of exhaustive tables.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely long and includes multiple composable subsystems (Agent Memory, Research Reports, Friction Self-Healing) that could each be separate files. There's significant verbosity in explaining workflows, tables of trigger signals, and extended examples. The 'Composing with Other Skills' section repeats patterns already shown. Much content (callout types, highlight syntax, property explanations) is standard Obsidian knowledge Claude already has. | 1 / 3 |
Actionability | The skill provides fully executable PowerShell commands with heredoc syntax, a comprehensive Python API quick reference with concrete method signatures and arguments, and copy-paste ready examples for every operation (create, read, append, search, memory saving, report saving). The CLI commands are specific and complete. | 3 / 3 |
Workflow Clarity | Multi-step workflows are clearly sequenced with explicit validation checkpoints. The self-healing workflow has numbered steps with decision points (P0/P1/P2 triage). The upgrade workflow has a clear 8-step sequence. Verification notes explicitly call out the need to follow up creates with reads. The deduplication workflow includes a search-before-create pattern with branching logic. | 3 / 3 |
Progressive Disclosure | This is a monolithic wall of text with Agent Memory, Research Reports, Friction Self-Healing, Output Formatting Rules, Composing with Other Skills, and Upgrade workflows all inline. These are clearly separable concerns that should be in their own files with references from the main SKILL.md. No bundle files are provided, yet the content is far too long for a single file — it would benefit enormously from splitting into referenced sub-documents. | 1 / 3 |
Total | 8 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (623 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
17bd06f
Table of Contents
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.