obsidian

Read, search, create, and edit markdown notes in an Obsidian vault using filesystem tools.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill obsidian-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/tapway/shogun-os/tree/main/skills/general/note-taking/obsidian
Command: npx skills add https://github.com/tapway/shogun-os --skill obsidian-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault from an AI agent often fails due to shell quoting issues, unexpanded environment variables, and paths containing spaces. This Skill provides a filesystem-first workflow for reliably reading, searching, creating, and editing notes without fragile shell commands. ## Core Features & Use Cases - Note Reading & Listing: Read notes with line numbers via read_file and list markdown files with search_files instead of cat, find, or ls. - Content Search: Search note contents with regex patterns restricted to markdown files using search_files with target: "content". - Note Creation & Editing: Create notes with write_file, append content with anchored patch edits, and link related notes using [[wikilink]] syntax. - Use Case: Ask the agent to find every note mentioning a project name, then create a new meeting note in the vault that wikilinks to each matching project note. ## Quick Start Resolve the vault path from the OBSIDIAN_VAULT_PATH environment variable, then use the obsidian skill to search all markdown notes for a topic and create a new linked note with the findings.

Frequently Asked Questions about obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Obsidian notes by content with an AI agent?

Use search_files with target set to "content", a regex pattern, and file_glob set to "*.md" under the resolved vault path. This searches note contents directly and is preferred over grep or find shell commands.

How do I create a new note in an Obsidian vault programmatically?

Use write_file with the resolved absolute path and full markdown content. This avoids shell quoting issues from heredocs or echo, and you can include [[wikilinks]] to connect the new note to related content.

Why do file tools fail with the OBSIDIAN_VAULT_PATH variable?

File tools do not expand shell variables, so passing a path containing $OBSIDIAN_VAULT_PATH fails. Resolve the variable first via terminal, then pass the concrete absolute path to read_file, write_file, patch, or search_files.

Can this skill manage Obsidian plugins or graph view?

No, this skill only handles filesystem-based markdown operations. Plugin configuration, graph view, and canvas features require the Obsidian GUI and are explicitly out of scope.

How do I append content to an existing Obsidian note?

Read the note with read_file, then use patch for an anchored append when stable context exists, such as adding a section after a known heading. For appends with no stable anchor, a terminal command is acceptable as the clearest safe option.