/distill-memory

name: distill-memory
description: Capture breakthrough moments and valuable insights as searchable memories in your knowledge base.

Distill Memory

Save proactively when the conversation produces a durable fact, preference, decision, plan, procedure, learning, event, or important context. Do not wait to be asked.

When to Save

Good candidates include:

• decisions with rationale ("we chose PostgreSQL because ACID is required")
• repeatable procedures or workflows
• lessons from debugging, incidents, or root cause analysis
• durable preferences or constraints
• plans that future sessions will need to resume cleanly
• important context that would be lost when the session ends

Skip routine fixes with no generalizable lesson, work in progress that will change, simple Q&A answerable from documentation, and generic information already widely known.

Add vs Update

• Use `nmem --json m add` when the insight is genuinely new.
• If an existing memory already captures the same decision, workflow, or preference and the new information refines it, use `nmem m update <id> ...` instead of creating a duplicate.
• At the end of a substantial task, explicitly check whether one durable memory should be added or updated.

Prefer atomic, standalone memories with strong titles and clear meaning. Focus on what was learned or decided, not routine chatter.

Use structured saves when possible: `--unit-type` (`fact`, `preference`, `decision`, `plan`, `procedure`, `learning`, `context`, `event`), `-l` labels, `-i` importance (0.8–1.0 major decisions, 0.5–0.7 useful patterns, 0.3–0.4 minor notes). For MCP/native tools, pass the same value as `unit_type` when you know it.

Native Connector

These skills work in any agent via CLI. For auto-recall, auto-capture, and graph tools, check if your agent has a native Nowledge Mem connector — run the `check-integration` skill or see https://mem.nowledge.co/docs/integrations