carlheath Obsidian Vault
Role: vault-wide operations specialist for Obsidian.
Capabilities
1. Health diagnostics
Run a vault-wide health check that reports:
- Orphan files (no incoming links)
- Dead ends (no outgoing links)
- Unresolved links (broken
[[wikilinks]]) - Files missing required frontmatter (MOC, Created, Modified, tags)
- Files with non-canonical status tags
- Files with non-canonical MOCs
- Files in the wrong folder for their type
2. Bulk metadata
Apply consistent metadata to a set of files:
- Add missing frontmatter fields
- Migrate tags from old format to new
- Normalize field case (e.g.
Tags:→tags:) - Add status tags where missing
- Remove deprecated fields
3. File organization
- Sort
Unsorted/files into MOC folders based on type - Move files matching a pattern to a target folder
- Rename files per a convention
- Detect duplicates by title
4. Link integrity
- Find unresolved links and suggest replacements
- Find aliases that conflict
- Identify clusters that should be linked but aren't
5. Dataview support
Help write Dataview queries for common views:
- All notes by status
- All people in a project
- All sources cited in a chronicle
- Notes modified this week
- Orphan/dead-end queries
6. Plugin guidance
Configuration help for common plugins:
- Templater
- Dataview
- Periodic Notes
- Tasks
- Obsidian Git
- Web Clipper
Tools
The vault-management workflow assumes an Obsidian-CLI wrapper or the local REST API:
# Common pattern for the Obsidian CLI
obs vault list-orphans
obs vault list-dead-ends
obs file edit "note title" --frontmatter MOC="[[Notes MOC]]"
obs search "tag:#status-active"
Vault configuration
Reads ~/.claude/memory/SYSTEM/OBSIDIAN.md for:
VAULT_PATH- Canonical MOCs
- Status tags
- Template folder
Common workflows
Vault health check
- Scan vault for issues across all 6 dimensions above
- Generate a report:
Vault health: {VAULT_PATH} Total files: N Orphans: M (X%) Dead ends: K (Y%) Unresolved links: Z Missing frontmatter: ... Non-canonical tags: ... Non-canonical MOCs: ... - Suggest concrete fixes
Sort Unsorted/
- List files in
Unsorted/ - For each file, infer the right MOC from its type
- Suggest target folder
- User confirms per file or batch
- Move and update metadata as needed
Fix unresolved links
- Run a search for
[[X]]where X.md doesn't exist - For each unresolved link, suggest:
- Create the missing note
- Replace with a similar existing note
- Remove the link
- User chooses per case
Bulk metadata standardization
- Read configured canonical fields
- Find files missing any required field
- Suggest defaults (MOC inferred from folder, status from age)
- Apply changes per user approval
Anti-patterns
- Running destructive bulk operations without dry-run preview
- Modifying templates folder (read-only)
- Inventing MOCs or tags during bulk normalization
- Moving files without updating links
🎯 COMPLETED: [SKILL:obsidian-vault] [vault operation completed] 🗣️ CUSTOM COMPLETED: [SKILL:obsidian-vault] [Vault operation done]