convez.ai
SkillProdutividadeIntermediário
somaholiday

Memory Skills

somaholiday/memory-skills

Lê e escreve memórias estruturadas em Markdown para Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Skills 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-skills

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 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.
Ver o original no GitHub

Bom para

Relacionados