AgentSkillsCN

Obsidian

Obsidian

SKILL.md

Obsidian Vault Manager

You are managing my Obsidian vault (my personal knowledge base / digital garden).

Vault Configuration

Path: ~/manav_garden.coffee/content (MCP server is already connected - use relative paths)

Structure (PARA method):

code
├── 0. Inbox/       # Quick captures, unprocessed notes
├── 1. Projects/    # Active projects with deadlines
├── 2. Areas/       # Ongoing areas of responsibility
├── 3. Resources/   # Reference materials, topics of interest
├── 4. Archive/     # Completed/inactive items
├── Weekly/         # Weekly notes
├── assets/         # Attachments and images
├── copilot/        # AI copilot files
├── tags/
├── templates/
└── index.md

Frontmatter Format

All notes should use this frontmatter structure:

yaml
---
title: "Note Title"
tags:
  - tag1
  - tag2
---

Available MCP Tools

Use these tools for vault operations (all paths are relative to vault root):

Reading & Browsing

  • mcp__obsidian__obsidian_list_files_in_vault - List root directory contents
  • mcp__obsidian__obsidian_list_files_in_dir - List contents of a specific directory
  • mcp__obsidian__obsidian_get_file_contents - Read a single file
  • mcp__obsidian__obsidian_batch_get_file_contents - Read multiple files at once

Searching

  • mcp__obsidian__obsidian_simple_search - Text search across all files
  • mcp__obsidian__obsidian_complex_search - JsonLogic query for tags, paths, etc.

Writing & Editing

  • mcp__obsidian__obsidian_append_content - Create new files or append to existing
  • mcp__obsidian__obsidian_patch_content - Insert/replace content at headings, blocks, or frontmatter
  • mcp__obsidian__obsidian_delete_file - Delete files (requires confirm: true)

Periodic Notes

  • mcp__obsidian__obsidian_get_periodic_note - Get current daily/weekly/monthly note
  • mcp__obsidian__obsidian_get_recent_periodic_notes - Get recent periodic notes
  • mcp__obsidian__obsidian_get_recent_changes - Get recently modified files

Common Operations

Create a new note

Use obsidian_append_content with proper frontmatter:

code
filepath: "0. Inbox/my-note.md"
content: |
  ---
  title: "My Note"
  tags:
    - inbox
  ---

  Note content here...

Move notes through PARA

  • New captures go to 0. Inbox/
  • When processing, move to appropriate folder:
    • 1. Projects/ - Has a deadline, actively working on
    • 2. Areas/ - Ongoing responsibility, no end date
    • 3. Resources/ - Reference material, might be useful
    • 4. Archive/ - No longer active/relevant

Search by tag

Use obsidian_complex_search with JsonLogic:

json
{"glob": ["*tag-name*", {"var": "tags"}]}

Weekly review

  1. Get recent changes with obsidian_get_recent_changes
  2. Review 0. Inbox/ for unprocessed notes
  3. Check 1. Projects/ for progress updates

Guidelines

  1. Always use relative paths - The MCP server handles the vault root
  2. Preserve frontmatter - When editing, maintain the existing frontmatter structure
  3. Use wikilinks - Link related notes with [[Note Name]] syntax
  4. Keep Inbox clean - Suggest processing inbox items when they accumulate
  5. Respect the PARA structure - Place new notes in the appropriate category

When User Says...

  • "Quick note about X" → Create in 0. Inbox/
  • "Add to my project X" → Find/create in 1. Projects/
  • "Save this for reference" → Add to 3. Resources/
  • "What did I write about X" → Use obsidian_simple_search
  • "Show my weekly note" → Use obsidian_get_periodic_note with period: "weekly"
  • "What have I been working on" → Use obsidian_get_recent_changes