Obsidian Skills
Updated
A collection of agent skills for reading and writing Obsidian-specific file formats — markdown, Canvas, Base — directly from Claude Code.
/plugin marketplace add kepano/obsidian-skills && /plugin install obsidian@obsidian-skills Built and maintained by Obsidian CEO Steph Ango (@kepano)
What it does
Obsidian uses file formats beyond standard markdown — wiki links ([[]]), callouts, properties, Canvas, Base. A plain markdown-aware Claude Code can’t produce or edit these correctly. Obsidian Skills teaches Claude Code the full format set, so it can create and modify vault content natively.
Included skills
| Skill | Description |
|---|---|
| obsidian-markdown | Create and edit Obsidian markdown — wiki links, embeds, callouts, properties |
| obsidian-bases | Create Base files (database-shaped files) with views, filters, and formulas |
| json-canvas | Create and edit Canvas files (visual node-and-edge diagrams) |
| obsidian-cli | Drive the vault via the CLI — plugin/theme development, search, automation |
| defuddle | Extract clean markdown from web pages — saves tokens |
Prerequisites
The obsidian-cli skill requires Obsidian CLI:
- Install the latest Obsidian
- Settings → General → enable Command line interface
- Follow the prompt to add it to your system PATH (macOS:
/usr/local/bin/obsidian)
Once installed, the obsidian command searches vaults, opens notes, adds daily notes, and more from the terminal. See the Obsidian CLI docs for details.
Use cases
- “Turn these meeting notes into an Obsidian note” → generates a note with properties (date, attendees, tags) and wiki links.
- “Visualize the project structure as a Canvas” → outputs a JSON Canvas with nodes and edges.
- “Organize papers I’ve read into a Base” → creates a database file with filters and formulas.
Notes
- Follows the Agent Skills specification — compatible with Codex CLI and OpenCode in addition to Claude Code.
obsidian-markdown,obsidian-bases, andjson-canvaswork without Obsidian CLI — onlyobsidian-clineeds it.- MIT licensed.
Frequently Asked Questions
What is Obsidian Skills?
A collection of agent skills that lets Claude Code read and write Obsidian-specific file formats — wiki links, callouts, properties, Canvas, Base — natively. Built and maintained by Obsidian CEO Steph Ango (@kepano).
Where does it run?
Claude Code. It follows the Agent Skills specification, so it also works with Codex CLI and OpenCode.
How do I install it?
Add the marketplace, then install: `/plugin marketplace add kepano/obsidian-skills` followed by `/plugin install obsidian@obsidian-skills`. NPX Skills is also supported.
Which skills are included?
obsidian-markdown (wiki links, callouts, properties), obsidian-bases (database-shaped Base files), json-canvas (visual diagrams), obsidian-cli (CLI control and automation), and defuddle (clean markdown from web pages).
Do I need to install Obsidian CLI?
Only the obsidian-cli skill needs it. obsidian-markdown, obsidian-bases, and json-canvas work without Obsidian CLI.
What's the license?
MIT licensed.