/obsidian-vault

name: obsidian-vault
description: Manage Obsidian vault operations. Handles markdown formatting, YAML frontmatter, folder organization, internal linking, and vault-specific conventions. Use when creating, updating, or organizing Obsidian notes.

Obsidian Vault

Overview

This skill provides vault-specific knowledge and technical operations for managing an Obsidian vault. It handles markdown formatting, YAML frontmatter structure, folder hierarchy, attachment organization, and internal linking conventions specific to the vault structure.

When to Use This Skill

Use this skill when:

• Creating new notes in the Obsidian vault
• Updating existing notes with proper formatting
• Organizing notes into correct folder hierarchy
• Managing attachments and images
• Formatting YAML frontmatter with appropriate tags
• Creating internal links between notes
• Following vault-specific naming conventions
• Ensuring notes meet quality and structure standards

Core Capabilities

1. Vault Structure and Organization

Understand and apply the folder hierarchy defined for the vault:

**Main folders:**

• `Programming/` - Code concepts, languages, tools (subfolders: Python/, UNIX/)
• `Projects/` - Project-specific notes and documentation
• `Daily Log/` - Daily notes and meeting logs
• `Templates/` - Note templates

<!-- Add your own topic folders here (e.g., Research/, Art/, Recipes/) -->

**See `references/vault_structure.md`** for complete hierarchy, placement rules, and decision trees.

2. File Naming Conventions

Apply proper naming based on note type:

**Regular notes:**

• Format: Descriptive name with spaces
• Examples: `Python Decorators.md`, `Docker Tips.md`
• Rule: Filename serves as title (no H1 header inside)

**Daily notes:**

• Format: `YYYY-MM-DD.md`
• Location: `Daily Log/` folder
• Examples: `2025-02-26.md`, `2025-10-21.md`

**Meeting notes:**

• Format: `YYYY-MM-DD - Meeting Topic.md`
• Location: `Daily Log/` or relevant topic folder
• Example: `2025-10-21 - Sprint Review.md`

**See `references/vault_structure.md`** for complete naming rules and conventions.

3. Markdown Formatting Standards

Format notes according to vault-specific markdown conventions:

**YAML Frontmatter (required):**

---
tags:
  - relevant_tag1
  - relevant_tag2
---

**Header hierarchy:**

• NO H1 (`#`) - filename is the title
• Start with H2 (`##`) for main sections
• Use H3 (`###`) for subsections

**Internal linking:**

• Use `[[Note Title]]` for wiki-links
• **READ target notes before linking** - verify relevance from actual content, not just titles
• Only link when there's genuine topical overlap with specific content justification
• Never guess link relevance from note titles alone
• Remove links that seem related by title but aren't after reading content
• Create connections between related notes
• Link to related concepts

**Code blocks:**

• Use fenced blocks with language specification
• Include working examples

**See `references/markdown_formatting.md`** for comprehensive formatting guide, callouts, tables, and content patterns.

4. Attachment Management

Store and reference images/files correctly:

**Storage location:**

• Folder-specific: Each main folder has `attachments/` subfolder
• Example: Programming images -> `Programming/attachments/`

**Referencing:**

![Alt text](attachments/image_name.png)

**Naming:**

• Use descriptive names for images
• Include context: `docker_architecture_diagram.png`

5. Semantic Search

Use [`obsidian-semantic`](https://github.com/ravila4/obsidian-semantic-search) to find existing notes by meaning, not just keywords.

# Find notes about a topic
obsidian-semantic search "dependency injection patterns" -n 5

# Find notes related to a specific note
obsidian-semantic related "Programming/Python/Unit Testing.md" -n 5

# Search within a folder
obsidian-semantic search "docker" --folder "Programming/"

# Filter by tag
obsidian-semantic search "habits" --tag "review"

**When to use `search`:** Before creating new notes (check for duplicates/related content), when looking for notes to link to, when user asks to find notes on a topic.

**When to use `related`:** After creating/updating a note to suggest links, when user asks "what's related to X?"

6. Tag System

Apply appropriate tags from established taxonomy:

**Tag categories:**

• **Technical:** `python`, `docker`, `git`, `data_processing`
• **Tools:** `pandas`, `numpy`, `matplotlib`, `jupyter`
• **Content types:** `meeting_notes`, `concepts`, `tools`, `analysis`, `reference`, `tutorial`, `troubleshooting`

<!-- Add your own domain-specific tags here -->

**Selection rules:**

• Choose 2-5 relevant tags
• Include domain/technical tag
• Include content type when appropriate
• Use lowercase with underscores

**See `references/markdown_formatting.md`** for complete tag catalog and guidelines.

Workflow

When creating or updating notes:

1. **Determine note type** - Regular, daily, or meeting note 2. **Choose location** - Use folder decision tree from `references/vault_structure.md` 3. **Name appropriately** - Follow naming conventions for note type 4. **Create frontmatter** - Add YAML with relevant tags 5. **Format content** - Apply markdown standards from `references/markdown_formatting.md` 6. **Add internal links** - Connect to related notes 7. **Store attachments** - Place in correct folder's `attachments/` subfolder 8. **Verify quality** - Check against standards

Resources

references/

**vault_structure.md** - Complete folder hierarchy, file naming conventions, attachment storage rules, folder placement decision tree, tag catalog, and organization guidelines. Load when determining where notes should be placed or how they should be named.

**markdown_formatting.md** - YAML frontmatter structure, markdown formatting standards, header hierarchy rules, internal linking syntax, code blocks, callouts, tables, content organization patterns, and quality