Obsidian Skills — Teach AI Agents to Use Obsidian CLI and Open Formats

Introduction

Obsidian Skills is an official set of agent skills created by Steph Ango (kepano), the creator of Obsidian. These skills teach AI coding agents to interact with Obsidian's CLI and work natively with open file formats including Markdown, Bases, and JSON Canvas.

What It Does

• Teaches agents to use the Obsidian CLI for vault management and file operations
• Enables reading, creating, and modifying Markdown with Obsidian conventions like frontmatter and wiki-links
• Provides skills for Bases, Obsidian's structured data format for tables and databases
• Includes skills for JSON Canvas, an open format for infinite spatial canvases
• Allows agents to manage vault configuration, templates, and daily notes
• Works with Claude Code and other agents supporting skill loading

Architecture Overview

Organized as markdown-based skill files grouped by capability. Each skill loads instructions and examples into the agent's context window. Skills reference CLI commands and format specs so the agent generates correct operations. No runtime dependency beyond Obsidian for CLI operations. All files are plain Markdown.

Self-Hosting & Configuration

• Clone and copy skill files to your agent's skills directory
• Obsidian needed locally only for CLI command execution
• No API keys or external services required
• Customize by editing markdown files to match your vault conventions
• Compatible with Claude Code, Cursor, and similar agents

Key Features

• Maintained by the maker of Obsidian ensuring accuracy with the app's design philosophy
• Covers Markdown, Bases, and JSON Canvas formats
• CLI integration for vault operations like creating notes and managing plugins
• Built on open standards so generated files work in any compatible tool
• Lightweight context footprint for efficient token usage

Comparison with Similar Tools

• Obsidian plugins — extend the app's UI; these skills extend AI agent capabilities
• Obsidian API — for building plugins inside Obsidian; these skills work outside in coding agents
• Foam / Dendron — alternative knowledge tools; these skills target Obsidian's specific ecosystem

FAQ

Q: Do I need Obsidian installed? A: File format skills work without it. CLI skills require a local installation.

Q: What is JSON Canvas? A: An open format for infinite spatial canvases storing nodes and edges in portable JSON.

Q: What are Bases? A: Obsidian's structured data format for database-like tables and views within vaults.

Q: Does it work with other agents? A: Yes. Any agent that loads markdown skill files can use them.

Sources

• https://github.com/kepano/obsidian-skills