Guides

Obsidian Skills Tutorial for AI Agents

A practical guide to using Obsidian as project memory for AI agents and installing Obsidian Skills.

Published August 9, 2026

You have probably heard about Obsidian and may be deciding whether it belongs in your workflow. The practical answer is simple: Obsidian is useful when you want local notes, research, project context, and long-running agent memory to stay in files you control.

Obsidian Skills make that workspace easier for AI agents to use.

What Obsidian is

Obsidian is a local-first note-taking app built around Markdown files. A vault is a folder on your device. Each note is a normal .md file inside that folder.

This file model is the reason Obsidian works well with AI agents. The agent can read and edit real files. Obsidian helps organize those files with links between notes, note properties, visual boards, and database-style views. With Obsidian Publish, selected Markdown notes can also become a public website.

A short history of Obsidian

Obsidian was founded by Shida Li and Erica Xu in March 2020. They had already built Dynalist together. Steph Ango, known online as kepano, later joined Obsidian as CEO in 2023 after being an active community member.

The product became popular because it gave people ownership of their notes. Notes stay as local files. The app works offline. The format remains readable outside the app. That combination attracted writers, researchers, students, developers, and people building personal knowledge systems.

The work use case has grown too. In 2025, Obsidian made commercial use free and said people in more than 10,000 organizations were already using it for work. In 2026, Obsidian launched a new Community site and developer dashboard, pointing to a large plugin and theme ecosystem.

Sources: Obsidian about page, free for work announcement, and Community site and developer dashboard announcement.

Why Obsidian fits AI agent workflows

AI agents need context they can inspect and update. Obsidian vaults already contain that kind of context: project notes, meeting notes, research, product ideas, reading lists, tasks, decisions, drafts, and documentation.

The best first use case is small. Ask the agent to organize one project folder, clean rough notes, add metadata, create a project dashboard, summarize research into linked notes, or map a topic on Canvas. Obsidian Skills help because they give the agent rules for Obsidian's formats.

Is Obsidian used for real development?

Obsidian is used in professional software work as a knowledge and planning layer. It sits beside GitHub, the IDE, CI, issue tracking, and production docs.

Common development uses include architecture notes, RFC drafts, debugging logs, API notes, product specs, meeting notes, decision records, research notes, release planning, documentation drafts, and plugin or theme development.

This also explains why Obsidian appears in vibe-coding workflows. A person can keep product ideas, constraints, decisions, prompts, screenshots, and implementation notes in one vault. An agent can then use that material as working context. The same pattern works in structured engineering workflows when backups, review, and source control are part of the process.

What Obsidian CLI is

Obsidian CLI is the official command-line interface for Obsidian. It lets external tools control a running Obsidian app from the terminal.

For AI agents, the CLI matters because terminal access is already part of many agent environments. The CLI can help an agent read notes, create notes, search a vault, update properties, work with tasks, inspect links, and support plugin development. It can also help with screenshots, errors, and developer tools when building or debugging plugins and themes.

Obsidian CLI requires the Obsidian 1.12 installer and a running Obsidian app. In practice, the vault should be open before asking the agent to operate on it.

What Obsidian Skills are

Obsidian Skills are a set of agent skills for Obsidian created by Kepano. The package teaches skills-compatible agents how to understand Obsidian notes, database-style views, Canvas files, CLI workflows, and web-to-Markdown cleanup.

This is a focused package. Each skill covers one format or workflow an agent needs to understand.

Obsidian Markdown skill

The Obsidian Markdown skill helps an agent write notes that behave correctly inside Obsidian. Markdown is the base format. Obsidian adds vault-specific habits: wikilinks, embeds, properties, callouts, tags, footnotes, highlights, comments, math, and diagrams.

Use it when the agent needs to turn rough notes into clean Obsidian notes, add useful properties, create links between related notes, preserve links while rewriting, or prepare notes for use in Bases.

Obsidian Bases skill

The Obsidian Bases skill helps an agent create and edit .base files. A Base is a view over notes. It can show selected notes as a table, cards, list, or map. It can filter by folder, tags, properties, dates, and formulas.

