Memory Skills
somaholiday/memory-skills
Lê e escreve memórias estruturadas em Markdown para Claude Code
Ver no GitHubSkills para Claude Code que permitem ler e escrever em um cofre de memória em Markdown. Integra-se opcionalmente com Obsidian para buscas contextualizadas, possibilitando que o Claude mantenha notas durável de conhecimentos, decisões e procedimentos entre sessões.
Instalação
npx convez-ai somaholiday/memory-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter histórico de decisões arquiteturais e padrões de código
- Guardar checklists de deployment e procedimentos recorrentes
- Armazenar contexto de problemas resolvidos para referência futura
- Integrar conhecimento acumulado em fluxos de trabalho com Claude Code
Veredito

Solução prática para persistência de conhecimento em projetos que usam Claude Code. A abordagem baseada em Markdown puro e a degradação elegante sem Obsidian a tornam portável; setup inicial é direto, ideal para equipes que querem externalizar memória contextual de IA.
README
A tradução para o português deste README ainda está na fila.
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 againstMEMORY_VAULT.
Requirements
Minimum:
- Claude Code with skill support
- A Markdown memory directory
MEMORY_VAULTset to that directory
Optional:
rgfor 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 opencommand; 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.