claude-memories-vault

Enforces conventions for writing and linking notes in the claude-memories Obsidian vault.

2|Updated Jul 28, 2026
One-click install
npx skills add https://github.com/mbadali25/useful-claude-add-ons --skill claude-memories-vault-mbadali25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-memories-vault
Source: https://github.com/mbadali25/useful-claude-add-ons/tree/main/skills/claude-memories-vault
Command: npx skills add https://github.com/mbadali25/useful-claude-add-ons --skill claude-memories-vault-mbadali25

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents malformed notes, broken wikilinks, and write collisions when an AI agent creates or edits pages in the claude-memories Obsidian vault, where strict frontmatter, filename, and locking conventions govern every write. ## Core Features & Use Cases - Frontmatter contract: Defines the six required fields (title, type, status, created, updated, tags), the eight legal type values, and the seed/developing/established status lifecycle so pages pass lint and appear in Dataview dashboards. - Filename and wikilink rules: Explains that filenames are the search index, that wikilinks resolve by filename not title, and how Windows filename restrictions (no colons) affect link text. - Write safety protocol: Documents the vault-lock.ps1 acquire/release workflow, the VAULT_LOCK_HELD wrapper exception, and the rule against hand-editing the pending-reflect queue or HOME.md. - Use Case: When asked to "write this down so I do not lose it", the agent searches existing concepts, takes the vault lock, creates a properly templated concept page with populated sources, and releases the lock. ## Quick Start Use the claude-memories-vault conventions to create a new concept note in the vault capturing the lesson from this session.

Frequently Asked Questions about claude-memories-vault

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a new note to the claude-memories Obsidian vault?

Search existing concepts first, acquire the lock with vault-lock.ps1 -Acquire, then create the page from the matching template in wiki/templates with all six frontmatter fields and a populated sources list. Always release the lock when finished, even on failure.

What frontmatter fields are required for Obsidian vault notes?

Every page needs title, type, status, created, updated, and tags. The type must be one of eight values such as concept, session, or decision, and status must be seed, developing, or established, or Dataview dashboards silently drop the page.

When should I use the vault instead of Claude Code auto-memory?

Use auto-memory for current operational state of one project, like ports or live branches. Use the vault for durable cross-project lessons worth recalling months later. When unsure, ask rather than guessing, since a misplaced fact gets buried either way.

Why do Obsidian wikilinks break on Windows filenames?

Wikilinks resolve by filename, not the title field, and Windows forbids colons in filenames. A title containing a colon must be linked using the hyphen-substituted filename, matching the file exactly rather than the prose.

What happens if the vault lock is already held?

A non-zero exit from vault-lock.ps1 -Acquire means another agent holds it, so stop and do not write. If VAULT_LOCK_HELD=1 is set, a parent wrapper already holds the lock for you, so write normally without acquiring or releasing.