CtrlK
BlogDocsLog inGet started
Tessl Logo

obsidian

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

Quality

77%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/obsidian/SKILL.md
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 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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
0xrabbidfly/eric-cartman
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.