An automated maintenance agent that performs deep scans, memory tiering, and dependency cleanup for your AI workspace.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install nightly-workspace-audit
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 nightly-workspace-audit 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 Audit?
Workspace Audit is a specialized utility designed to maintain the structural integrity and efficiency of an Openclaw workspace. By acting as a digital groundskeeper, the skill ensures that your AI coding agent has access to the most relevant information without being bogged down by stale or orphaned data. It automates the lifecycle of your technical notes and project files, ensuring that your Openclaw Skills environment remains performant over time.
The skill implements a robust three-tier memory architecture—HOT, WARM, and COLD—to manage information density. It doesn't just move files; it performs deep content analysis to find broken links, content drift between related documents, and orphaned files that are no longer referenced by cron jobs or index files. This level of automation is essential for long-term project maintenance in complex AI-driven development workflows.
Workspace Audit Use Cases
- Automatically cleaning up daily logs and notes every night via cron jobs.
- Detecting and repairing broken internal links within your project documentation.
- Optimizing token usage by archiving old files into the COLD memory tier.
- Auditing the health of scheduled tasks and cross-referencing them with existing workspace files.
- Identifying duplicate content across multiple markdown files to maintain a single source of truth.
How Workspace Audit Works
- Dependency Discovery: The skill scans all markdown and JSON files to build a comprehensive dependency graph, cross-referencing them against cron jobs and tree diagrams.
- Memory Hygiene: It processes the memory directory to merge related entries, deduplicate identical content, and prune expired temporary notes.
- Tier Management: Based on activity and age, it promotes or demotes files between HOT, WARM, and COLD tiers to optimize accessibility.
- Local Overrides: If custom rules are defined in local-overrides.md, the skill executes specific sync checks for user-defined content pairs.
- Reporting: Finally, it generates a health report detailing the status of broken links, orphaned files, and all memory tier migrations.
Workspace Audit Setup
To deploy this skill within your environment, ensure you have the core Openclaw Skills framework installed. Then, follow these steps:
- Move the
workspace-auditskill file into your skills directory. - Create a
references/tier-rules.mdfile if you wish to customize the thresholds for file promotion and demotion. - (Optional) Set up a nightly cron job to trigger the audit automatically:
# Example of triggering the audit manually
openclaw run workspace-audit
- Review the generated health report in your console or designated log file.
Workspace Audit Data Schema & Taxonomy
The skill organizes workspace data into a strict hierarchy to ensure efficient retrieval. This is a critical component of professional Openclaw Skills management.
| Memory Tier | Storage Path | Access Frequency |
|---|---|---|
| HOT | Root (MEMORY.md, USER.md) |
Loaded every session |
| WARM | memory/*.md, projects/ |
Loaded on demand |
| COLD | memory/archive/ |
Archived, rarely touched |
Dependencies are tracked via a JSON graph mapping each file to its internal references and cron job associations.
Workspace Audit Advanced Features
- Content Drift Detection: Identifies when two files referencing the same data have diverged over time.
- Intelligent Archiving: Automatically moves daily notes older than 7 days to the archive while preserving important summaries.
- Cron Integration: Scans cron list message fields to ensure every referenced file path actually exists on disk.
- Dynamic Indexing: Automatically updates the workspace structure tree in your MEMORY.md file after every audit.
- Custom Dependency Rules: Supports user-specific sync pairs via a local-overrides.md file for complex manual workflows.
SKILL.md
Loading
Related Openclaw Skills
Buddy: Your AI ASCII Companion
A charming virtual ASCII pet that lives in your chat, reacts to your coding progress, and evolves its personality over time.
Trend Mapper
Trend Mapper identifies viral audio and meme formats to rapidly adapt trending content for ecommerce growth.
Kubernetes Encyclopedia
A documentation-first workflow skill for managing Kubernetes clusters, API objects, and complex troubleshooting with high accuracy.
TMTPost Daily News Aggregator
A high-performance news aggregation tool for Openclaw Skills that retrieves real-time tech industry reports, hot lists, and flash news from TMTPost.
TMTPost Article Summarizer
An AI-powered tool for reading, summarizing, and performing comparative analysis on technology news from TMTPost.
Customer Requirement Analysis - Financial Advisory Assistant
A sophisticated AI tool that transforms raw client communication into standardized, seven-step financial investment reports using real-time market data.
Featured*
