CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

72

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%Scale 1-5

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

This is a well-crafted skill that efficiently covers Obsidian-specific Markdown extensions with concrete, executable examples throughout. It correctly assumes Claude's knowledge of standard Markdown and focuses only on what's unique to Obsidian. Minor improvements could be made in trimming the 'When to Use' section and strengthening the verification step in the workflow, but overall this is a high-quality, actionable reference.

DimensionReasoningScore

Conciseness

The skill is efficient and assumes Claude knows standard Markdown. The 'When to Use' section is slightly redundant with the YAML description and frontmatter, and a few minor explanations (e.g., 'Obsidian extends CommonMark and GFM') could be trimmed, but overall it's lean and well-targeted.

4 / 5

Actionability

Every syntax feature includes copy-paste ready Markdown examples with clear annotations. The complete example at the end ties everything together into a fully executable note. Code is concrete and covers common cases comprehensively.

5 / 5

Workflow Clarity

The workflow section provides a clear 6-step sequence for creating an Obsidian note, with references to detailed guides at each step. Step 6 ('Verify the note renders correctly') is a validation checkpoint, though it's somewhat vague — it doesn't specify what to check or how to handle rendering issues. Since this is a non-destructive content creation task, the lack of a detailed feedback loop is a minor gap rather than a critical one.

4 / 5

Progressive Disclosure

The skill provides a clear overview with well-signaled references to EMBEDS.md, CALLOUTS.md, and PROPERTIES.md for detailed content. However, no bundle files were provided, so we can't verify these references exist. The inline content is appropriately scoped — enough to be useful without being overwhelming — with clear pointers to deeper material. Minor gap: the external reference links at the bottom could be better integrated.

4 / 5

Total

17

/

20

Passed

Description

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

This is an excellent skill description that clearly communicates what the skill does (create/edit Obsidian-specific markdown with named features), when to use it (explicit trigger clause with multiple natural terms), and is highly distinctive from other markdown-related skills. It follows the pattern of the good examples closely, using third person voice and providing comprehensive trigger term coverage.

DimensionReasoningScore

Specificity

Lists several specific actions and features (wikilinks, embeds, callouts, properties, Obsidian-specific syntax) with 'create and edit' as concrete actions. Minor gaps - could mention more specific operations like linking notes, creating templates, or managing metadata.

4 / 5

Completeness

Clearly answers both 'what' (create and edit Obsidian Flavored Markdown with specific features) and 'when' (explicit 'Use when' clause with concrete trigger phrases including file extensions and feature names).

5 / 5

Trigger Term Quality

Comprehensive coverage of natural terms users would say: 'Obsidian', 'wikilinks', 'callouts', 'frontmatter', 'tags', 'embeds', 'Obsidian notes', '.md files'. Includes both technical terms and common user language, plus the file extension.

5 / 5

Distinctiveness Conflict Risk

Clearly distinct from generic markdown skills by specifying 'Obsidian Flavored Markdown' and Obsidian-specific features like wikilinks, embeds, and callouts. The trigger terms are highly specific to Obsidian's ecosystem, minimizing conflict with general markdown or note-taking skills.

5 / 5

Total

19

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.