cortex-debug-memory Skill
✓ VerifiziertDebugge und pflege die Speicherqualität, indem du die Nützlichkeit bewertest, kritische Informationen schützt, falsche Einträge löschst und Checkpoints nutzt, um Zustände wiederherzustellen.
- GitHub Stars
- 76
- Dateien
- 1
- Letzter Commit
- 12. Nov. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der cortex-debug-memory Skill?
Debugge und pflege die Speicherqualität, indem du die Nützlichkeit bewertest, kritische Informationen schützt, falsche Einträge löschst und Checkpoints nutzt, um Zustände wiederherzustellen.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den cortex-debug-memory skill
Diese Skill ermöglicht es Entwicklern, die Genauigkeit des Langzeitgedächtnisses eines Agents zu verwalten, wenn sie komplexe Memory-Systeme steuern. Sie bietet eine Suite von Tools, um gespeicherte Informationen zu auditieren, zu verfeinern und zu reparieren, falls ein Agent veraltete oder falsche Ergebnisse liefert. Durch den Einsatz dieser Skill kann ein Agent seine eigene Wissensbasis aktiv durch Bewertung, Schutz und Löschung verwalten.
Nutzer können die Retrieval-Qualität verbessern, indem sie Memories als nützlich oder nicht nützlich bewerten, um das Metamemory-Confidence-Modell zu trainieren. Für kritische Informationen, die niemals veralten dürfen, setzt das Anchor-Tool ein permanentes Heat-Level, um sicherzustellen, dass die Daten zu Session-Start injiziert werden. Die Skill enthält außerdem ein Validation-Tool, das Memories gegen das lokale Filesystem prüft, um Referenzen auf gelöschte Dateien oder verschobene Module zu identifizieren.
Bei riskanten Operationen erlaubt das Checkpoint-System das Speichern und Wiederherstellen von Zuständen. Dazu gehören auch automatische Checkpoints, die vor der Kontext-Kompression erstellt werden. Wenn ein Agent Daten entfernen muss, kann er einen Soft Delete durchführen, um die Heat zu senken, oder einen Hard Delete für eine dauerhafte Entfernung nutzen; geschützte Memories erfordern jedoch ein Force-Flag zum Löschen.
Was ein agent damit machen kann
- 1Falsche Informationen entfernenLösche ein spezifisches Memory, das nicht mehr korrekt ist, entweder per Soft Delete oder Hard Delete.
- 2Retrieval-Ranking verbessernGib Feedback zur Nützlichkeit von Memories, um Confidence-Scores anzupassen und zukünftige Ergebnisse zu verbessern.
- 3Datenverfall verhindernStelle sicher, dass zentrale Architektur-Entscheidungen verfügbar bleiben, indem du sie ankerst, damit sie niemals verfallen.
- 4Veraltete Referenzen identifizierenScanne das Projektverzeichnis, um Memories zu finden, die auf Dateien oder Module verweisen, die nicht mehr existieren.
- 5Memory-Änderungen rückgängig machenStelle den Memory-Zustand auf einen früheren Zeitpunkt wieder her, falls eine Bereinigungsaktion Probleme verursacht.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den cortex-debug-memory Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den cortex-debug-memory Skill in Plugin installieren
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Den cortex-debug-memory Skill in Claude Code installieren
~/.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memoryDen cortex-debug-memory Skill in Claude Code (project) installieren
.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory .claude/skills/cortex-debug-memoryDen cortex-debug-memory Skill in Codex installieren
~/.agents/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.agents/skills/cortex-debug-memoryDen cortex-debug-memory Skill in Gemini CLI installieren
~/.gemini/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.gemini/skills/cortex-debug-memoryDen cortex-debug-memory Skill in Claude.ai installieren
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
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarcdeust/cortex/skills/cortex-debug-memory is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-debug-memor ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-11-12github.com/cdeust/cortex/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 130 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Bestanden
SKILL.md
Auf GitHub ansehenDebug 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
Dateien in diesem Skill
1cortex-debug-memory Skill-Fragen
Wie installiere ich den cortex-debug-memory Skill in Claude Code?
Führe npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memory aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den cortex-debug-memory Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Wie kann ich verhindern, dass ein Memory während der Kompression verfällt oder verloren geht?
Du kannst ein Memory ankern, um seine Heat permanent auf 1.0 zu setzen. So wird sichergestellt, dass es zu Session-Start injiziert wird. Anker-Memories überleben zudem automatisch die Kompression.
Was ist der Unterschied zwischen einem Soft Delete und einem Hard Delete bei Memories?
Ein Soft Delete setzt die Heat des Memorys auf 0, sodass es nicht mehr auftaucht, aber technisch noch existiert. Ein Hard Delete hingegen entfernt das Memory dauerhaft.
Wie behebe ich irrelevante Ergebnisse beim Recall?
Du solltest schlechte Ergebnisse als nicht nützlich bewerten, gute Ergebnisse als nützlich markieren, nach Duplikaten oder widersprüchlichen Memories suchen und die Memory-Validierung ausführen, um veraltete Inhalte zu finden.