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

90%

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

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

An exemplary instruction-only skill body: terse annotated syntax examples, an explicit assumption-of-knowledge statement, a clear creation workflow with a verify step, and clean one-level-deep references to real bundle files. The only meaningful gap is that the final verification step lacks concrete failure-detection guidance for Obsidian's silent failure modes.

DimensionReasoningScore

Conciseness

The body is lean and explicitly assumes prior knowledge ("This skill covers only Obsidian-specific extensions -- standard Markdown (headings, bold, italic, lists, quotes, code blocks, tables) is assumed knowledge"), and each section is a minimal code block with terse inline annotations. No padding or explanation of concepts Claude already knows, matching the 'every token earns its place' anchor; there is nothing unnecessary to trim, so it is not a 4.

5 / 5

Actionability

Every section provides copy-paste-ready, valid Obsidian syntax covering the common cases: wikilink forms with display text and block IDs, embed forms including image width and PDF page, foldable callouts, a complete frontmatter block, tag character rules, and comments. The examples are concrete and executable rather than descriptive, matching the 'fully executable' anchor; the minor softness of the verify step belongs to workflow, not actionability, so this is not a 4.

5 / 5

Workflow Clarity

The 'Workflow: Creating an Obsidian Note' section gives a clear 6-step sequence with a terminal validation step ("**Verify** the note renders correctly in Obsidian's reading view"), fitting the 'clear sequence with most checkpoints present' anchor. It falls short of 5 because the verify step is soft guidance with no error-recovery loop or concrete check for common silent failures (e.g. how to detect a broken wikilink or unindexed tag), and no batch/destructive cap applies here.

4 / 5

Progressive Disclosure

The body is a well-organized overview that keeps quick-reference syntax inline and delegates depth via clearly signaled one-level-deep references ([PROPERTIES.md](references/PROPERTIES.md), [EMBEDS.md](references/EMBEDS.md), [CALLOUTS.md](references/CALLOUTS.md), [EXAMPLES.md](references/EXAMPLES.md), [COMMON-MISTAKES.md](references/COMMON-MISTAKES.md)) — all of which exist in the references/ directory, so navigation is genuine. This matches the 'clear overview with well-signaled one-level-deep references' anchor exactly, with no nested references or misinline content that would place it at 4.

5 / 5

Total

19

/

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 follows best practices: third-person voice, concrete capability enumeration, and an explicit two-branch 'Use when...' trigger clause naming natural keywords and a file extension. Only minor gaps in synonym coverage (vault, backlinks) keep trigger quality and specificity just below perfect.

DimensionReasoningScore

Specificity

The description names two concrete actions ("Create and edit Obsidian Flavored Markdown") and enumerates specific syntax features ("wikilinks, embeds, callouts, properties"), placing it at the 'several specific actions; minor gaps' anchor. It does not reach 5 because the actions themselves are limited to create/edit without covering e.g. refactoring, validating, or migrating existing notes, but it is well above 3 since coverage of the syntax surface is broad.

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...") with concrete trigger phrases, matching the anchor-5 example pattern. The 'when' clause is explicit and specific, so the anchor-4 'could be more explicit' level does not apply.

5 / 5

Trigger Term Quality

Good natural keyword coverage including the file extension (".md files in Obsidian") and user-sayable terms ("wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes"). A few natural terms are missing (e.g. "vault", "backlinks", "note-taking"), keeping it below the comprehensive-synonyms anchor at 5, while it clearly exceeds 3 because multiple natural phrases and variations are present.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (Obsidian-only syntax) with distinct trigger terms (wikilinks, callouts, Obsidian notes) that no general Markdown skill would claim, giving minimal conflict risk. It fits the 'clear niche with distinct triggers' anchor exactly and is not merely 'mostly distinct' as at 4.

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository
pantheon-org/tekhne
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.