obsidian

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

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill obsidian-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/note-taking/obsidian
Command: npx skills add https://github.com/perasyudha/Nyxora --skill obsidian-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault through an AI agent requires consistent, safe file operations—resolving the vault path, searching notes, and editing markdown without shell quoting errors or broken paths. ## Core Features & Use Cases - Vault Path Resolution: Resolves the vault location via the OBSIDIAN_VAULT_PATH environment variable with a fallback to ~/Documents/Obsidian Vault. - Note Operations: Read notes with line numbers, list markdown files, search filenames and content, create notes, append content, and apply targeted patch edits. - Wikilink Support: Creates [[Note Name]] links between related notes to maintain vault connectivity. - Use Case: Ask the agent to find all notes mentioning a project, then create a summary note linking to each one with wikilinks. ## Quick Start Search my Obsidian vault for all notes mentioning "quarterly planning" and create a new summary note linking to each of them.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search notes in an Obsidian vault?

Use search_files with target "files" and a filename pattern for name searches, or target "content" with a regex pattern and file_glob "*.md" for content searches. Always pass the resolved absolute vault path rather than shell variables.

How do I append content to an existing Obsidian note?

Read the note first, then use patch for an anchored append when stable context exists, such as adding after a known heading. Use write_file to rewrite the whole note when a patch would be fragile, or terminal for simple appends.

How is the Obsidian vault path configured?

Set the OBSIDIAN_VAULT_PATH environment variable, typically in ${NYXORA_HOME:-~/.nyxora}/.env. If unset, the fallback path is ~/Documents/Obsidian Vault. File tools require the resolved absolute path, not the variable itself.

Why do file operations fail with vault paths containing spaces?

Shell commands mishandle paths with spaces and do not expand variables like $OBSIDIAN_VAULT_PATH in file tools. Resolve the vault path first and pass the concrete absolute path directly to read_file, write_file, patch, or search_files.

How do wikilinks work when creating Obsidian notes?

Obsidian links notes using [[Note Name]] syntax in markdown content. When creating notes with write_file, include wikilinks to related notes so the vault's graph connections are maintained automatically.