memory-distill

Distill episodic lessons from failures.jsonl and decisions.jsonl into permanent skills and rules.

1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/kssumin/claude-playground --skill memory-distill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-distill
Source: https://github.com/kssumin/claude-playground/tree/main/.claude/skills/memory-distill
Command: npx skills add https://github.com/kssumin/claude-playground --skill memory-distill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The memory-distill skill reads memory/failures.jsonl and memory/decisions.jsonl to identify lessons that have not yet been reflected in any skill or rule, and promotes them directly into permanent knowledge, elevating episodic memory to durable skill knowledge.

Core Features & Use Cases

  • Distills lessons from episodic memory into permanent skills and rules.
  • Maps findings to relevant components, avoids duplicates, and updates the promoted flag.
  • Use Case: After collecting several failures or decisions, distill actionable insights into the knowledge base to improve future responses.

Quick Start

Run this skill to promote unresolved failures and decisions into permanent knowledge for skills and rules.

Frequently Asked Questions about memory-distill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn episodic memory lessons into permanent skill rules?

Distilling episodic memory involves reading failures.jsonl and decisions.jsonl to identify unpromoted lessons, mapping them by component and category to target skills, and appending the promoted entries to update the knowledge base.

When should I distill failures and decisions into my knowledge base?

Distill failures and decisions periodically after collecting several entries. The process identifies unpromoted items in your jsonl files and maps them by component, category, and ref to target skills or rules for permanent knowledge integration.

How does mapping lessons to skills and rules by component work?

The mapping mechanism identifies unpromoted items in memory files, categorizes them by component, category, and ref, and appends distilled entries to corresponding jsonl files. It avoids duplicates by checking and updating the promoted flag for each processed item.

Can I run memory distillation without dependencies or external components?

Memory distillation requires no dependencies or external components. It autonomously reads failures.jsonl and decisions.jsonl, identifies unpromoted lessons, maps them to target skills or rules, and updates the promoted flag to reflect permanent knowledge integration.

What is the best way to avoid duplicate lessons when promoting episodic memory?

To avoid duplicate lessons when promoting episodic memory, the distillation process checks the promoted flag in failures.jsonl and decisions.jsonl before appending. It identifies unpromoted items, maps them to target skills or rules, and updates the flag to mark them as promoted.

Why are my episodic memory lessons not reflected in my skills and rules?

Episodic memory lessons remain unreflected in skills and rules because the promoted flag in failures.jsonl and decisions.jsonl has not been updated. Running the distillation process identifies unpromoted items, maps them to target skills or rules, and updates the flag to mark them as promoted.