CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

obsidian-markdown

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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-structured, highly actionable reference with excellent progressive disclosure into three real, well-scoped bundle files and copy-paste-ready syntax throughout. Minor improvements: trim GFM-standard content (footnotes, arguably math) that contradicts the skill's own assumed-knowledge scope, and make the workflow's verify step more concrete. Non-destructive single-app syntax work, so no validation cap applies.

DimensionReasoningScore

Conciseness

The body is lean — annotated syntax blocks with no padded prose — but includes a Footnotes section that is GFM-standard despite the stated scope that "standard Markdown is assumed knowledge", and tag syntax rules duplicate content in PROPERTIES.md. Minor over-explanation that could be trimmed (anchor 4) rather than the fully lean anchor 5.

4 / 5

Actionability

Every section provides concrete, copy-paste-ready markdown snippets with inline annotations (e.g. "![[image.png|300]] Embed image with width"), and the Complete Example covers the common case end-to-end, matching anchor 5's fully executable, example-covered guidance.

5 / 5

Workflow Clarity

"Workflow: Creating an Obsidian Note" gives a clear six-step sequence ending in "Verify the note renders correctly in Obsidian's reading view". A verification step exists, but there is no error-recovery feedback loop and the check is not executable by Claude itself — clear sequence with minor validation gaps (anchor 4), short of anchor 5's explicit validation and feedback loops.

4 / 5

Progressive Disclosure

Verified against the actual bundle: all three referenced files exist (references/CALLOUTS.md, EMBEDS.md, PROPERTIES.md), each clearly signaled with its scope (e.g. "See [CALLOUTS.md](references/CALLOUTS.md) for the full list with aliases, nesting, and custom CSS callouts"), one level deep, with concise overviews inlined and detail properly split into files — matching anchor 5's well-signaled one-level-deep reference structure.

5 / 5

Total

18

/

20

Passed

Description

87%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 strong description that clearly and explicitly states both capabilities and trigger conditions in third person, closely matching the rubric's good example structure. The only weakness is slightly limited action-verb variety and a few missing natural synonyms (vault, backlinks).

DimensionReasoningScore

Specificity

"Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties" names the domain and enumerates specific capabilities with only two action verbs (create, edit). This lists several specific actions with minor gaps in coverage (anchor 4), but lacks the multiple distinct concrete actions of anchor 5.

4 / 5

Completeness

It explicitly answers both what ("Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties") and when ("Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes") with concrete trigger phrases, exactly matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Triggers include ".md files", "wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes" — good natural keyword coverage including a file extension. It falls short of anchor 5 because common synonyms like "vault", "backlinks", or "note-taking" are missing.

4 / 5

Distinctiveness Conflict Risk

Obsidian-specific syntax (wikilinks, callouts, embeds) forms a clear niche with distinct triggers; ".md files" is qualified by "in Obsidian" so overlap with generic markdown skills is minimal, matching anchor 5's clear niche with minimal conflict risk.

5 / 5

Total

18

/

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

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.