Awesome-omni-skill obsidian

Read, write, search, and manage Obsidian vault notes. Use when: (1) Reading/writing markdown notes, (2) Searching vault content, (3) Managing daily/periodic notes, (4) Tracking tasks or oncall incidents. Supports filesystem access and Local REST API.

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/development/obsidian" ~/.claude/skills/diegosouzapw-awesome-omni-skill-obsidian && rm -rf "$T"

manifest: skills/development/obsidian/SKILL.md

source content

Obsidian Vault Integration

Configuration

export OBSIDIAN_VAULT_PATH="/path/to/your/vault"
export OBSIDIAN_API_KEY="your-api-key-here"           # From: Obsidian Settings → Local REST API
export OBSIDIAN_DAILY_FORMAT="Journal/Daily/%Y-%m-%d.md"  # Optional
export OBSIDIAN_TODO_FILE="Inbox/Tasks.md"            # Optional

CLI Tools

Filesystem (obsidian.sh)

./scripts/obsidian.sh fs-read <path>            # Read note
./scripts/obsidian.sh fs-write <path> <content> # Write note
./scripts/obsidian.sh fs-list [dir]             # List .md files
./scripts/obsidian.sh fs-search <query>         # Grep search
./scripts/obsidian.sh fs-daily-append <content> # Append to daily note

Thought (Daily Notes)

thought "Great idea for the app"
thought "Meeting went well" meeting work

Todo Tracking

todo add "Review PR" work --due tomorrow --priority high
todo done 1                    # Complete by number
todo done "PR"                 # Complete by search
todo delete 2                  # Remove task
todo list                      # Show pending
todo list work                 # Filter by tag

See: references/todo.md

Oncall Tracking

oncall start                   # Start shift
oncall log "Alert fired" incident database
oncall resolve "Fixed it" database
oncall summary                 # View current shift
oncall end                     # End and archive

See: references/oncall.md

REST API (obsidian.sh)

./scripts/obsidian.sh status              # Check connection
./scripts/obsidian.sh read <path>         # Read via API
./scripts/obsidian.sh write <path> <content>
./scripts/obsidian.sh daily               # Get daily note
./scripts/obsidian.sh daily-append <content>
./scripts/obsidian.sh search <query>      # Simple search

See: references/api-reference.md

Quick Filesystem Access

# Read
cat "$OBSIDIAN_VAULT_PATH/folder/note.md"

# Write
cat > "$OBSIDIAN_VAULT_PATH/folder/note.md" << 'EOF'
# My Note
Content here
EOF

# Search
grep -r "term" "$OBSIDIAN_VAULT_PATH" --include="*.md"

Decision Guide

Need	Method
Fast read/write	Filesystem
Quick thoughts/notes	`thought` CLI
Task management	`todo` CLI
Oncall/incidents	`oncall` CLI
Search by frontmatter	REST API
Dataview queries	REST API
Execute commands	REST API
No Obsidian running	Filesystem

Reference Docs

API Reference - REST API endpoints and curl examples
Thought Reference - Quick notes to daily journal
Todo Reference - Task management with Obsidian Tasks format
Oncall Reference - Incident tracking and shift management