workspace-review

What This Skill Does

The workspace-review skill acts as a rigorous auditing tool designed to maintain the integrity, cleanliness, and organizational standards of an OpenClaw agent's directory structure. Over time, as an agent interacts with various tasks, the workspace can naturally drift, accumulating clutter, miscategorized information, or missing vital configuration files. This skill performs a systematic scan of the ~/.openclaw/workspace/ directory, ensuring that all mandatory files—such as AGENTS.md, SOUL.md, USER.md, IDENTITY.md, and TOOLS.md—are present and correctly populated. Beyond mere file existence, it checks for content alignment, ensuring that files do not succumb to 'scope creep' where information is placed in the wrong context (e.g., placing personal logs in the AGENTS.md instruction file). By enforcing a clean structure, workspace-review helps the agent remain efficient, context-aware, and aligned with standard OpenClaw conventions.

Installation

To integrate this auditing capability into your agent, use the OpenClaw CLI tool as follows: clawhub install openclaw/skills/skills/ortegarod/workspace-review Once installed, the skill becomes available for execution at your command or as part of your heartbeat maintenance cycles.

Use Cases

This skill is ideal for users who manage complex agent workspaces and want to prevent digital entropy. Common scenarios include: performing weekly agent health checks, ensuring the workspace is correctly set up after migrating to a new system or repository, cleaning up after a massive project concludes, and confirming that the agent is properly configured to handle identity or tool-specific instructions before high-stakes tasks.

Example Prompts

1. "Perform a full audit of the current workspace structure and tell me if any mandatory files are missing."
2. "Review my workspace memory files; identify any content that should be moved from daily logs to the curated MEMORY.md file."
3. "Run a workspace maintenance check and report any files that have deviated from standard OpenClaw formatting conventions."

Tips & Limitations

To get the most out of workspace-review, schedule it to run automatically during your agent's heartbeat maintenance cycle. Note that this skill is primarily a diagnostic tool; while it identifies issues, it relies on the agent's logic to suggest or implement the necessary refactoring. Always review the changes suggested by the agent before committing large-scale moves to your files, especially when distilling long-term memory, to ensure that no critical context is inadvertently lost.