rlm-distill

name	rlm-distill
description	Agent-powered RLM cache distillation. Replaces the slow local Ollama distiller with the agent's own summarization capability for both rlm_summary_cache.json and rlm_tool_cache.json.

RLM Distill Skill

Purpose

Distill (summarize) files directly into the RLM caches using the agent's own intelligence instead of the slow local Ollama model (qwen2:7b on M1 Mac). The agent reads the file, writes a summary, and updates the cache JSON in-place.

Should leverage frontier model ability to produce a superior summary for a file faster than can be done with a slow local CPU.

🎯 Agent Execution Protocol (The "Brain Upgrade")

Context: You (the Agent) are faster and smarter than the local distiller.py script. The local Ollama model (e.g., granite or qwen2) is often too slow on user hardware. Directive: When asked to "update RLM" or "summarize x", DO NOT run python distiller.py immediately.

Instead, you must act as the distiller yourself.

Protocol

1. Check: Is the request for < 10 files?
2. Action: If YES -> Read & Write Manually (Agent Distillation).
   • Call the rlm-distill pseudo-command for each file.
   • Read the entire target file deeply (view_file).
   • Create a high-quality summary of the content yourself.
   • Edit rlm_summary_cache.json or rlm_tool_cache.json and manually inject your JSON/Text summary string into the structure.
   • Log: "Updated cache for [file] via Agent Distill."
3. Fallback: If NO (Batch > 10 files) -> Run python distiller.py (The script is better for bulk/boring work).

Why This Exists (The RLM Philosophy)

The fundamental purpose of the recursive language model (RLM) cache is "Read Once, Cache Forever."

You should perform a deep, comprehensive read and summarize the file with an exceptionally good summary once. The goal is to entirely remove the need for you to read those complex files many times just to figure out what they do.

The workflow is:

1. You read the RLM cache summary (which you created once).
2. You immediately understand what the plugin/tool/document does without opening it.
3. If, and only if, the task requires deep code-level modification of that specific file, you trigger the "recursion" and read the full source file again.

The existing plugins/rlm-factory/skills/rlm-curator/scripts/distiller.py calls Ollama locally, which:

• Takes 3-5 minutes per file on M1 Mac hardware.
• Produces lower-quality summaries than a frontier model.
• Frequently fails ([DISTILLATION FAILED]).
• Requires Ollama to be running.

The agent (Claude, Gemini, Antigravity) is already a drastically better summarizer. This skill explicitly makes you the distillation engine.

The Two Caches (Example Configuration)

Projects configure their own caches in rlm_profiles.json. A common setup is:

Cache	Content Type	Summary Format
Summary Cache	Docs, protocols, ADRs, workflows, rules	Plain text paragraph
Tool Cache	Python/JS scripts, CLI tools	JSON object with structured fields

First Run?

If no cache exists yet, use the rlm-init skill to interactively set up cache location, manifest, and .env config before distilling.

Cache Entry Schema

Summary Cache Entry (docs/markdown)

{
  "path/to/file.md": {
    "hash": "<content_hash_or_manual_marker>",
    "summary": "Plain text summary of the document...",
    "file_mtime": 1234567890.0,
    "summarized_at": "2026-02-11T18:30:00Z"
  }
}

Tool Cache Entry (code/scripts)

{
  "plugins/path/to/script.py": {
    "hash": "<content_hash_or_manual_marker>",
    "summary": "{\"purpose\": \"...\", \"layer\": \"...\", \"usage\": [...], \"args\": [...], \"inputs\": [...], \"outputs\": [...], \"dependencies\": [...], \"key_functions\": [...], \"consumed_by\": [...]}",
    "file_mtime": 1234567890.0,
    "summarized_at": "2026-02-11T18:30:00Z"
  }
}

Note: The tool cache summary field is a JSON string (not a nested object), matching the existing distiller's output format.

Procedure

1. Identify Files to Distill

Choose one of:

A. Fix failed entries:

# Find all DISTILLATION FAILED entries in the target cache file
# (Check rlm_profiles.json for the exact path to the target cache)
grep -n "DISTILLATION FAILED" <path_to_cache.json>

B. Distill new/changed files:

# Find files modified in last N hours not yet in cache
find . -name "*.md" -mmin -120

C. Distill specific files the user requests.

2. Read the Source File

Read the file content using view_file or equivalent.

3. Apply the Distillation Prompts

Before writing the summary, you MUST align your output exactly with the rigorous standards defined in the official RLM prompts.

For code/scripts (Tool Cache): Read and strictly adhere to the JSON schema demanded in:

plugins/tool-inventory/resources/prompts/rlm/rlm_summarize_tool.md Your output must be the raw, stringified JSON object matching that exact schema.

For docs/markdown (Summary Cache): Read and strictly adhere to the high-fidelity architectural criteria demanded in:

plugins/rlm-factory/resources/prompts/rlm/rlm_summarize_legacy.md Your output must be a dense, signal-heavy text summary.

4. Update the Cache JSON

Edit the cache file directly using file editing tools. Set:

• hash: Use "agent_distilled_<date>" as the hash marker (e.g., "agent_distilled_2026_02_11")
• summary: Your summary text
• summarized_at: Current ISO timestamp
• file_mtime: (optional) File modification time if available

5. Verify

After editing, spot-check that the JSON is still valid:

python3 -c "import json; json.load(open('<path_to_cache.json>')); print('✅ Valid JSON')"

Quality Guidelines

Signal Over Noise

• Every summary should be Signal: a reader should learn the essential purpose and architecture from the summary alone
• Avoid Noise: don't pad with obvious observations, don't repeat the filename as the description
• A good summary lets the agent decide whether to read the full file without actually reading it

Conciseness

• Summary cache: Target 2-5 sentences for simple docs, up to a paragraph for complex protocols
• Tool cache: Keep purpose to 1-2 sentences. Let the structured fields carry the detail.

First Principles

• Summarize what the file actually does, not what it says it does
• If the file has a grand description but trivial implementation, note the gap
• Cross-reference related documents where architecturally significant

Incremental vs Full

• Incremental (preferred): Fix [DISTILLATION FAILED] entries and distill new files only
• Full: Only needed if the cache is severely stale or corrupted

Integration with Existing Distiller

This skill complements the Ollama-based distiller — it doesn't replace the script. The script is still useful for:

• Batch processing hundreds of files unattended
• CI/CD pipelines where no agent is available
• Content hash tracking for change detection

The agent distillation is better for:

• Fixing failed entries quickly
• Distilling complex documents that need frontier-model comprehension
• On-demand updates during active sessions
• M1 Mac environments where Ollama is too slow

Related

• plugins/rlm-factory/skills/rlm-curator/scripts/distiller.py — Original Ollama-based distiller
• plugins/rlm-factory/skills/rlm-curator/scripts/rlm_config.py — Configuration and cache utilities
• plugins/rlm-factory/skills/rlm-curator/scripts/query_cache.py — Search the cache
• plugins/rlm-factory/resources/rlm_manifest.json — Defines which directories get distilled