A specialized maintenance tool for auditing and optimizing AI agent workspace structures and memory quality.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install workspace-hygiene
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install workspace-hygiene using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Workspace Hygiene?
Workspace Hygiene is a technical maintenance skill designed to keep AI agent environments organized and RAG-friendly. It ensures that file structures remain canonical, memory entries follow established tagging protocols, and project documentation stays up to date. By integrating this into your Openclaw Skills library, you prevent the degradation of retrieval quality that occurs when workspaces become cluttered or inconsistent, ensuring your agent always has a high-quality data foundation.
Workspace Hygiene Use Cases
- Performing automated weekly workspace audits to maintain high performance.
- Cleaning up fragmented memory files and consolidating logs into standardized formats.
- Auditing project folders for missing README files to improve context retrieval during RAG operations.
- Identifying and organizing files that have been placed in incorrect directory locations within the workspace root.
How Workspace Hygiene Works
- The skill analyzes the workspace root to identify files or folders that violate the canonical layout defined in the STRUCTURE.md guide.
- It scans the memory directory to detect outdated timestamp formats and identifies daily logs older than 30 days that require distillation into the main memory file.
- Every project subdirectory is checked for a valid README.md to ensure the agent has searchable context for memory_search functions.
- Recent memory entries are validated against a specific tagging schema including DECISION, FACT, PROJECT, RULE, and EVENT tags.
- A detailed Health Report is generated and stored in the system project folder with prioritized action items and suggested move or archive commands.
Workspace Hygiene Setup
To deploy Workspace Hygiene, install the script to your agent workspace and run the following command to initiate an audit:
python3 skills/workspace-hygiene/scripts/hygiene.py --workspace ~/.openclaw/workspace
For continuous maintenance, it is recommended to add a Weekly Hygiene task to your HEARTBEAT.md file, ensuring the command is executed every Monday.
Workspace Hygiene Data Schema & Taxonomy
| File Path | Description |
|---|---|
projects/system/hygiene-YYYY-MM-DD.md |
The generated audit report containing structure violations and recommended actions. |
memory/ |
The target directory for scanning timestamp violations and untagged entries. |
STRUCTURE.md |
The source of truth used to validate the canonical workspace directory layout. |
MEMORY.md |
The global memory file, flagged for manual trimming if it exceeds 150 lines. |
projects/*/README.md |
Required documentation files for every project to ensure optimal RAG retrieval. |
Workspace Hygiene Advanced Features
- Auto-fix capabilities for consolidating fragmented timestamp-format memory files into daily logs.
- Support for specific agent targeting, allowing for hygiene checks on individual agent workspaces.
- Integrated memory format validation that flags untagged entries for manual review to preserve context.
- Automated line-count monitoring for global memory files to prevent context window overflow.
SKILL.md
Loading
Related Openclaw Skills
PPTX Presentation Automator
A professional-grade toolset for programmatic PowerPoint creation, deep XML editing, and automated slide analysis.
Fakerjs Reference Skill
A local developer reference tool providing instant access to Fakerjs concepts, implementation patterns, and best practices without requiring API keys.
Real Estate Buyer Follow-Up Pro
A high-performance lead conversion skill that turns open house notes and CRM exports into prioritized action plans and personalized communication drafts.
Linkbox Reference Tool
Linkbox is a localized reference tool providing instant access to devtools concepts, best practices, and implementation patterns.
Magic Image2Video
A professional AI video generation skill that converts text descriptions and static images into dynamic video content via remote API integration.
AI Competitive Competitor Analyzer
An automated intelligence framework designed to generate professional-grade competitive analysis reports with high ROI.
Featured*
