obsidian-skills: 5 skills by kepano

Claude Code writes into your Obsidian vault as if it were plain markdown — and breaks wikilinks, callouts, properties and Bases, because it doesn't know the format 🔥 obsidian-skills fixes that.

What it does

A set of 5 Agent Skills that teaches your agent to work with an Obsidian vault properly. The repo was created by kepano (Steph Ango) — the CEO of Obsidian, so the format is documented first-hand. Compatible with Claude Code, Codex and OpenCode.

Here's what's inside:

1. obsidian-markdown — reads and writes Obsidian Flavored Markdown: wikilinks [[...]], embeds, callouts, properties.
2. obsidian-bases — works with Bases: views, filters, formulas, summaries.
3. json-canvas — creates and edits Canvas files: nodes, edges, groups.
4. obsidian-cli — drives the vault from the CLI (for plugin and theme development).
5. defuddle — pulls clean markdown out of web pages, strips the junk and saves tokens.

The result: the agent stops guessing at syntax and produces notes that open in Obsidian with no broken links and no broken Bases.

How to install

Through the agent's plugin marketplace:

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

Or via npx:

npx skills add git@github.com:kepano/obsidian-skills.git

Or by hand — drop the repo contents into a .claude folder at the root of the vault (for Codex — a skills/ folder in ~/.codex/skills).

When to take it

• You keep notes in Obsidian and ask the agent to write or fix them — and it breaks the format.
• You need Bases, Canvas or properties, not "just markdown".
• You're building your knowledge base on Obsidian (see the knowledge-base card) and want the agent to be a tidy co-author of it.

Example

Say "break this article down into a note with a callout summary and links to related topics" — with obsidian-skills the agent will produce correct [[wikilinks]], a callout and properties, and pull clean text from a URL via defuddle.

Gotchas

• This is not an Obsidian plugin and not an MCP. The skills upgrade the agent; Obsidian itself doesn't change.
• You need an agent that supports Agent Skills (Claude Code and compatible ones). Without one it's useless.
• obsidian-cli and defuddle may need extra installs (a CLI utility / Node) — check the README.
• The agent genuinely edits vault files — keep git/backups and review the changes.
• This is a fine-tuning of the setup, not a turnkey "knowledge base": for the full setup see knowledge-base, and for notes in Notion — Notion MCP. You build your own skills with skill-creator.