Skill cortex-debug-memory
✓ VerificadoDepura y mantén la calidad de la memoria calificando su utilidad, protegiendo información crítica, eliminando entradas incorrectas y restaurando desde checkpoints.
- Estrellas en GitHub
- 76
- Archivos
- 1
- Último commit
- 12 nov 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill cortex-debug-memory?
Depura y mantén la calidad de la memoria calificando su utilidad, protegiendo información crítica, eliminando entradas incorrectas y restaurando desde checkpoints.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill cortex-debug-memory
Mantener la precisión de la recuperación a largo plazo de un agente es lo que esta SKILL permite a los desarrolladores que gestionan sistemas de memoria complejos. Proporciona un conjunto de herramientas para auditar, refinar y reparar la información almacenada cuando un agente devuelve resultados obsoletos o incorrectos. Al usar esta SKILL, un agente puede gestionar activamente su propia base de conocimientos mediante la calificación, protección y eliminación.
Los usuarios pueden mejorar la calidad de la recuperación calificando las memorias como útiles o no útiles para entrenar el modelo de confianza de la metamemoria. Para la información crítica que nunca debe degradarse, la herramienta de anclaje establece un nivel de calor permanente para asegurar que los datos se inyecten al inicio de la sesión. La SKILL también incluye una herramienta de validación que comprueba las memorias contra el sistema de archivos local para identificar referencias a archivos eliminados o módulos movidos.
Cuando ocurren operaciones de riesgo, el sistema de checkpoints permite guardar y restaurar estados. Esto incluye checkpoints automáticos creados antes de la compactación del contexto. Si un agente necesita eliminar datos, puede realizar un soft delete para reducir el calor o un hard delete para una eliminación permanente, aunque las memorias protegidas requieren un flag de fuerza para ser eliminadas.
Lo que un agente puede hacer con ella
- 1Eliminar información incorrectaElimina una memoria específica que ya no es precisa utilizando un método de soft delete o hard delete.
- 2Mejorar el ranking de recuperaciónProporciona feedback sobre la utilidad de la memoria para ajustar las puntuaciones de confianza y mejorar resultados futuros.
- 3Prevenir la degradación de datosAsegura que las decisiones arquitectónicas principales permanezcan disponibles anclándolas para que nunca se degraden.
- 4Identificar referencias obsoletasEscanea el directorio del proyecto para encontrar memorias que hagan referencia a archivos o módulos que ya no existen.
- 5Revertir cambios en la memoriaRestaura el estado de la memoria a un punto anterior si una operación de limpieza causa problemas.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill cortex-debug-memory
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill cortex-debug-memory en Plugin
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Instalar la skill cortex-debug-memory en Claude Code
~/.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memoryInstalar la skill cortex-debug-memory en Claude Code (project)
.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory .claude/skills/cortex-debug-memoryInstalar la skill cortex-debug-memory en Codex
~/.agents/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.agents/skills/cortex-debug-memoryInstalar la skill cortex-debug-memory en Gemini CLI
~/.gemini/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.gemini/skills/cortex-debug-memoryInstalar la skill cortex-debug-memory en Claude.ai
npx degit cdeust/Cortex/skills/cortex-debug-memory cortex-debug-memory && zip -r cortex-debug-memory.zip cortex-debug-memory # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cortex-debug-memory.zip
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Superó nuestras comprobaciones automáticas. No es una auditoría de seguridad: lee los scripts antes de dejar que un agente los ejecute. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblecdeust/cortex/skills/cortex-debug-memory is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-debug-memor ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit 2026-11-12github.com/cdeust/cortex/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Aprobado
- SKILL.md sigue el formato de Agent SkillsValid name and description; says when to use it; 130 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Aprobado
SKILL.md
Ver en GitHubDebug Memory — Fix, Rate, Protect, and Restore
Keywords
debug, fix, bad memory, wrong, delete, forget, protect, rate, quality, restore, checkpoint, undo, stale, incorrect, mark useful, mark not useful, anchor, unprotect
Overview
Tools for maintaining memory quality — rate memories as useful or not, protect critical ones from decay, forget incorrect ones, validate against the filesystem, and restore from checkpoints when things go wrong.
Use this skill when: Recall returns wrong results, memories are stale, you need to undo changes, or you want to improve retrieval quality through feedback.
Workflow
Fix Bad Memories
Soft delete (sets heat to 0, memory still exists but won't surface):
cortex:forget({
"memory_id": <id>,
"hard": false
})
Hard delete (permanent removal):
cortex:forget({
"memory_id": <id>,
"hard": true
})
Protected memories require "force": true to delete.
Rate Memory Quality
Provide feedback to train the metamemory confidence model:
cortex:rate_memory({
"memory_id": <id>,
"useful": true
})
Or mark as not useful:
cortex:rate_memory({
"memory_id": <id>,
"useful": false,
"reason": "outdated — we no longer use this approach"
})
Ratings adjust the memory's confidence score, which affects future retrieval ranking. Over time, this trains the system to surface better results.
Protect Critical Memories
Anchor a memory (heat=1.0 permanently, injected at session start):
cortex:anchor({
"memory_id": <id>,
"reason": "Core architecture decision — never decay"
})
Validate Against Reality
Check if memories reference things that still exist:
cortex:validate_memory({
"directory": "<project root>"
})
Returns a list of stale memories (referencing deleted files, moved modules, etc.) that should be forgotten or updated.
Checkpoint and Restore
Save a checkpoint before risky operations:
cortex:checkpoint({
"action": "save",
"label": "before-cleanup"
})
Restore if something went wrong:
cortex:checkpoint({
"action": "restore",
"label": "before-cleanup"
})
List available checkpoints:
cortex:checkpoint({
"action": "list"
})
Checkpoints are also created automatically before context compaction (via the compaction hook).
Common Issues
Recall returns irrelevant results:
- Rate the bad results as
useful: false - Rate the good results as
useful: true - Check if there are duplicate/conflicting memories on the same topic
- Run
validate_memoryto find stale content
Too many memories on the same topic:
- Run
cortex:consolidate— CLS will merge similar episodic memories into semantic ones - Manually
forgetduplicates
Memory seems wrong/outdated:
- Forget the old memory
- Remember the corrected version
- The knowledge graph will update automatically
Lost important context after compaction:
- Check
cortex:checkpoint({ "action": "list" })for auto-checkpoints - Restore the most recent pre-compaction checkpoint
- Anchored memories survive compaction automatically
Archivos de esta skill
1Preguntas sobre la skill cortex-debug-memory
¿Cómo instalo la skill cortex-debug-memory en Claude Code?
Ejecuta npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memory. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill cortex-debug-memory?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Cómo puedo evitar que una memoria se degrade o se pierda durante la compactación?
Puedes anclar una memoria para fijar su calor en 1.0 de forma permanente, asegurando que se inyecte al inicio de la sesión. Las memorias ancladas también sobreviven automáticamente a la compactación.
¿Cuál es la diferencia entre un soft delete y un hard delete para las memorias?
Un soft delete establece el calor de la memoria en 0 para que no aparezca, pero la memoria sigue existiendo, mientras que un hard delete realiza una eliminación permanente.
¿Cómo soluciono los resultados irrelevantes durante la recuperación?
Debes calificar los malos resultados como no útiles, los buenos como útiles, buscar memorias duplicadas o conflictivas y ejecutar la validación de memoria para encontrar contenido obsoleto.