CtrlK
BlogDocsLog inGet started
Tessl Logo

obsidian-cli

Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their Obsidian vault, manage notes, search vault content, perform vault operations from the command line, or develop and debug Obsidian plugins and themes.

100

16.66x
Quality

100%

Does it follow best practices?

Impact

100%

16.66x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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 skill description that clearly enumerates specific capabilities across two domains (vault management and plugin/theme development), includes natural trigger terms users would actually use, and provides an explicit 'Use when...' clause. The description is comprehensive without being padded, and its focus on Obsidian-specific tooling makes it highly distinctive.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: read, create, search, manage notes/tasks/properties, reload plugins, run JavaScript, capture errors, take screenshots, inspect the DOM. Very comprehensive enumeration of capabilities.

3 / 3

Completeness

Clearly answers both 'what' (interact with Obsidian vaults via CLI to read, create, search, manage notes, develop plugins/themes) and 'when' with an explicit 'Use when...' clause covering vault interaction, note management, search, vault operations, and plugin/theme development.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'Obsidian vault', 'notes', 'tasks', 'search', 'plugin', 'theme', 'command line', 'DOM', 'screenshots'. Good coverage of both note management and developer-oriented terms.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive due to the specific focus on Obsidian vaults and the Obsidian CLI tool. The combination of note management and Obsidian plugin/theme development creates a clear niche that is unlikely to conflict with generic note-taking or general CLI skills.

3 / 3

Total

12

/

12

Passed

Implementation

100%

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

This is an excellent skill file that is concise, actionable, and well-structured. It efficiently teaches the CLI syntax conventions (parameters vs flags, file vs path targeting, vault targeting) that Claude wouldn't know, provides copy-paste ready examples for common operations, and includes a clear development workflow with validation steps. The delegation to `obsidian help` for the full command reference is a smart choice that keeps the skill focused.

DimensionReasoningScore

Conciseness

The content is lean and efficient throughout. It assumes Claude knows what Obsidian is, what CLI tools are, and how bash works. Every section delivers new, non-obvious information (parameter syntax, file vs path targeting, vault targeting) without padding.

3 / 3

Actionability

All examples are concrete, copy-paste ready bash commands. The common patterns section provides a comprehensive set of real commands covering the major use cases. No pseudocode or vague descriptions.

3 / 3

Workflow Clarity

The plugin development cycle is clearly sequenced with numbered steps, explicit validation checkpoints (check for errors, verify visually, check console), and a feedback loop (fix and repeat from step 1). This is exactly the pattern needed for iterative development workflows.

3 / 3

Progressive Disclosure

The skill is well-structured with clear sections progressing from syntax basics to common patterns to plugin development. It appropriately defers to `obsidian help` for the full command reference and links to external docs, keeping the skill focused on what Claude needs to know.

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
kepano/obsidian-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.