Obsidian Agent

Obsidian + Claude System

A complete system for managing Obsidian vaults with Claude Code and Cowork. Designed for two vaults (work and personal) with consistent structure, frontmatter schemas, agent skills, automation hooks, and migration tooling.

What's Included

obsidian-claude-system/
├── skills/
│   └── obsidian-vault-manager/
│       ├── SKILL.md                          # Claude Code skill definition
│       ├── references/
│       │   ├── frontmatter-schemas.md        # Complete YAML schema for all note types
│       │   └── templates.md                  # Note body templates
│       └── scripts/
│           ├── vault-health-check.sh         # Vault health audit script
│           └── process-inbox.py              # Auto-sort inbox notes
├── hooks/
│   ├── hook-configs.json                     # Claude Code hook configuration (incl. QMD Stop hook)
│   ├── update-modified.py                    # Auto-update modified timestamps
│   ├── link-to-daily.py                      # Auto-link new notes to daily note
│   └── validate-frontmatter.py              # Frontmatter validation
├── templates/
│   ├── work/CLAUDE.md                        # Agent instructions for work vault
│   └── personal/CLAUDE.md                    # Agent instructions for personal vault
├── scripts/
│   └── setup-vault.sh                        # Vault bootstrapping script
├── docs/
│   ├── vault-migration-guide.md              # How to convert an existing vault
│   └── plugin-guide.md                       # Recommended Obsidian plugins
└── README.md                                 # This file

Quick Start

1. Install Kepano's Official Obsidian Skills Plugin

This is the foundation — it teaches Claude the correct Obsidian file formats (markdown syntax, wikilinks, callouts, Bases, JSON Canvas, and the Obsidian CLI). Install it first:

# From the Claude Code plugin marketplace
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

Or install manually by cloning into your vault's `.claude/` folder:

cd ~/obsidian-vaults/work
git clone https://github.com/kepano/obsidian-skills.git .claude/skills/obsidian-skills

This gives Claude 5 skills: `obsidian-markdown` (wikilinks, embeds, callouts, properties), `obsidian-bases` (database views, filters, formulas), `json-canvas` (whiteboards), `obsidian-cli` (read/create/search notes via CLI), and `defuddle` (clean web clipping).

2. Install the Vault Manager Skill (this package)

This skill layers on top of Kepano's — it adds vault structure, workflows, frontmatter schemas, and lifecycle management. Copy it into your Claude Code skills directory:

cp -r skills/obsidian-vault-manager ~/.claude/skills/

Or if using Cowork, place it in your mounted `.skills/skills/` directory.

**How the two skills work together**: Kepano's skills handle the *format layer* (how to write correct Obsidian markdown, how to use the CLI, how to structure a .base fil