CtrlK
BlogDocsLog inGet started
Tessl Logo

obsidian-markdown

技术写作员与内容创作者在构建Obsidian知识库时,当需要编写带双向链接、Callout或Frontmatter的复杂笔记,使用此技能可精准生成标准Markdown文档,完美支持wikilinks与嵌入,大幅提升知识管理与排版效率!

55

Quality

63%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/obsidian-skills-integrated/obsidian-markdown/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an accurate, fully concrete, copy-paste-ready syntax reference whose Obsidian-specific sections are excellent. Its weaknesses are that about half the content duplicates standard Markdown knowledge Claude already has, the whole reference is inlined monolithically in SKILL.md with no progressive disclosure into reference files, and there is no workflow or verification guidance for composing a note.

Suggestions

Delete or move the standard-Markdown sections (Basic Formatting, Lists, Quotes, Code, Tables, Horizontal Rules, Footnotes) — Claude already knows GFM; keep only Obsidian extensions (wikilinks, embeds, callouts, properties, %%comments%%, tag rules, Mermaid internal-link classing), roughly halving the token cost.

Split the remaining reference into bundle files (e.g. references/links.md, references/callouts.md, references/properties.md) with a concise SKILL.md overview pointing to them one level deep, instead of the current monolithic 600-line inline reference.

Add a short decision guide or checklist (when to use a wikilink vs. a Markdown link, when to embed vs. link, how to verify callout/callout-type syntax against the supported types table) to give the reference a clear usage workflow.

DimensionReasoningScore

Conciseness

Roughly half of the ~600-line body re-teaches standard CommonMark/GFM that Claude already knows: 'Basic Formatting' (headings, bold/italic, escaping), 'Lists' (unordered/ordered/tasks), 'Quotes', 'Code' (inline, fenced blocks), 'Tables', 'Horizontal Rules', and 'Footnotes' are all vanilla Markdown. Only the Obsidian-specific sections (wikilinks, embeds, callouts, properties, %%comments%%, tags, Mermaid linking) add information Claude cannot be assumed to know, so the padding guideline for known concepts puts this at 'noticeably verbose; several unnecessary sections'.

2 / 5

Actionability

Every construct is given as exact, copy-paste-ready syntax in fenced examples — wikilinks with heading/block targets, embeds with image sizing ('![[image.png|300]]'), foldable callouts ('> [!faq]-'), frontmatter property types, math, Mermaid — plus a 'Complete Example' showing the constructs composed into a real note. Examples cover all common cases with no gaps.

5 / 5

Workflow Clarity

This is a pure syntax reference with no multi-step process, sequencing, or decision guidance — there are no 'steps' at all, matching the 'sequence present but checkpoints missing or implicit' level at best. The 'Complete Example' section partially demonstrates how to compose a note, but there is no guidance for choosing between constructs or verifying output, and the under-50-line simple-skill exception does not apply to a 600-line reference.

3 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so the entire syntax reference is inlined monolithically in SKILL.md. Section headers give good in-page navigation and the closing 'References' section links official docs, but the GFM half of the reference clearly belongs in a separate file (or nowhere), matching 'some structure but content that should be separate is inline'.

3 / 5

Total

13

/

20

Passed

Description

70%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 answers both what the skill does and when to use it with genuinely natural Obsidian-domain trigger terms, and it is clearly distinct from generic Markdown skills. It is weakened by marketing-style padding ('精准', '完美支持', '大幅提升效率') that inflates claims without specifying concrete capabilities, and it misses a few natural trigger synonyms (vault, backlinks, notes).

Suggestions

Replace the marketing intensifiers ('精准生成', '完美支持', '大幅提升...效率!') with concrete capability statements, e.g. '创建和编辑 Obsidian 笔记:wikilinks、Callout、嵌入、Frontmatter properties' — concrete verbs beat adjectives for specificity.

Add the missing natural trigger terms users actually say: 'vault/知识库', '双链/backlinks', '笔记 (notes)', and '.md', to lift trigger coverage and distinctiveness.

Keep the existing '当需要...' trigger clause but broaden it slightly to cover editing (not just creating) existing Obsidian notes, since the skill body covers both.

DimensionReasoningScore

Specificity

The description names the domain ("构建Obsidian知识库" — building an Obsidian vault) and several concrete capabilities ("带双向链接、Callout或Frontmatter的复杂笔记" — complex notes with wikilinks, callouts, frontmatter; "支持wikilinks与嵌入" — supports wikilinks and embeds), matching the 'names domain and 1-2 concrete actions' to 'several specific actions' range. However, marketing fluff ('精准生成' precisely generate, '完美支持' perfectly supports, '大幅提升...效率' greatly improves efficiency) pads the claims without adding concrete actions, keeping it below 4.

3 / 5

Completeness

Both 'what' ("使用此技能可精准生成标准Markdown文档,完美支持wikilinks与嵌入" — generates standard Markdown documents, supports wikilinks and embeds) and an explicit 'when' clause ("当需要编写带双向链接、Callout或Frontmatter的复杂笔记" — when needing to write complex notes with wikilinks, callouts, or frontmatter) are present. Not a 5 because the 'what' leans on vague intensifiers ('精准', '完美') instead of concrete trigger phrases for the full capability set.

4 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would actually say: 'Obsidian', '知识库' (knowledge base/vault), '双向链接' (bidirectional links), 'Callout', 'Frontmatter', 'wikilinks', '嵌入' (embeds), 'Markdown'. A few natural terms are missing (vault, backlinks/双链, notes/笔记 as a standalone trigger, .md), matching the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

Obsidian-specific triggers (Obsidian, wikilinks/双向链接, callouts, frontmatter in a vault context) establish a clear niche, but the broad phrase "生成标准Markdown文档" (generate standard Markdown documents) overlaps with generic Markdown-writing skills, matching 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict 5.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (621 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 2 missing, 1 suspicious

Warning

Total

14

/

16

Passed

Repository
anbeime/skill
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.