obsidian

Read, search, and create Markdown notes in a local Obsidian vault.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill obsidian-afel6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/note-taking/obsidian
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill obsidian-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly access and manage Markdown notes inside a local Obsidian vault without manually navigating folders or opening a GUI application. It reduces friction for programmatic searches, bulk listing, and scripted note creation or appending during research workflows.

Core Features & Use Cases

  • Read individual notes by filename to surface content for analysis or summarization.
  • List and browse all Markdown notes or folder-specific collections to discover relevant files.
  • Full-text search across the vault to find notes by keyword or phrase using standard shell utilities.
  • Create and append notes with Obsidian-friendly Markdown and wikilinks to maintain interlinking.
  • Use Case: Automate extraction of literature notes, append experimental observations to a running lab notebook, or compile meeting notes into a summary document.

Quick Start

Read the note named "Well Log Summary" from my Obsidian vault and show its contents.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search markdown notes in a local Obsidian vault from the command line?

To search markdown notes in a local Obsidian vault, the Skill uses standard shell utilities like grep and find. It performs full-text searches across your vault directory to locate notes by keyword or phrase.

Can I create and append content to Obsidian notes using a shell script?

You can create and append content to Obsidian notes using shell scripts. The Skill uses standard Unix commands like echo and cat to write Obsidian-friendly Markdown with wikilinks, enabling scripted note creation during research workflows.

What is needed to read markdown files from an Obsidian vault programmatically?

Reading markdown files from an Obsidian vault programmatically requires the vault path accessible via the OBSIDIAN_VAULT_PATH variable. Standard Unix utilities and filesystem read/write permissions are also needed to surface note contents.

Does this tool work with existing local vault management workflows for Obsidian?

The tool works with local vault management workflows for Obsidian by operating directly on the filesystem. It avoids GUI navigation, allowing you to list files, read individual notes, and append experimental observations directly from a shell environment.

What are the limitations of using Unix utilities for Obsidian vault search and management?

Using Unix utilities for Obsidian vault search limits operations to local file paths and standard shell commands like find and grep. It requires manual setup of the OBSIDIAN_VAULT_PATH environment variable and relies entirely on filesystem read/write permissions.