← Back to Skills Marketplace
codeblackhole1024

Memory Organizer

by codeblackhole · GitHub ↗ · v1.2.1
cross-platform ⚠ suspicious
800
Downloads
2
Stars
5
Active Installs
5
Versions
Install in OpenClaw
/install memory-organizer
Description
Organize, compress, and curate OpenClaw memory without polluting permanent memory. Use when the user wants to compress memory files, clean dated memory notes...
Usage Guidance
This skill appears to do what it says (organize and compress local memory markdown files), but it will modify your files in-place (creates .bak and .discarded files, overwrites originals when compressing) and reads the OPENCLAW_WORKSPACE environment variable even though no env vars were declared. Before installing or running: 1) review memory-organizer.js (it's included) to confirm there are no network calls or unexpected behavior (there are none obvious, but inspect the whole file). 2) Set OPENCLAW_WORKSPACE to a test or temporary workspace, or verify the default path (~/.openclaw/workspace-main) is the intended target. 3) Make a full backup/copy of your MEMORY.md and memory/ directory. 4) Run operations first in non-forcing mode (-– without force) to see what would change; note discard requires --force to actually delete/move files. 5) If you lack the ability/comfort to audit the code, run it in an isolated environment or container. These steps reduce the risk of accidental data loss even though the skill's functionality is generally coherent with its description.
Capability Analysis
Type: OpenClaw Skill Name: memory-organizer Version: 1.2.1 The memory-organizer skill is a legitimate utility designed to manage and compress OpenClaw memory files using a two-layer storage model. The Node.js script (memory-organizer.js) includes robust path validation and filename sanitization to prevent directory traversal, and it operates strictly within the defined workspace directory without external network calls or suspicious execution patterns.
Capability Assessment
Purpose & Capability
Name, README, SKILL.md and the included JS file are coherent: the code implements scanning, compressing, classifying, promoting and discarding markdown memory files in a two-layer model as described. The required capabilities (file read/write in a workspace memory directory) align with the stated purpose.
Instruction Scope
SKILL.md instructs the agent to validate paths, operate only inside the workspace memory files, and preserve backups. The code implements path checks (isPathSafe, isFilenameSafe), creates backups (.bak, .discarded), and limits operations to the workspace memory directory — the runtime instructions and code stay within the declared functional scope.
Install Mechanism
There is no install spec (instruction-only) which is low-risk, but the package includes an executable Node.js script (memory-organizer.js). The README suggests running the script directly (node memory-organizer.js). Because code will be executed on the user's machine, the user should review the script before running it even though there is no remote install/download.
Credentials
The skill reads process.env.OPENCLAW_WORKSPACE to determine workspace location but SKILL.md / registry metadata do not declare required environment variables. This is a mismatch: the script will fall back to ~/.openclaw/workspace-main if the env var is not set, but users should be aware the script uses that env var and will operate on local files. No network credentials are requested, but undeclared env access is a notable inconsistency.
Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges. However it performs file modifications (compress, rename to .discarded, write .bak backups) inside the user's workspace. That is expected for this functionality but is a persistent effect on local files; the user should ensure backups and run cautiously.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install memory-organizer
  3. After installation, invoke the skill by name or use /memory-organizer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
Refined memory organization to keep MEMORY.md clean and durable. Daily memory stays in dated files, while only long-term facts are promoted to permanent memory. Updated merge behavior and documentation to prevent permanent memory bloat.
v1.2.0
Optimized description for better discoverability
v1.1.0
Added path validation to prevent directory traversal, customizable workspace, installation instructions
v1.0.1
Updated to English
v1.0.0
Initial release
Metadata
Slug memory-organizer
Version 1.2.1
License
All-time Installs 5
Active Installs 5
Total Versions 5
Frequently Asked Questions

What is Memory Organizer?

Organize, compress, and curate OpenClaw memory without polluting permanent memory. Use when the user wants to compress memory files, clean dated memory notes... It is an AI Agent Skill for Claude Code / OpenClaw, with 800 downloads so far.

How do I install Memory Organizer?

Run "/install memory-organizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Memory Organizer free?

Yes, Memory Organizer is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Memory Organizer support?

Memory Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Memory Organizer?

It is built and maintained by codeblackhole (@codeblackhole1024); the current version is v1.2.1.

💬 Comments