agentleFS
sergi-rzsergi-rz/claudia-os/.claude/skills/memory-search/SKILL.md

memory-search

Skill39 starsChanged 7 months agoMITView on GitHub

Busca en las memorias persistentes del usuario usando SQLite FTS5 (o grep como fallback). Usar cuando Claude necesite encontrar una memoria específica que no está cargada en el contexto activo, o cuando el usuario pregunte por algo que podría estar en memoria.

11 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 7 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    No requiere instalación adicional.

    line 44

“Common” is measured: kept by at least 6 in 10 of the 7 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Memory Search

Búsqueda activa sobre user/memory/ con SQLite FTS5. Los ficheros .md son siempre el source of truth; el índice SQLite es un derivado reconstruible automáticamente.

Personalización: antes de ejecutar, lee user/behavior.md en este directorio. Si tiene contenido, aplícalo como ajustes sobre el comportamiento de esta skill — en caso de conflicto con lo definido aquí, prevalece lo del usuario.

Cuándo usar esta skill

  • El usuario pregunta por algo que podría estar en memoria pero no aparece en contexto
  • MEMORY.md tiene muchas entradas y hay riesgo de que memorias relevantes no se carguen
  • El usuario quiere buscar explícitamente: "¿recuerdas algo sobre X?"

Modos de operación (auto-detectados, sin configuración)

ModoCondiciónComportamiento
PlenoPython + SQLite FTS5Búsqueda BM25 con ranking por relevancia
BásicoPython sin FTS5 (edge case)Búsqueda grep sobre los .md

FTS5 está disponible en prácticamente todas las instalaciones modernas de Python. Claude Code ya requiere Python, por lo que no hay dependencias adicionales.

Uso

# Buscar
python3 .claude/skills/memory-search/memory_search.py <query>

# Ver estado del índice
python3 .claude/skills/memory-search/memory_search.py --status

# Reconstruir índice manualmente
python3 .claude/skills/memory-search/memory_search.py --rebuild

Sin setup

No requiere instalación adicional. sqlite3 es parte de la stdlib de Python.

El índice vive en user/memory/.index/memory.db (gitignored, no se sincroniza). Si se borra o corrompe, se reconstruye automáticamente en la siguiente búsqueda. Si algún .md es más reciente que el índice, se reconstruye automáticamente.

Estructura de memoria compatible

Los ficheros .md en user/memory/ aceptan frontmatter opcional:

---
type: user | feedback | project | reference
importance: critical | high | medium | low
created: YYYY-MM-DD
last_accessed: YYYY-MM-DD
---

Sin frontmatter también funciona — el índice incluye todo el contenido del fichero.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.