CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

obsidian-cli

Use the Obsidian CLI to read, create, search, and manage vault content, or to develop and debug Obsidian plugins and themes from the command line.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is obsidian-cli in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

96%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.

A lean, highly actionable reference: every claim is an executable command, the developer workflow has explicit validation and a retry loop, and bulk detail is properly deferred to `obsidian help`. The only structural note is that the growing command catalog lives in one file with no bundle-level split, which is acceptable at this size but near the threshold.

DimensionReasoningScore

Conciseness

Every section is commands, syntax rules, or one-line prerequisites ("Requires Obsidian to be open."); there is no explanation of what Obsidian or a vault is, and no padding. The body assumes Claude's competence, matching anchor 5 ('lean and efficient; every token earns its place') rather than 4's 'minor instances of over-explanation'.

5 / 5

Actionability

All guidance is copy-paste-ready: concrete parameterized commands ("obsidian create name=\"My Note\" content=\"Hello world\""), a ten-command Common patterns block covering the main use cases, and executable developer commands (dev:errors, dev:screenshot, dev:dom, eval). This matches anchor 5 ('fully executable; specific examples cover the common cases').

5 / 5

Workflow Clarity

The plugin develop/test cycle is a numbered four-step sequence with explicit validation checkpoints and a feedback loop ("Check for errors — if errors appear, fix and repeat from step 1"), plus visual and console verification steps. This matches anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery'); no destructive or batch workflow lacks validation.

5 / 5

Progressive Disclosure

The single file is well-organized with clear sections, and it defers the full command reference to the authoritative source ("Run `obsidian help` ... This is always up to date") instead of inlining it — good structure with appropriately placed content. It scores 4 rather than 5 because at ~107 lines it exceeds the under-50-line simple-skill exception, and the command reference and plugin-development sections could be split into separate files if the skill grows.

4 / 5

Total

19

/

20

Passed

Description

70%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.

A specific, well-scoped description in the imperative style of the reference examples, with concrete actions and a clearly distinct niche. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which caps completeness and leaves natural trigger phrases implied rather than stated.

Suggestions

Add an explicit trigger clause, e.g., "Use when working with Obsidian vaults, notes, or markdown files, or when developing/debugging Obsidian plugins and themes."

Include natural user variations such as "notes", "markdown files", and "daily notes" alongside "vault content" to improve trigger-term coverage.

Replace the generic "manage vault content" with one or two more specific capabilities (e.g., "append to notes, set frontmatter properties, list tasks and tags") to close the coverage gap.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("read, create, search, and manage vault content", "develop and debug Obsidian plugins and themes"), but "manage vault content" is a generic catch-all rather than enumerated capabilities, leaving minor coverage gaps (e.g., append, daily notes, properties). This matches anchor 4 ('lists several specific actions; minor gaps in coverage') rather than 5, and exceeds anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

The "what" is clear and multi-action, but there is no "Use when..." clause or equivalent explicit trigger guidance — the purpose infinitives ("or to develop and debug ... from the command line") only weakly imply when to use the skill. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; the score is not 4 because the "when" is implied rather than explicit.

3 / 5

Trigger Term Quality

"Obsidian CLI", "vault content", "plugins and themes", and "command line" are natural terms a user would say, giving good keyword coverage. A few natural variations are missing — users commonly say "notes", "markdown", or "daily notes" when asking for vault interaction, which keeps this at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

"Obsidian CLI" carves out a clear niche with distinct triggers (vault content management plus plugin/theme development via a specific CLI); there is minimal risk of this firing for the wrong skill. It matches anchor 5 and is more distinct than anchor 4's 'minor overlap risk with closely related skills'.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/obsidian-cli/SKILL.md

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.