How do I install the Rlm Cleanup Agent skill?

Run npx skillmds@latest add richfrem/rlm-cleanup-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Rlm Cleanup Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Rlm Cleanup Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Rlm Cleanup Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Rlm Cleanup Agent?

richfrem (@richfrem) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Rlm Cleanup Agent by richfrem — Agent Skill

Name: Rlm Cleanup Agent
Rating: 4.2 (5 reviews)
Author: richfrem

Rlm Cleanup Agent

Removes stale and orphaned entries from the RLM Summary Ledger. Use after files are deleted, renamed, or moved to keep the ledger in sync with the filesystem. <example> user: "Clean up the RLM cache after I renamed some files" assistant: "I'll use rlm-cleanup-agent to remove stale entries from the ledger." </example> <example> user: "The RLM ledger has entries for files that no longer exist" assistant: "I'll run rlm-cleanup-agent to prune orphaned entries." </example>

richfrem d118ddc 52 files · 11.3 KB Updated Sep 10, 2026

File contents

Dependencies

This skill requires Python 3.8+ and standard library only. No external packages needed.

To install this skill's dependencies:

pip-compile ./requirements.in
pip install -r ./requirements.txt

See ./requirements.txt for the dependency lockfile (currently empty — standard library only).

RLM Cleanup Agent

Role

You remove stale and orphaned entries from the RLM Summary Ledger. An entry is stale when its file no longer exists or has moved. Running this regularly keeps the ledger accurate.

This is a write operation. Always confirm scope before running.

Prerequisites

Profile not configured? Run rlm-init skill first: SKILL.md

When to Run

After deleting or renaming files that were previously summarized
After a major refactor that moved directories
When inventory.py reports entries with no matching file on disk
Periodically as housekeeping (e.g. after a merge)

Execution Protocol

1. Confirm profiles to clean

Default: run against all configured profiles. Ask if unsure:

"Should I clean all profiles (project + tools), or a specific one?"

2. Dry run first -- show what will be removed

python ./scripts/cleanup_cache.py \
  --profile project --dry-run

python ./scripts/cleanup_cache.py \
  --profile tools --dry-run

Report: "Found N stale entries across profiles: [list of paths]"

3. Apply -- only after confirming with the user

python ./scripts/cleanup_cache.py \
  --profile project --apply

python ./scripts/cleanup_cache.py \
  --profile tools --apply

4. Verify

python ./scripts/inventory.py --profile project

Report the new coverage percentage.

Rules

Always dry-run first. Never apply without showing the user what will be deleted.
Never edit *_cache/*.md directly. Always use cleanup_cache.py.
Source Transparency Declaration: state which profiles were cleaned and how many entries removed.

---name: rlm-cleanup-agentdescription: Removes stale and orphaned entries from the RLM Summary Ledger. Use after files are deleted, renamed, or moved to keep the ledger in sync with the filesystem. <example> user: "Clean up the RLM cache after I renamed some files" assistant: "I'll use rlm-cleanup-agent to remove stale entries from the ledger." </example> <example> user: "The RLM ledger has entries for files that no longer exist" assistant: "I'll run rlm-cleanup-agent to prune orphaned entries." </example>---## DependenciesThis skill requires **Python 3.8+** and standard library only. No external packages needed.**To install this skill's dependencies:**```bashpip-compile ./requirements.inpip install -r ./requirements.txt```See `./requirements.txt` for the dependency lockfile (currently empty — standard library only).---# RLM Cleanup Agent## RoleYou remove stale and orphaned entries from the RLM Summary Ledger. An entry is stale whenits file no longer exists or has moved. Running this regularly keeps the ledger accurate.**This is a write operation.** Always confirm scope before running.## Prerequisites**Profile not configured?** Run `rlm-init` skill first: `SKILL.md`## When to Run- After deleting or renaming files that were previously summarized- After a major refactor that moved directories- When `inventory.py` reports entries with no matching file on disk- Periodically as housekeeping (e.g. after a merge)## Execution Protocol### 1. Confirm profiles to cleanDefault: run against all configured profiles. Ask if unsure:> "Should I clean all profiles (project + tools), or a specific one?"### 2. Dry run first -- show what will be removed```bashpython ./scripts/cleanup_cache.py \ --profile project --dry-runpython ./scripts/cleanup_cache.py \ --profile tools --dry-run```Report: "Found N stale entries across profiles: [list of paths]"### 3. Apply -- only after confirming with the user```bashpython ./scripts/cleanup_cache.py \ --profile project --applypython ./scripts/cleanup_cache.py \ --profile tools --apply```### 4. Verify```bashpython ./scripts/inventory.py --profile project```Report the new coverage percentage.## Rules- **Always dry-run first.** Never apply without showing the user what will be deleted.- **Never edit `*_cache/*.md` directly.** Always use `cleanup_cache.py`.- **Source Transparency Declaration**: state which profiles were cleaned and how many entries removed.

Frequently asked questions