winsorllc Obsidian Skill
Interact with local Obsidian vaults for reading, writing, organizing, and searching notes.
When to Use
- User wants to read notes from their Obsidian vault
- User wants to create new notes or update existing ones
- User mentions their "second brain", "Obsidian", or "vault"
- Taking notes for later reference in a knowledge base
- Creating Daily Notes automatically
- Searching across all vault content
- Working with backlinks and wikilinks
Setup
No additional installation required. Requires:
- Node.js (for advanced features)
- Access to the user's Obsidian vault directory
Configuration
The skill uses these environment variables (can be set via the chat):
OBSIDIAN_VAULT_PATH=/path/to/your/vault
If not set, defaults to ~/Obsidian/VaultName or prompts the user.
Usage
Quick Commands
# List available vaults
obsidian-list
# Search notes
obsidian-search "keyword"
# Read a note
obsidian-read "folder/note-name"
# Create or update a note
obsidian-write "folder/note-name" "content here"
# Create a daily note
obsidian-daily
# List recent notes
obsidian-recent 10
Workflow Examples
Reading from Vault
User: What's in my Obsidian vault about AI agents?
Agent: [Uses obsidian-search to find relevant notes]
Creating Notes
User: Take a note about the meeting with John about the project
Agent: [Uses obsidian-write to create a note with the meeting notes]
Agent: [Offers to add wikilinks to related notes in the vault]
Daily Notes Workflow
User: Create a daily note for today
Agent: [Uses obsidian-daily to create today's note with template]
Script Details
obsidian-list
Lists all directories in the vault root - useful for seeing vault structure.
obsidian-search
Searches for text in all .md files in the vault. Uses case-insensitive grep.
obsidian-read
Reads the content of a specific note. Supports subdirectories.
obsidian-write
Creates a new note or updates an existing one. Automatically creates parent directories.
obsidian-daily
Creates a daily note in the format YYYY-MM-DD.md with optional template.
Template location: .obsidian/daily-note-template.md in vault root.
obsidian-recent
Lists the most recently modified notes.
obsidian-w-links
Lists all wikilinks ( [[note]] ) in a note - shows what a note links to.
obsidian-backlinks
Finds all notes that link to a specific note - shows what links TO that note.
obsidian-tags
Lists all #tags used in the vault with counts.
Common Workflows
Research & Note Taking
- Search existing notes:
obsidian-search "topic" - Read related notes:
obsidian-read "topic/overview" - Create new note:
obsidian-write "topic/new-ideas.md" "# New Ideas\n\n..."
Daily Workflow
- Create daily note:
obsidian-daily - Add to daily note:
obsidian-write "2024-01-15" "- discussed X\n- action: do Y" - Link to project:
obsidian-write "2024-01-15" "(see [[projects/active]])"
Knowledge Graph Exploration
- Find tags:
obsidian-tags - Explore backlinks:
obsidian-backlinks "Concept" - Find connections:
obsidian-w-links "Idea"
Limitations
- Only works with markdown (.md) files
- No DataviewJS query support
- Vault must be accessible on the local filesystem
- No sync with Obsidian Sync or Remotely Save
Tips
- Use subdirectories to organize notes (e.g., "projects/ai/notes.md")
- Add frontmatter to notes for metadata (title, date, tags)
- Use wikilinks [[note-name]] to connect related ideas
- Create a daily note template in
.obsidian/daily-note-template.md