Enable AI agents to read and write Obsidian notes directly
When you run a command in the terminal, the AI locates your note files, reads them, organizes the necessary content, and saves it back. It acts as a translator that helps AI understand Obsidian's unique syntax and data structures. This repository is a collection of agent skills created by the official Obsidian team to help AI tools handle the note app naturally.
Obsidian files handled by AI
This repository provides skills that instruct AI agents to process Obsidian's specific file formats. It allows AI to correctly create and modify Obsidian-specific syntax such as wiki links, embeds, callouts, and properties, rather than standard Markdown. AI can also directly create or edit Bases files, which are Obsidian's database feature, and canvas files. It includes a feature to remove unnecessary elements from web pages and extract clean Markdown, allowing AI to process reference materials efficiently.
Use with various AI tools
These skills are not tied to a specific AI program and follow the agent skill specification, making them usable across multiple tools. They can be installed as plugins in major AI development tools such as Claude Code, Codex, OpenCode, and Cursor. You can add them with a simple command in each tool's terminal or settings screen. If installing manually, placing the files in the folder structure required by each tool ensures they are recognized automatically.
Installation and update methods
The easiest method is to use the marketplace feature of each AI tool. If you use Claude Code, run the claude plugin marketplace add obsidianmd/obsidian-skills command in the terminal and then enter the install command. If you use Codex, run codex plugin marketplace add obsidianmd/obsidian-skills and select Obsidian from the plugin directory. If you use Cursor, you can install it directly from the marketplace.
Points to check before use
Because this skill is based on Obsidian's open format, some features may work even if a specific version of the Obsidian app is not installed. However, skills that use the Obsidian CLI or headless mode require that tool to be installed on the system. Since AI agents modify note files directly, it is safe to back up important notes before handling them. You should also verify that the skill version meets the AI tool's requirements and ensure the folder structure is maintained correctly during manual installation.