CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

obsidian-markdown

Explain, draft, or validate Obsidian Flavored Markdown syntax: properties, wikilinks, embeds, callouts, tags, comments, highlights, block references, math, and Mermaid. Use when the user explicitly requests Obsidian note formatting or syntax help, not for general Markdown or broad vault operations.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-crafted, safety-conscious reference: lean syntax examples, an explicit inspect-then-approve validation gate on vault edits, and clearly signaled external references. The main weaknesses are minor: a time-sensitive verification date inline, and the mutation bundle-construction step being delegated to an out-of-bundle reference.

Suggestions

Move the time-sensitive "checked 2026-10-17" verification date (or any version-sensitive details) into a small 'last verified' note or deprecated/old-patterns section so it doesn't age the main guidance.

Inline a minimal, copy-paste-ready example of building the `claude-obsidian.transaction.v1` bundle (or its exact creation command), since the rest of the mutation path is executable but this step is only reachable via the external operation-transactions.md reference.

Consider shipping the two referenced wiki files (operation-transactions.md, provenance.md) inside this skill's own references/ directory, or noting their expected location relative to the skill, so the skill is navigable without relying on the external product-root install layout.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — compact syntax blocks with no explanation of what Obsidian or Markdown is — but the time-sensitive date "checked 2026-10-17" sits outside any 'old patterns'/'deprecated' section and the product-root resolution preamble is dense. Efficient overall with minor trimmable content; not 5 because a few tokens don't earn their place, not 3 because there is no padded or redundant explanation.

4 / 5

Actionability

Concrete, mostly copy-paste-ready guidance: full YAML frontmatter example, wikilink/embed/callout blocks, and executable commands (`python3 "$CORE" transaction inspect "$BUNDLE" --vault "$VAULT"`). Not 5 because the central mutation path (building the `claude-obsidian.transaction.v1` bundle) is deferred to an external reference rather than shown, leaving a minor gap.

4 / 5

Workflow Clarity

The vault-edit workflow is clearly sequenced with an explicit validation checkpoint for a destructive operation: draft → read operation-transactions.md → build bundle → "Inspect it, then set APPROVAL_SHA256 … after review" → apply, plus post-mutation lint ("Run deterministic wiki lint after a requested mutation and report remaining findings without silently repairing them"). This matches the anchor-5 pattern of explicit validation steps with a feedback loop.

5 / 5

Progressive Disclosure

Sections are well organized and the two references ([operation-transactions.md](../wiki/references/operation-transactions.md), [provenance.md](../wiki/references/provenance.md)) are clearly signaled one level deep with when-to-read context. Not 5 because both reference targets resolve outside the skill bundle under the product root (no references/ directory ships with the skill), so navigation depends on the external install layout; not 3 because references are clearly signaled, not buried.

4 / 5

Total

17

/

20

Passed

Description

100%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 exemplary: it states concrete capabilities with an enumerated scope, provides an explicit 'Use when…' trigger clause with a negative boundary, and occupies a distinct niche. No changes needed.

DimensionReasoningScore

Specificity

"Explain, draft, or validate" names three concrete actions, and the description enumerates ten specific syntax areas ("properties, wikilinks, embeds, callouts, tags, comments, highlights, block references, math, and Mermaid"), giving comprehensive coverage rather than minor gaps.

5 / 5

Completeness

Both parts are explicit: what ("Explain, draft, or validate Obsidian Flavored Markdown syntax: …") and when ("Use when the user explicitly requests Obsidian note formatting or syntax help, not for general Markdown or broad vault operations"), including a negative boundary. Matches the anchor-5 example structure.

5 / 5

Trigger Term Quality

Natural user phrasing is well covered: "Obsidian note formatting", "syntax help", plus domain keywords users actually say (wikilinks, callouts, tags, properties, embeds, Mermaid). No common variation is missing for this domain.

5 / 5

Distinctiveness Conflict Risk

A clear niche (Obsidian Flavored Markdown) with distinct triggers and an explicit exclusion of general Markdown and broad vault operations, so conflict risk with adjacent skills is minimal.

5 / 5

Total

20

/

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

AgriciDaniel/claude-obsidian

Path

skills/obsidian-markdown/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.