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

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
.basedatabase format - json-canvas — node/edge/group manipulation for
.canvasfiles (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.