Skill cortex-debug-memory
✓ VerificadoDepure e mantenha a qualidade da memória avaliando a utilidade, protegendo informações críticas, excluindo entradas incorretas e restaurando a partir de checkpoints.
- Estrelas no GitHub
- 76
- Arquivos
- 1
- Último commit
- 12 de nov. de 2026
- Licença
- MIT
- Ferramentas permitidas
- —
O que a skill cortex-debug-memory faz?
Depure e mantenha a qualidade da memória avaliando a utilidade, protegendo informações críticas, excluindo entradas incorretas e restaurando a partir de checkpoints.
Resumo gerado a partir do SKILL.md da skill.
Sobre a skill cortex-debug-memory
Manter a precisão da recuperação de longo prazo de um agente é o que esta skill permite para desenvolvedores que gerenciam sistemas de memória complexos. Ela fornece um conjunto de ferramentas para auditar, refinar e reparar informações armazenadas quando um agente retorna resultados obsoletos ou incorretos. Ao usar esta skill, um agente pode gerenciar ativamente sua própria base de conhecimento por meio de avaliação, proteção e exclusão.
Os usuários podem melhorar a qualidade da recuperação avaliando as memórias como úteis ou não úteis para treinar o modelo de confiança da metamemória. Para informações críticas que nunca devem se degradar, a ferramenta de ancoragem define um nível de heat permanente para garantir que os dados sejam injetados no início da sessão. A skill também inclui uma ferramenta de validação que verifica as memórias em relação ao sistema de arquivos local para identificar referências a arquivos deletados ou módulos movidos.
Quando ocorrem operações de risco, o sistema de checkpoint permite salvar e restaurar estados. Isso inclui checkpoints automáticos criados antes da compactação de contexto. Se um agente precisar remover dados, ele pode realizar um soft delete para diminuir o heat ou um hard delete para remoção permanente, embora memórias protegidas exijam uma flag de força para serem deletadas.
O que um agente pode fazer com ela
- 1Remover informações incorretasDelete uma memória específica que não é mais precisa usando o método de soft delete ou hard delete.
- 2Melhorar o ranking de recuperaçãoForneça feedback sobre a utilidade da memória para ajustar os scores de confiança e melhorar resultados futuros.
- 3Prevenir a degradação de dadosGaranta que decisões arquiteturais centrais permaneçam disponíveis ancorando-as para que nunca se degradem.
- 4Identificar referências obsoletasEscaneie o diretório do projeto para encontrar memórias que referenciam arquivos ou módulos que não existem mais.
- 5Reverter alterações de memóriaRestaure o estado da memória para um ponto anterior caso uma operação de limpeza cause problemas.
Escrito a partir do SKILL.md da skill. Cada caso de uso é verificado com uma citação dele.
Como instalar a skill cortex-debug-memory
Cada comando copia a pasta da skill para o diretório de skills do cliente. Reinicie o cliente ou inicie uma nova sessão para carregá-la.Instalar a skill cortex-debug-memory no Plugin
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Instalar a skill cortex-debug-memory no Claude Code
~/.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memoryInstalar a skill cortex-debug-memory no Claude Code (project)
.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory .claude/skills/cortex-debug-memoryInstalar a skill cortex-debug-memory no Codex
~/.agents/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.agents/skills/cortex-debug-memoryInstalar a skill cortex-debug-memory no Gemini CLI
~/.gemini/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.gemini/skills/cortex-debug-memoryInstalar a skill cortex-debug-memory no 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
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou nas nossas verificações automáticas. Não é uma auditoria de segurança: leia os scripts antes de deixar um agente executá-los. Como as verificações funcionam
- Repositório de origem vinculado e acessívelcdeust/cortex/skills/cortex-debug-memory is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-debug-memor ↗Passou
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit 2026-11-12github.com/cdeust/cortex/commits ↗Passou
- Sem baixar e executar nem roubo de credenciais nos scriptsNo scripts in the skill folderPassou
- Sem instruções ocultas no SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Passou
- Ferramentas pré-aprovadas são restritasNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Passou
- O SKILL.md segue o formato Agent SkillsValid name and description; says when to use it; 130 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Passou
SKILL.md
Ver no 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
Arquivos desta skill
1Perguntas sobre a skill cortex-debug-memory
Como instalo a skill cortex-debug-memory no Claude Code?
Execute npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memory. O Claude Code carrega skills de ~/.claude/skills (todos os projetos) ou .claude/skills (um projeto) e usa uma skill quando a descrição dela corresponde à tarefa.
Quais clientes podem usar a skill cortex-debug-memory?
Qualquer cliente que leia o formato Agent Skills: Claude Code, Codex, Gemini CLI e claude.ai (envie como ZIP). Scripts da skill são executados apenas onde o cliente permite execução de código.
Como posso evitar que uma memória se degrade ou seja perdida durante a compactação?
Você pode ancorar uma memória para definir seu heat como 1.0 permanentemente, garantindo que ela seja injetada no início da sessão. Memórias ancoradas também sobrevivem à compactação automaticamente.
Qual é a diferença entre soft delete e hard delete para memórias?
Um soft delete define o heat da memória como 0 para que ela não apareça, mas ainda exista, enquanto um hard delete realiza uma remoção permanente.
Como corrijo resultados irrelevantes durante a recuperação (recall)?
Você deve avaliar os resultados ruins como não úteis, avaliar os resultados bons como úteis, verificar se há memórias duplicadas ou conflitantes e executar a validação de memória para encontrar conteúdo desatualizado.