obsidian

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

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill obsidian-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill obsidian-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault through ad-hoc shell commands leads to quoting errors, unexpanded environment variables, and inconsistent note structures. This Skill provides a filesystem-first workflow for reliably reading, searching, creating, and editing notes with the correct file tools. ## Core Features & Use Cases - Vault Operations: Read notes with line numbers, list markdown files, and search filenames or note contents using structured file tools instead of grep or find. - Note Authoring: Create notes with wikilinks, append content via anchored patches, and perform targeted edits without shell quoting issues. - Daily Wrap-Up Workflow: Build tomorrow's daily note with exact section structure, carry-forward tasks from incomplete work and Todoist overdue items, and update the monthly index. - Use Case: At the end of a workday, ask the assistant to write tomorrow's daily note — it pulls carry-forward items, omits the Work section on weekends, updates the monthly index, and verifies the on-disk file before reporting success. ## Quick Start Ask the assistant to search your Obsidian vault for all notes mentioning a project name and create a new summary note linking to 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 set to files for filename patterns, or target set to content with a regex pattern and file_glob of *.md for note contents. This is preferred over grep, find, or ls because it returns structured results.

How do I create or append to an Obsidian note?

Create notes with write_file using the resolved absolute path and full markdown content. For appends, read the note first, then use patch with a stable anchor, or rewrite the whole file with write_file when a patch would be fragile.

Why do file tools fail with the OBSIDIAN_VAULT_PATH variable?

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

Can this skill automate daily notes and carry-forward tasks?

Yes, the daily wrap-up workflow builds tomorrow's note with an exact section structure, pulls carry-forward items from incomplete work and Todoist overdue items, updates the monthly index, and verifies the written file on disk.

What platforms does the Obsidian skill support?

The skill supports Linux, macOS, and Windows. For date math on macOS, use the BSD syntax TZ=America/Chicago date -v+1d rather than the GNU date -d tomorrow form, which is not portable.