memory-skills

Memory Skills

Claude Code skills for reading from and writing to a Markdown memory vault.

The skills assume memories are Markdown files in a directory pointed to by MEMORY_VAULT. If that directory is also an Obsidian vault, the optional memory-obsidian helper can use Obsidian CLI for better search context.

Included

• memory-read — search and load relevant memories before answering or acting.
• memory-write — draft, confirm, write, link, and commit durable memory notes.
• bin/memory-obsidian — optional helper for deterministic Obsidian CLI calls against MEMORY_VAULT.

Requirements

Minimum:

• Claude Code with skill support
• A Markdown memory directory
• MEMORY_VAULT set to that directory

Optional:

• rg for filesystem search fallback
• Git in the memory vault, if you want memory writes committed
• Obsidian desktop app + Obsidian CLI, if you want context-rich Obsidian search
• macOS for the helper's memory-obsidian open command; search/read still degrade cleanly when Obsidian CLI is unavailable

Setup

Create or choose a memory vault:

mkdir -p ~/Memory
export MEMORY_VAULT="$HOME/Memory"

Persist the variable in your shell profile if you want it available in every Claude Code session.

Option A: Install as a Claude Code plugin

From Claude Code:

/plugin marketplace add somaholiday/memory-skills
/plugin install memory-skills@memory-skills

For a local checkout, use the checkout path instead:

/plugin marketplace add /path/to/memory-skills
/plugin install memory-skills@memory-skills

Restart Claude Code after installing.

Option B: Copy skills manually

mkdir -p ~/.claude/skills
cp -R skills/memory-read ~/.claude/skills/
cp -R skills/memory-write ~/.claude/skills/

Restart Claude Code.

Optional: Install the Obsidian helper

Put bin/memory-obsidian somewhere on PATH:

mkdir -p ~/.local/bin
cp bin/memory-obsidian ~/.local/bin/
chmod +x ~/.local/bin/memory-obsidian

Then verify:

MEMORY_VAULT="$HOME/Memory" memory-obsidian vault-id
MEMORY_VAULT="$HOME/Memory" memory-obsidian search-context "example" --limit 5

If Obsidian CLI is not installed, the helper exits cleanly and the skills fall back to direct filesystem search.

Usage

Ask Claude Code naturally:

Check memory for how we handled auth redirects last time.

Remember this deployment checklist for later.

The write skill requires Claude to show the full draft and wait for explicit confirmation before writing.

Memory file format

---
date: YYYY-MM-DD
tags: [lowercase, useful, tags]
related:
  - "[[another-memory-file]]"
---

# Descriptive Title

Focused memory content.

Suggested filename pattern:

YYYY-MM-DD topic-slug.md

Portability notes

• These skills do not require pi.
• These skills do not require Obsidian.
• Obsidian support is best-effort and only used when available.
• Direct reads/writes work anywhere Claude Code can access MEMORY_VAULT.