read-memories — скилл для Claude Code: что делает и как установить
Ищет прошлые решения и договорённости в логах сессий Claude Code через DuckDB. Помогает восстановить контекст диалога без ручного поиска по файлам.
npx skills add duckdb/duckdb-skills --skill read-memories -a claude-codeЧто делает read-memories
Скилл обращается к утилите duckdb через инструмент Bash и сканирует файлы .jsonl с логами предыдущих сессий. Для парсинга используется функция read_ndjson, которая ищет ключевое слово по содержимому сообщений, извлекает имя проекта и дату, а затем возвращает до 40 свежих записей.
Поиск запускается по всем проектам в каталоге $HOME/.claude/projects/ либо сужается до текущей папки флагом --here. Инструкция требует от агента изучать найденные логи молча и сразу переходить к ответу, не пересказывая сырой JSON пользователю.
Для работы утилита duckdb должна быть заранее установлена в системе и доступна в PATH, иначе скрипт упадёт с ошибкой.
Какие задачи решает
- найти в истории прошлых сессий забытые архитектурные решения
- вспомнить правки и указания из закрытых диалогов
- ограничить контекстный поиск логами текущего репозитория
- извлечь нерешённые задачи и TODO из старых логов
Примеры запросов агенту
- Помнишь, как мы настраивали миграции базы данных в прошлый раз?
- Что мы решили по поводу структуры эндпоинтов авторизации? Поищи в прошлых сессиях.
- Найди в логах текущего проекта, какие задачи мы не успели закрыть.
Как установить read-memories
1Через Skills CLI (Vercel)
npx skills add duckdb/duckdb-skills --skill read-memories -a claude-code2Вручную: положить файлы
~/.claude/skills/read-memories/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/read-memories/
1Через Skills CLI (Vercel)
npx skills add duckdb/duckdb-skills --skill read-memories -a codex2Вручную: положить файлы
.agents/skills/read-memories/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add duckdb/duckdb-skills --skill read-memories -a cursor2Вручную: положить файлы
.cursor/skills/read-memories/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install duckdb/duckdb-skills read-memories2Вручную: положить файлы
.github/skills/read-memories/SKILL.md1Через Skills CLI (Vercel)
npx skills add duckdb/duckdb-skills --skill read-memories -a gemini-cli2Командой платформы
gemini skills install https://github.com/duckdb/duckdb-skills --path skills/read-memoriesВручную: положить файлы
.devin/skills/read-memories/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add duckdb/duckdb-skills --skill read-memories -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о read-memories
Как установить read-memories в Claude Code?
Выполните команду npx skills add duckdb/duckdb-skills --skill read-memories -a claude-code в терминале.
Что делает скилл read-memories?
Он ищет ключевые слова в логах сессий Claude Code с помощью DuckDB и возвращает контекст прошлых решений без вывода сырых записей.
Какие требования нужны для работы скилла?
В системе должен быть установлен CLI duckdb, а доступ к инструменту Bash должен быть разрешён агенту.
Исходный текст
SKILL.md · MIT
---
name: read-memories
description: >
Search past Claude Code session logs to recall prior decisions, patterns, or unresolved work.
Use when user says "do you remember", "what did we do", references past conversations, or you need context from prior sessions.
argument-hint: <keyword> [--here]
allowed-tools: Bash
---
Search past session logs silently — do NOT narrate the process. Absorb the results and continue with enriched context.
`$0` is the keyword. Pass `--here` as `$1` to scope to the current project only.
## Step 1 — Query
```bash
duckdb :memory: -c "
SELECT
regexp_extract(filename, 'projects/([^/]+)/', 1) AS project,
strftime(timestamp::TIMESTAMPTZ, '%Y-%m-%d %H:%M') AS ts,
message.role AS role,
left(message.content::VARCHAR, 500) AS content
FROM read_ndjson('<SEARCH_PATH>', auto_detect=true, ignore_errors=true, filename=true)
WHERE message::VARCHAR ILIKE '%<KEYWORD>%'
AND message.role IS NOT NULL
ORDER BY timestamp
LIMIT 40;
"
```
Search paths:
- All projects: `$HOME/.claude/projects/*/*.jsonl`
- Current only (`--here`): `$HOME/.claude/projects/$(echo "$PWD" | sed 's|[/_]|-|g')/*.jsonl`
Replace `<SEARCH_PATH>` and `<KEYWORD>` before running.
## Step 2 — Internalize
From the results, extract decisions, patterns, unresolved TODOs, and user corrections. Use this to inform your current response — do not repeat raw logs to the user.
© duckdb · MIT · duckdb/duckdb-skills