Menu
Set up @tobilu/qmd semantic search for mnemonic memories. Registers collections, builds indexes, and generates embeddings. Run this once per machine.
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
Cross-session handoff, persistent context via blackboard, and agent coordination patterns
This skill should be used when the user says "capture memory", "save to memory", "remember this", or trigger phrases like: "I've decided", "let's use", "we're going with", "I learned", "turns out", "TIL", "discovered", "I'm stuck", "blocked by", "always use", "never do", "convention is". Also triggers on recall phrases: "what did we decide", "how do we handle", "remind me", "search memories".
MIF Level 3 specification, memory templates, and formatting guidelines
This skill should be used when the user asks to "integrate mnemonic", "wire plugin", "add memory to plugin", "enable memory capture in plugin", "integrate memory operations", "add mnemonic protocol", "remove mnemonic integration", "rollback plugin integration", or "migrate legacy memory sections". It wires mnemonic memory capture and recall workflows into other Claude Code plugins using sentinel markers.
Ontology-based entity discovery and validation for mnemonic memories. Define custom namespaces, entity types, traits, and relationships. Triggers: "entity discovery", "validate ontology", "define namespaces", "resolve entity references", "list ontologies", "show namespaces", "entity types", "entity relationships", "traits", "discovery patterns", "cognitive memory types"
Re-index mnemonic memories for qmd semantic search. Run after capturing new memories or bulk imports.
| allowed-tools | ["Bash","Read","Write"] |
| description | Set up @tobilu/qmd semantic search for mnemonic memories. Registers collections, builds indexes, and generates embeddings. Run this once per machine. |
| name | qmd-setup |
| user-invocable | true |
Bootstrap @tobilu/qmd for semantic search over mnemonic memories.
node --versionnpm i -g @tobilu/qmdRun the setup script:
bash tools/qmd-setup.sh
The script will:
MNEMONIC_ROOT from ~/.config/mnemonic/config.json{MNEMONIC_ROOT}/{org}/ → collection mnemonic-{org}{MNEMONIC_ROOT}/default/ → collection mnemonic-default.claude/mnemonic/ → collection mnemonic-projectqmd update (index) + qmd embed (embeddings)qmd status and a test searchNote: First
qmd embeddownloads ~2 GB of GGUF models.
If you prefer to set up manually:
MNEMONIC_ROOT is resolved from ~/.config/mnemonic/config.json (defaults to
~/.local/share/mnemonic). Adjust the paths below to match your config:
# 1. Register collections (replace paths with your MNEMONIC_ROOT)
qmd collection add "${MNEMONIC_ROOT:-$HOME/.local/share/mnemonic}/zircote/" --name mnemonic-zircote
qmd collection add "${MNEMONIC_ROOT:-$HOME/.local/share/mnemonic}/default/" --name mnemonic-default
qmd collection add "$(git rev-parse --show-toplevel)/.claude/mnemonic/" --name mnemonic-project # if exists
# 2. Build index
qmd update
# 3. Generate embeddings (downloads models on first run)
qmd embed
# 4. Validate
qmd status
qmd search "test" -n 3
Use search commands:
| Command | Type | Requires |
|---|---|---|
qmd search "query" | BM25 keyword | qmd update |
qmd vsearch "query" | Semantic vector | qmd embed |
qmd query "query" | Hybrid (BM25 + vector) | Both |
Scope to a specific collection:
qmd search "auth" -c mnemonic-zircote # org memories only
qmd search "auth" -c mnemonic-project # this repo only
qmd search "auth" # all collections
After adding new memories, re-index with /mnemonic:qmd-reindex or:
qmd update && qmd embed
Indexing is not automatic — run after captures or bulk imports.