obsidian
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
72
Quality
60%
Does it follow best practices?
Impact
100%
2.12xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/obsidian/SKILL.mdQuality
Discovery
32%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 identifies the tool ecosystem (Obsidian, obsidian-cli) but is too brief and lacks actionable detail. It fails to specify concrete capabilities and completely omits trigger guidance, making it difficult for Claude to know when to select this skill over others.
Suggestions
Add a 'Use when...' clause with trigger terms like 'Obsidian', 'vault', 'notes', 'PKM', 'knowledge management', or 'backlinks'.
List specific concrete actions such as 'create notes', 'search vault', 'manage links', 'organize tags', or 'query notes'.
Include common user phrases like 'my notes', 'note-taking', '.md files', or 'second brain' to improve trigger term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Obsidian vaults, Markdown notes) and mentions automation via obsidian-cli, but lacks specific concrete actions like 'create notes', 'link notes', 'search vault', or 'manage tags'. | 2 / 3 |
Completeness | Describes what at a high level but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes 'Obsidian vaults', 'Markdown notes', and 'obsidian-cli' which are relevant, but misses common user terms like 'notes', 'knowledge base', 'PKM', 'backlinks', or '.md files'. | 2 / 3 |
Distinctiveness Conflict Risk | 'Obsidian vaults' and 'obsidian-cli' provide some distinctiveness, but 'plain Markdown notes' could overlap with general markdown editing skills. | 2 / 3 |
Total | 7 / 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.
This is a well-crafted, concise skill that respects Claude's intelligence and provides immediately actionable CLI commands. The structure is clean with logical sections. The main weakness is the lack of validation checkpoints for potentially destructive operations like move and delete, which could benefit from explicit verification steps.
Suggestions
Add a validation step after move operations (e.g., 'verify with `obsidian-cli search` that the note exists at new path and links are updated')
Include a pre-delete check or confirmation pattern for the delete command to prevent accidental data loss
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely lean and efficient. No unnecessary explanations of what Obsidian or Markdown is. Every line provides actionable information Claude wouldn't inherently know (file paths, CLI commands, vault resolution logic). | 3 / 3 |
Actionability | Provides concrete, copy-paste ready commands for all operations (search, create, move, delete). Includes specific file paths and flags. The guidance is immediately executable. | 3 / 3 |
Workflow Clarity | Commands are clear but lacks explicit validation steps. For move/delete operations, there's no verification checkpoint (e.g., 'confirm links updated' or 'check file exists before delete'). The 'pick a default vault (once)' is a good sequence but other operations are listed without workflow context. | 2 / 3 |
Progressive Disclosure | For a skill under 50 lines with no need for external references, this is well-organized with clear sections (vault structure, finding vaults, CLI quick start). Content is appropriately scoped for a single SKILL.md file. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
- Repository
- trpc-group/trpc-agent-go
- Commit
50ef2f3
- 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.