← all repositories
kepano/obsidian-skills

Teaching AI agents to speak Obsidian

A standardized skill pack that lets Claude, Codex, and OpenCode manipulate your Obsidian vault without hallucinating wikilink syntax.

34.8k stars Coding Assistants
obsidian-skills
Velocity · 7d
+223
★ / day
Trend
steady
star history

What it does

This repo packages five “Agent Skills” — structured prompt modules that teach coding agents how to read and write Obsidian-specific formats. Drop them into Claude Code, Codex CLI, or OpenCode and the agent suddenly knows its .md from its .base from its .canvas.

The interesting bit

The project bets on an emerging Agent Skills specification rather than any single tool’s plugin API. That’s either forward-thinking standardization or a compatibility layer waiting to fracture — right now it covers Claude, Codex, and OpenCode with slightly different install paths for each.

Key highlights

  • obsidian-markdown — wikilinks, embeds, callouts, properties; the full Obsidian-flavored syntax
  • obsidian-bases — views, filters, formulas for the newer .base database format
  • json-canvas — node/edge/group manipulation for .canvas files (the open JSON Canvas spec, not just Obsidian’s flavor)
  • obsidian-cli — vault automation including plugin and theme development workflows
  • defuddle — web-to-markdown extraction that strips clutter to save tokens

Caveats

  • The README is essentially an install guide plus a table; there’s no usage example or before/after showing what the skills actually change in agent behavior
  • “34104 stars” appears suspiciously high for a repo with this scope; the source shows 34104 stars but minimal activity depth — verify independently if that number matters to you

Verdict

Worth a look if you’re already using Claude Code or Codex CLI with an Obsidian vault and tired of correcting link syntax. Skip it if you want deep documentation or don’t use one of the three supported agents.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.