obsidian

Work with Obsidian vaults using the official obsidian CLI: read/search/create/edit notes, tasks, links, properties, plugins.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/obsidian/SKILL.md

Quality

Content

76%Weight 40%Scale 1-5

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

The body is a concise, highly actionable command catalog with clear organization. Its weak points are the missing validation feedback loops around destructive/batch operations and review scaffolding (PilotDeck note) that adds non-skill tokens.

Suggestions

Add a validate-then-proceed step for destructive/batch operations, e.g. read before delete/move and confirm before `obsidian delete` / `obsidian property:set` on multiple files.

Remove or relocate the 'PilotDeck Migration Note' section, as it is review scaffolding unrelated to using the skill.

Tighten the platform-specific registration detail (macOS/Linux paths) or move it to a reference, since it is time-sensitive and not needed for routine vault work.

Dimension	Reasoning	Score
Conciseness	Mostly lean with executable commands and no over-explanation of basics, but the PilotDeck migration scaffolding and verbose platform-registration details add tokens that do not serve skill use.	4 / 5
Actionability	A broad catalog of copy-paste-ready `obsidian` commands grouped by category (read/search/create/move/daily/tasks/properties/dev) covers the common cases.	5 / 5
Workflow Clarity	Sections are well sequenced with a prerequisite check, but destructive/batch operations (delete, move, property:set, bulk tasks) lack validate-then-proceed feedback loops, capping this at 3 per the guideline.	3 / 5
Progressive Disclosure	A single well-organized SKILL.md with clear section headers and no nested references; no bundle files exist. Length exceeds the simple-skill 50-line threshold, so it stops short of 5.	4 / 5
	Total	16 / 20 Passed

Description

75%Weight 40%Scale 1-5

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 is specific and distinctive, naming the tool and a broad set of concrete actions and object types. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which caps completeness.

Suggestions

Add an explicit trigger clause, e.g. 'Use when working with Obsidian vaults, or when the user mentions notes, tasks, links, or .md files.'

Include file-extension and synonym terms (e.g. 'Markdown notes', '.md', 'daily notes') to improve trigger-term coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions (read/search/create/edit) across concrete object types (notes, tasks, links, properties, plugins), matching the comprehensive-coverage anchor.	5 / 5
Completeness	A clear 'what' is present, but there is no 'Use when...' trigger clause, so 'when' is only weakly implied — capped at 3 per the missing-trigger-clause guideline.	3 / 5
Trigger Term Quality	Strong natural terms (Obsidian vaults, notes, tasks, links) but missing synonyms and file extensions like '.md' or 'markdown', so it falls short of the comprehensive anchor 5.	4 / 5
Distinctiveness Conflict Risk	'Obsidian vaults' plus 'the official obsidian CLI' defines a clear niche with distinct triggers and minimal conflict with other skills.	5 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: OpenBMB/PilotDeck
Path: skills/obsidian/SKILL.md
Commit: 9a33f4d

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.