Obsidian Zettelkasten Skill

Overview

Help user interact with their personal Zettelkasten vault - a knowledge management system with 993+ notes covering their learning, projects, and ideas.

Vault Location

Path: ~/Documents/Zettelkasten/

Vault Structure

Zettelkasten/
├── copilot/          # AI copilot files
├── Files/            # Attachments, images, PDFs
├── Reference/        # Reference materials
├── Templates/        # Note templates
└── Zettelkasten/     # Main notes directory

Total notes: 993+ markdown files

Common Operations

Using Obsidian MCP Server

IMPORTANT: Always use the Obsidian MCP tools instead of direct file operations:

• •mcp__obsidian__obsidian_list_notes - List notes in directories
• •mcp__obsidian__obsidian_read_note - Read note content
• •mcp__obsidian__obsidian_global_search - Search across vault
• •mcp__obsidian__obsidian_update_note - Create/update notes
• •mcp__obsidian__obsidian_manage_frontmatter - Manage YAML frontmatter
• •mcp__obsidian__obsidian_manage_tags - Manage tags

Searching Notes

Use the MCP global search tool:

mcp__obsidian__obsidian_global_search with query, pageSize, etc.

Creating Notes

CRITICAL: When creating notes via MCP, ALWAYS add frontmatter using this template:

---
created: YYYY-MM-DD
type: note
tags: [(relevant tags go here, comma separated)]
related:
aliases:
---

Process for creating notes:

1. •Ask where it should go (usually Zettelkasten/Notes/ or Zettelkasten/Life/)
2. •Ask for the filename
3. •ALWAYS include frontmatter in the content with:
   • •created: Current date in YYYY-MM-DD format
   • •type: note (always)
   • •tags: Intelligently populate based on note content/topic
   • •related: Leave empty for user to fill
   • •aliases: Leave empty for user to fill
4. •Use mcp__obsidian__obsidian_update_note with the full content including frontmatter

Why: The MCP bypasses Obsidian's Templater plugin, so you must manually add frontmatter to match the user's template structure found in Templates/Note Template.md

Reading Notes

When user references a note:

• •Search for it by name/keyword
• •Read the file
• •Understand context and links

Obsidian Features Available

The vault has these plugins installed:

• •dataview: Query notes with SQL-like syntax
• •templater: Dynamic templates
• •obsidian-vimrc-support: Vim keybindings
• •quickadd: Quick note creation
• •calendar: Calendar view
• •excalibrain: Visual knowledge graph
• •And 17 more plugins

When to Use This Skill

Use this skill when user:

• •Asks to search their Zettelkasten
• •Wants to create a new note
• •References existing notes
• •Asks about their knowledge base
• •Wants to query/analyze their notes

Best Practices

1. •Always ask before creating notes - Don't assume structure
2. •Use search first - Check if similar notes exist
3. •Respect user's organization - Follow their existing patterns
4. •Suggest connections - Link related notes when relevant
5. •Use templates - If user has templates, use them

Examples

User asks: "Search my notes for information about fish shell"

rg -i "fish shell" ~/Documents/Zettelkasten --type md

User asks: "Create a note about today's fish migration"

• •Ask: Where? (Zettelkasten/ or Reference/?)
• •Ask: What filename?
• •Create with proper frontmatter/structure

User asks: "Do I have any notes on tmux?"

find ~/Documents/Zettelkasten -name "*tmux*.md"
# or
rg -i "tmux" ~/Documents/Zettelkasten --type md -l

Important Notes

• •This is the user's personal knowledge base
• •Treat it with care - these are their thoughts and learnings
• •Don't make assumptions about structure without asking
• •The vault is their long-term memory, not Claude's

Integration with Other Skills

This skill is separate from Claude's memory system (see memory skill).

• •This vault: User's personal knowledge
• •Memory skill: Claude's context about the user
• •Different purposes: Don't confuse the two!