obsidian-skills

Obsidian Skills is an open-source collection of agent skill definitions for use with Obsidian vaults, created by kepano (the creator of Obsidian's Minimal theme and other popular Obsidian tools). It follows the Agent Skills specification so that any compatible agent — including Claude Code, Codex CLI, and OpenCode — can learn Obsidian-specific workflows without custom prompting. The repository has accumulated over 32,000 stars on GitHub, signaling strong community interest.

What It Is

Obsidian Skills is a set of structured SKILL.md files that conform to the Agent Skills specification. Each skill teaches an AI coding agent how to work with a specific Obsidian file format or tool. Rather than being a plugin or app, it is a source-code package that developers and power users install into their agent's skills directory, enabling the agent to understand Obsidian-specific syntax and tooling natively.

Skills Included

The repository ships five skills out of the box:

• obsidian-markdown — Creates and edits Obsidian Flavored Markdown (.md) files, including wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
• obsidian-bases — Creates and edits Obsidian Bases (.base) files with views, filters, formulas, and summaries.
• json-canvas — Creates and edits JSON Canvas (.canvas) files with nodes, edges, groups, and connections.
• obsidian-cli — Interacts with Obsidian vaults via the Obsidian CLI, including plugin and theme development workflows.
• defuddle — Extracts clean Markdown from web pages using the Defuddle library, removing clutter to reduce token usage.

Installation Paths

The project supports three installation methods. Via the marketplace, agents can install it with a single /plugin marketplace add command. Via npx skills, users run npx skills add with either the SSH or HTTPS GitHub URL. For manual installation, users copy the relevant files into the agent's skills directory: /.claude for Claude Code, ~/.codex/skills for Codex CLI, or ~/.opencode/skills/ for OpenCode. OpenCode auto-discovers all SKILL.md files under its skills directory with no config changes required.

Open-Source Deployment Model

The project is released under the MIT License and is freely available on GitHub. There is no hosted service, no account required, and no proprietary component — the entire skill set is plain Markdown files that any agent runtime can consume. This makes it trivially forkable and extensible for teams that want to add custom Obsidian workflows.

Update: Active Development as of May 2026

According to the repository metadata, the project was created in January 2026 and last pushed in May 2026, indicating active early development. It carries GitHub topics including claude, codex, obsidian, opencode, and skills, reflecting its multi-agent compatibility focus. With 32,974 stars and 2,297 forks reported by the source, the project has seen rapid community adoption since launch.