How do I install the Obsidian skill?

Run npx skillmds@latest add modbender/obsidian-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian by modbender — Agent Skill

Name: Obsidian
Author: modbender

Obsidian

Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.

modbender Updated Sep 21, 2026 12 repo stars

File contents

Obsidian Knowledge Base

Obsidian vault = folder with Markdown files + .obsidian/ config.

Configuration

Vault Path: /home/ruslan/webdav/data/ruslain
Env: OBSIDIAN_VAULT=/home/ruslan/webdav/data/ruslain

CLI Usage

Scripts location: /home/ruslan/.openclaw/workspace/skills/obsidian/scripts

Note: Global flags (--vault, --json) must come BEFORE the command.

export OBSIDIAN_VAULT=/home/ruslan/webdav/data/ruslain
cd /home/ruslan/.openclaw/workspace/skills/obsidian/scripts

# Search (fuzzy/phonetic) - uses ripgrep for speed
python3 obsidian_search.py "$OBSIDIAN_VAULT" "query" --limit 10 --json

# List notes
python3 obsidian_cli.py --json list                    # all notes
python3 obsidian_cli.py --json list "Projects"         # in folder

# List folders
python3 obsidian_cli.py --json folders

# Read note
python3 obsidian_cli.py --json read "Note Name"

# Create note
python3 obsidian_cli.py --json create "Title" -c "Content" -f "Folder" -t tag1 tag2
python3 obsidian_cli.py --json create "Title" -c "Content" --auto-folder  # auto-detect folder

# Edit note
python3 obsidian_cli.py --json edit "Note" append -c "Text to append"
python3 obsidian_cli.py --json edit "Note" prepend -c "Text at start"
python3 obsidian_cli.py --json edit "Note" replace -c "New full content"
python3 obsidian_cli.py --json edit "Note" replace-section -s "Summary" -c "New section text"

# Tags
python3 obsidian_cli.py --json tags

# Links (incoming/outgoing)
python3 obsidian_cli.py --json links "Note Name"

# Suggest folder for content
python3 obsidian_cli.py --json suggest-folder "content text" --title "Note Title"

Workflow: Query Knowledge Base

Run obsidian_search.py with user query
Read top results if needed for context
Formulate answer based on found content
Cite sources: [[Note Name]]

Workflow: Save Note

If no folder specified → run suggest-folder or use --auto-folder
Create note with create command
Add appropriate tags based on content
Report created path to user

Workflow: Edit Note by Prompt

User prompts like:

"Добавь резюме в конец заметки X" → edit X append -c "..."
"Перепиши заметку Y более кратко" → read note, rewrite, edit Y replace -c "..."
"Добавь секцию 'Выводы' в заметку Z" → edit Z replace-section -s "Выводы" -c "..."

Note Format

---
created: 2024-01-15T10:30:00
modified: 2024-01-15T12:00:00
tags:
  - project
  - work
---

# Title

Content with [[wikilinks]] and #inline-tags.

Wikilinks

[[Note Name]] — link to note
[[Note Name|Display Text]] — link with alias
[[Note Name#Section]] — link to section

Frontmatter Fields

Standard fields:

created — creation timestamp
modified — last edit timestamp
tags — list of tags
aliases — alternative names for linking

Search Behavior

obsidian_search.py uses:

ripgrep for fast initial filtering
Title matching (highest weight)
Tag matching
Fuzzy content search with phonetic transliteration (RU↔EN)
Returns: path, title, score, matched context

---name: obsidian-2description: Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.---# Obsidian Knowledge BaseObsidian vault = folder with Markdown files + `.obsidian/` config.## Configuration- **Vault Path:** `/home/ruslan/webdav/data/ruslain`- **Env:** `OBSIDIAN_VAULT=/home/ruslan/webdav/data/ruslain`## CLI UsageScripts location: `/home/ruslan/.openclaw/workspace/skills/obsidian/scripts`Note: Global flags (`--vault`, `--json`) must come BEFORE the command.```bashexport OBSIDIAN_VAULT=/home/ruslan/webdav/data/ruslaincd /home/ruslan/.openclaw/workspace/skills/obsidian/scripts# Search (fuzzy/phonetic) - uses ripgrep for speedpython3 obsidian_search.py "$OBSIDIAN_VAULT" "query" --limit 10 --json# List notespython3 obsidian_cli.py --json list # all notespython3 obsidian_cli.py --json list "Projects" # in folder# List folderspython3 obsidian_cli.py --json folders# Read notepython3 obsidian_cli.py --json read "Note Name"# Create notepython3 obsidian_cli.py --json create "Title" -c "Content" -f "Folder" -t tag1 tag2python3 obsidian_cli.py --json create "Title" -c "Content" --auto-folder # auto-detect folder# Edit notepython3 obsidian_cli.py --json edit "Note" append -c "Text to append"python3 obsidian_cli.py --json edit "Note" prepend -c "Text at start"python3 obsidian_cli.py --json edit "Note" replace -c "New full content"python3 obsidian_cli.py --json edit "Note" replace-section -s "Summary" -c "New section text"# Tagspython3 obsidian_cli.py --json tags# Links (incoming/outgoing)python3 obsidian_cli.py --json links "Note Name"# Suggest folder for contentpython3 obsidian_cli.py --json suggest-folder "content text" --title "Note Title"```## Workflow: Query Knowledge Base1. Run `obsidian_search.py` with user query2. Read top results if needed for context3. Formulate answer based on found content4. Cite sources: `[[Note Name]]`## Workflow: Save Note1. If no folder specified → run `suggest-folder` or use `--auto-folder`2. Create note with `create` command3. Add appropriate tags based on content4. Report created path to user## Workflow: Edit Note by PromptUser prompts like:- "Добавь резюме в конец заметки X" → `edit X append -c "..."`- "Перепиши заметку Y более кратко" → read note, rewrite, `edit Y replace -c "..."`- "Добавь секцию 'Выводы' в заметку Z" → `edit Z replace-section -s "Выводы" -c "..."`## Note Format```markdown---created: 2024-01-15T10:30:00modified: 2024-01-15T12:00:00tags: - project - work---# TitleContent with [[wikilinks]] and #inline-tags.```## Wikilinks- `[[Note Name]]` — link to note- `[[Note Name|Display Text]]` — link with alias- `[[Note Name#Section]]` — link to section## Frontmatter FieldsStandard fields:- `created` — creation timestamp- `modified` — last edit timestamp - `tags` — list of tags- `aliases` — alternative names for linking## Search Behavior`obsidian_search.py` uses:- ripgrep for fast initial filtering- Title matching (highest weight)- Tag matching- Fuzzy content search with phonetic transliteration (RU↔EN)- Returns: path, title, score, matched context

Frequently asked questions