minni-consolidation

Operate the Minni memory consolidation pipeline and generate knowledge graph health reports.

2|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/infektyd/minni --skill minni-consolidation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minni-consolidation
Source: https://github.com/infektyd/minni/tree/main/plugins/minni/skills/minni-consolidation
Command: npx skills add https://github.com/infektyd/minni --skill minni-consolidation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort and guesswork of managing the Minni local agent memory consolidation pipeline, which is prone to failures like OOM crashes, stale lock files, and Python version incompatibilities that disrupt fact extraction and knowledge base updates.

Core Features & Use Cases

  • Pipeline Execution: Run ad-hoc or scheduled consolidation runs to extract facts from session records, promote episodic memory to semantic knowledge, and resolve contradictions via the governance gate.
  • Error Troubleshooting: Diagnose and fix common pipeline failures including MLX out-of-memory crashes, stale lock files, Python 3.9 compatibility issues, and missing Minni engine dependencies.
  • Health Reporting: Generate health reports for the knowledge graph, check database integrity, and monitor pipeline performance metrics. Use case: For teams using Minni for local-first agent memory, use this Skill to automate nightly consolidation runs, quickly resolve pipeline stalls, and verify that learnings are correctly stored and synced to the human-readable wiki mirror.

Quick Start

Use the minni-consolidation skill to run a full nightly consolidation of your Minni knowledge base and generate a health report of all stored learnings.

Frequently Asked Questions about minni-consolidation

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

FAQPage Schema
How do I fix MLX out-of-memory crashes during agent memory consolidation?

To fix MLX out-of-memory crashes during agent memory consolidation, you can apply error recovery procedures that limit page processing and clear stale lock files to free system resources. This prevents memory exhaustion from disrupting fact extraction.

How do I run ad-hoc knowledge graph consolidation for local agent memory?

You can run ad-hoc knowledge graph consolidation by triggering the pipeline to extract facts from session records, promote episodic memory to semantic knowledge, and resolve contradictions. Configurable page limits allow you to control the execution scope.

Why does my Minni consolidation pipeline stall due to stale lock files?

Your Minni consolidation pipeline stalls due to stale lock files because previous runs failed to release file locks, causing lock contention. Troubleshooting involves removing the stale locks and applying Python version compatibility checks to prevent recurrence.

Can I check SQLite database integrity after local agent memory consolidation?

Yes, you can check SQLite database integrity after local agent memory consolidation by generating a knowledge graph health report. This verifies that extracted learnings are correctly stored and synchronizes them to a human-readable wiki mirror for review.

How do I automate nightly memory consolidation runs with cron?

You can automate nightly memory consolidation runs by scheduling the pipeline through cron automation, which handles the extraction of session records into a shared semantic knowledge base while applying error recovery for out-of-memory and lock contention issues.

What causes Python version compatibility errors in local agent memory pipelines?

Python version compatibility errors in local agent memory pipelines are caused by missing engine dependencies or unsupported Python versions, such as 3.9. Troubleshooting involves verifying the Python environment and resolving missing dependencies to restore pipeline execution.