Menu
Build a prioritised memory index from all memory files and reference trackers. Use when rebuilding the memory index, after memory CRUD operations, or when agents need a sorted discovery list.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | crux-skill-memory-index |
| description | Build a prioritised memory index from all memory files and reference trackers. Use when rebuilding the memory index, after memory CRUD operations, or when agents need a sorted discovery list. |
Builds a prioritised index of all memory files by scanning the configured memory directories, joining with reference tracker data, and writing a sorted index to .crux/memory-index.yml.
# Rebuild the index (uses default config path)
python .cursor/skills/crux/crux-skill-memory-index/scripts/memory-index.py
# Rebuild with a custom config path
python .cursor/skills/crux/crux-skill-memory-index/scripts/memory-index.py --config path/to/config.json
# Post-dream rebuild (checks enableMemories flag, then rebuilds)
python .cursor/skills/crux/crux-skill-memory-index/scripts/post-dream.py
The post-dream.py script is a convenience wrapper invoked programmatically by the /crux-dream workflow after memory extraction or REM sleep completes. It:
.crux/crux-memories.json — exits early if enableMemories is not "true"memory-index.py to rebuild the indexThis script is not a Cursor event hook and is not registered in .cursor/hooks.json.
All settings are read from .crux/crux-memories.json under the cruxMemories key:
| Setting | Default | Purpose |
|---|---|---|
storage.memoriesDir | memories | Root directory for base memories |
storage.agentMemoriesDir | memories/agents | Root for agent-scoped memories |
storage.indexFile | .crux/memory-index.yml | Output index file path |
referenceTracking.trackingDir | .crux/reference-tracking | Directory containing .refs.yml files |
typePriority | [core, redflag, goal, learning, idea, archived] | Sort order for memory types |
The generated .crux/memory-index.yml contains a flat list under the memories key, sorted by:
typePriority rank higherEach entry has:
| Field | Type | Description |
|---|---|---|
id | string | 7-char hex hash from frontmatter (omitted if memory predates the id field) |
slug | string | Memory slug derived from filename |
title | string | Title from frontmatter |
description | string | Description from frontmatter |
type | string | Memory type from frontmatter |
strength | integer | Strength from frontmatter |
references | integer | Total reference count from tracker (0 if no tracker) |
tags | list | Tags from frontmatter |
file | string | Relative path to the memory file |
# Generated by crux-skill-memory-index — do not edit manually
# Last rebuilt: 2026-04-03T14:22:00Z
memories:
- id: "b3f1a2c"
slug: react-memo-list-rendering
title: "React.memo on list item components prevents full re-render"
description: "Wrapping list item components in React.memo..."
type: "core"
strength: 3
references: 12
tags: [react, performance, rendering]
file: memories/core/react-memo-list-rendering.memory.crux.md
- id: "a1b2c3d"
slug: validate-checksums-before-overwrite
title: "Always validate CRUX checksums before overwriting"
description: "Source files can drift from their CRUX output..."
type: "learning"
strength: 1
references: 0
tags: [crux, validation, checksums]
file: memories/learning/validate-checksums-before-overwrite.memory.md
.crux/memory-index.yml to get a prioritised list of all memoriestype, tags, or keyword in title/description to find relevant memoriesfile path when deeper context is neededreferences to 0 for that memorymemories listpyyaml package installed.crux/crux-memories.json must exist with valid configcrux-skill-memory-crud)crux-skill-memory-reference-tracker)crux-skill-memory-compress)Consolidate, promote, demote, and archive memories based on strength, usage patterns, and type transition rules. Use when running REM sleep, rebalancing memory strength, detecting conflicts, or cleaning up orphaned trackers.
Multi-purpose utility for CRUX compression workflows. Provides token estimation and checksum calculation. Use when estimating tokens for compression, comparing file sizes, or getting checksums for sourceChecksum tracking.
File-based coordination primitives for meditation: artefact filename grammar (18 rows including `init-suggestions-{ts}.yml`, `finalisation-enhancements.yml`, per-tree ensemble variants, and 4 follow-up artefact types), placeholders, prefix-glob polling rule, never-hard-code invariant, retrospective template, Branch & Leaf Index template (single-model + ensemble variants). Use whenever the `crux-cursor-meditation-guide` agent reads, writes, or links a working-directory artefact.
Ensemble Aggregation function for meditation: reads N model consolidations, writes `cross-model-synthesis.md`, performs K10 root cross-model reflection (step 3c), manages K10 layered cadence steps 3b–3f (per-tree `finalisation-enhancements.yml` reads + root combined YAML write with `cross_model_candidates` + `union_candidates`), returns single combined `needs_user_input`, dispatches resume-handler by `source` provenance, and hands off to the report skill for ensemble HTML+PDF generation. Use when the `crux-cursor-meditation-guide` agent is spawned with `ensembleAggregation: true`.
Quick-mode meditation protocol: 6-step parallel fan-out with optional deep-confirm hook, warn-only citation validation, upfront child derivation, no peer review, K10c reflection (same rubric, warn-only at every richness level per K7). Use when the `crux-cursor-meditation-guide` agent runs the Quick depth-0 manager or any Quick-mode child agent.
Mandatory paired HTML+PDF report generation for meditation: Comprehensiveness Level Mapping (12 dimensions × 4 levels), anti-homogenisation rules, Universal Contrast, light/dark mode + print TOC, Chart.js / D3 / calculator content minima with static fallbacks, Per-Branch Section Rule, Depth-3 Leaf Inclusion Rule, Peer-Review Surfacing Rule, Init-Suggestions Honour rules, K10b Per-Cheap-Type Rendering Contract (7 cheap types), and Report-Skill Respawn Protocol resume-handler. Use when the `crux-cursor-meditation-guide` agent runs report generation (step 12), when the ensemble aggregator generates the ensemble-level report, or when the report skill is respawned via Dim 13.