Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Productivity
Workspace Organization - Automated Health Checks
Automated workspace health checks and entropy prevention for OpenClaw. Detects broken symlinks, empty dirs, large files, malformed names. Maintenance audit s...
skill openclawclawhub Free
Automated workspace health checks and entropy prevention for OpenClaw. Detects broken symlinks, empty dirs, large files, malformed names. Maintenance audit s...
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- README.md, SKILL.md, maintenance-audit.sh, setup.sh
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.0.0
Provenance
- Publisher
- donovanpankratz-del
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Workspace Organization
Standards and automated maintenance for clean OpenClaw deployments.
Files Included
SKILL.md โ Agent instructions README.md โ Setup guide maintenance-audit.sh โ Run to audit workspace health setup.sh โ Run once to initialize standard structure Note: Scripts auto-detect your workspace. Pass a path as argument to override: ./maintenance-audit.sh /custom/path
Problem Solved
Workspaces degrade over time: Broken symlinks from moved files Empty directories from deleted projects Large files eating disk space Malformed names breaking scripts No visibility into workspace health This skill provides automated audits + cleanup guidance to prevent entropy.
When to Use
New workspace setup โ Initialize standard directory structure Periodic maintenance โ Weekly/monthly health checks (cron recommended) Pre-deployment cleanup โ Remove cruft before backups Debugging workspace issues โ Find broken symlinks, malformed names Disk space review โ Identify large files and bloat
1. maintenance-audit.sh
Automated health check script that detects: โ Broken symlinks โ Empty directories (excluding node_modules, .git) โ Large files (>10MB) โ Malformed file/directory names (spaces, special chars) โ Disk usage by top-level directory โ File/directory counts โ Recent changes (last 24 hours)
2. setup.sh
Initializes standard workspace structure: ~/.openclaw/workspace/ โโโ projects/ # Active work โ โโโ writing/ # Writing projects โ โโโ code/ # Code projects โโโ notes/ # Organized notes โ โโโ daily-reviews/ โ โโโ decisions/ โ โโโ cost-tracking.md โโโ memory/ # Long-term memory โ โโโ owner/ # Cross-channel user memory โ โโโ sessions/ # Per-session isolated memory โโโ skills/ # Custom skills โโโ subagents/ # Permanent specialists โ โโโ _archived/ # Old/deprecated subagents โโโ docs/ # Documentation โโโ scripts/ # Utility scripts
3. Organization Standards (docs/)
Best practices for: File naming conventions (kebab-case, no spaces) Directory structure guidelines Cleanup policies (what to keep/delete) Git integration patterns
Setup
Install skill: cd ~/.openclaw/workspace/skills clawhub install workspace-organization # Or: download from ClawHub and extract Initialize workspace (optional, if starting fresh): cd ~/.openclaw/workspace/skills/workspace-organization ./setup.sh Run first audit: cd ~/.openclaw/workspace/skills/workspace-organization ./maintenance-audit.sh Schedule automated audits (recommended): openclaw cron add \ --name "Weekly Workspace Audit" \ --schedule "0 4 * * 0" \ --task "Run workspace maintenance audit: bash skills/workspace-organization/maintenance-audit.sh. Log results to notes/maintenance-log.md"
Manual Audit
cd ~/.openclaw/workspace/skills/workspace-organization ./maintenance-audit.sh Example output: === Workspace Maintenance Audit === Date: 2026-02-21 16:00 Path: /home/user/.openclaw/workspace 1. Checking for broken symlinks... โ ๏ธ Found broken symlinks: /home/user/.openclaw/workspace/old-project/link-to-deleted 2. Checking for empty directories... โน๏ธ Found empty directories: /home/user/.openclaw/workspace/projects/abandoned 3. Checking for large files (>10MB)... โน๏ธ Found large files: 24M /home/user/.openclaw/workspace/logs/debug.log 4. Checking for malformed file/directory names... โ ๏ธ Found malformed names: /home/user/.openclaw/workspace/projects/my project/file.md 5. Disk usage by top-level directory: 150M skills 80M notes 50M projects 30M memory 6. File counts: Total files: 1,234 Total directories: 156 Skills: 18 Subagents: 3 7. Recently modified files (last 24 hours): /home/user/.openclaw/workspace/notes/cost-tracking.md /home/user/.openclaw/workspace/memory/owner/decisions.md === Audit Complete ===
Agent-Driven Audit
Ask your agent: "Run workspace maintenance audit" "Check workspace health" "Audit my workspace" Agent will execute script and present findings with cleanup recommendations.
1. Broken Symlinks
Causes: Moved/renamed files Deleted dependencies Incorrect relative paths Fix: Remove symlink or update target
2. Empty Directories
Causes: Deleted projects Failed installations Incomplete migrations Fix: Remove unless intentionally placeholder
3. Large Files
Common culprits: Uncompressed logs (debug.log, error.log) Binary artifacts (.zip, .tar.gz) Downloaded datasets Video/media files Fix: Compress, move to external storage, or delete
4. Malformed Names
Problems caused by: Spaces in filenames โ breaks scripts Special characters โ shell escaping issues Braces/brackets โ glob conflicts Fix: Rename using kebab-case or snake_case Example: # Bad my project/file (copy).md # Good my-project/file-copy.md
Workspace Health Score
After running maintenance-audit.sh, your workspace gets a score: ScoreStatusMeaning90-100๐ข HealthyMinor issues or none70-89๐ก FairSome cleanup needed50-69๐ DegradedMultiple issues accumulating<50๐ด CriticalImmediate cleanup required Score is calculated based on: broken symlinks (-10 each), empty dirs (-2 each), files >100MB (-5 each), malformed names (-3 each).
Automation Strategy
FrequencyActionReasonDailyNoneToo aggressive, creates noiseWeeklyAudit only, log resultsCatch issues earlyMonthlyAudit + present to userReview & approve cleanupOn-demandBefore backups/deploymentsReduce backup size
Companion Skills
system-resource-monitor โ Disk usage alerts complement workspace health cost-governor โ Track subagent costs alongside workspace hygiene
Integration with Other Skills
openclaw-backup: Audit before backup to reduce size cost-governor: Track disk usage for storage costs drift-guard: Organizational entropy as drift indicator
Adjust Large File Threshold
Edit maintenance-audit.sh: # Change from 10MB to 50MB find "$WS" -type f -size +50M 2>/dev/null
Exclude Directories
Add to script: find "$WS" -type d -empty 2>/dev/null \ | grep -v "node_modules" \ | grep -v ".git" \ | grep -v "your-custom-dir"
Add Custom Checks
Extend script with: Git repo status checks Dependency vulnerability scans License compliance audits
Philosophy
Prevent entropy โ Structure degrades without maintenance Automate detection โ Scripts catch what humans miss User-approved cleanup โ Never auto-delete without permission Standards over rigidity โ Guidelines, not laws
Troubleshooting
"Script fails on macOS" Install GNU findutils: brew install findutils Use gfind instead of find "Too many empty directories flagged" Exclude more dirs in script (e.g., .cache, .venv) "Large files are necessary" Document in notes/workspace-notes.md why they're kept Consider moving to external storage (S3, NAS)
Advanced: Multi-Workspace Support
If managing multiple OpenClaw instances: # Audit all workspaces for ws in ~/.openclaw-*; do WS="$ws/workspace" ./maintenance-audit.sh done Author: OpenClaw Community License: MIT Requires: Bash, GNU coreutils (find, du, sort)
Category context
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
2 Docs2 Scripts
- SKILL.md
- README.md
- maintenance-audit.sh
- setup.sh