Use it for project dashboards, content calendars, reading lists, task views, research databases, CRM-style contact lists, and meeting note indexes. The skill matters because Bases are syntax-sensitive. Property names, formulas, filters, and YAML structure need to be correct.

JSON Canvas skill

The JSON Canvas skill helps an agent create and edit Obsidian Canvas files. Canvas is for visual thinking. It lets you arrange notes, cards, groups, and connections on a board.

Use it for product maps, research clusters, architecture sketches, decision trees, content plans, workflow diagrams, and topic maps. The practical result is a Canvas file that opens in Obsidian with readable layout and connected ideas.

Obsidian CLI skill

The Obsidian CLI skill helps an agent use the official CLI safely and consistently. Use it when the agent needs to interact with the running Obsidian app: search the vault, read notes, create notes, update properties, inspect links, reload plugins, capture screenshots, or check errors.

For coding agents such as Codex, Claude Code, and OpenCode, this skill is the bridge between terminal workflows and Obsidian.

Defuddle skill

The Defuddle skill helps an agent turn web pages into clean Markdown. Research pages often include navigation, ads, cookie banners, sidebars, and unrelated blocks. Defuddle extracts the main readable content so the agent can save, summarize, and format it with less noise.

Use it for saving articles into Obsidian, turning documentation pages into notes, building research notes, and keeping source URLs with imported material.

A practical first workflow

Start with one folder. Choose a project folder where mistakes are easy to review.

Ask the agent to inspect the folder and propose a plan. It should explain which notes it wants to create, which properties it wants to add, and whether it wants to create a Base or Canvas. Let it make one change first. Review that change in Obsidian.

A good first task is a small project dashboard: clean several project notes, add properties, link related notes, and create a Base for active items.

Where Obsidian Skills are most useful

Obsidian Skills are useful when your vault has repeatable structure. They work well for project dashboards, research libraries, reading notes, meeting notes, product planning, documentation drafts, daily notes, personal CRM, content planning, plugin development, theme development, and agent memory.

The value is strongest when the agent needs to preserve structure across many notes.

Safety notes

An Obsidian vault is local. An agent with file access can change real files.

Use backups. Start with a test folder. Ask the agent to show planned changes before writing. Review bulk edits. Treat skills like software packages: read the repository, check the maintainer, and understand what the skill asks the agent to do.

Obsidian has also been investing in ecosystem safety. Its Community site work includes plugin review, developer identity, and clearer review signals for users. The same habit applies to skills: install from sources you trust.

Obsidian CLI or MCP?

Obsidian CLI and MCP can both connect agents to Obsidian workflows.

Obsidian CLI is direct. The agent uses terminal commands against a running Obsidian app. This fits local workflows, coding agents, plugin development, and vault automation.

MCP is useful when your agent setup already standardizes around tool servers. For many local workflows, Obsidian CLI plus Obsidian Skills is enough: the skills teach the formats, and the CLI gives the agent a practical way to operate.

Who should use Obsidian Skills?

Use Obsidian Skills if you already use Obsidian and want an AI agent to work with your vault.

They are a good fit for Obsidian power users, developers, writers, researchers, Claude Code users, Codex users, OpenCode users, plugin developers, theme developers, and people using Obsidian as project memory.

The main benefit is precision. The agent gets rules for Obsidian's formats instead of guessing.

FAQ

What are Obsidian Skills?

Obsidian Skills are agent skills that teach AI agents the formats and workflows used inside an Obsidian vault.

Do Obsidian Skills work with Codex?

Yes. Obsidian Skills can be used by skills-compatible coding agents such as Codex when the skills are installed in the agent environment.

Do I need Obsidian CLI?

Obsidian CLI is useful when the agent needs to interact with a running Obsidian app from the terminal.

Can an agent edit my Obsidian vault?

Yes. If the agent has file access, it can edit vault files. Use backups and review planned changes before bulk edits.

Is Obsidian used professionally?

Yes. Obsidian is used for professional knowledge work, planning, documentation, research, and software project context.

What is a good first project?

Start with a small project dashboard. Ask the agent to clean several notes, add properties, link related notes, and create a Base for active items.