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

What It Provides

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

1. Install skill:

cd ~/.openclaw/workspace/skills
clawhub install workspace-organization
# Or: download from ClawHub and extract

2. Initialize workspace (optional, if starting fresh):

cd ~/.openclaw/workspace/skills/workspace-organization
./setup.sh

3. Run first audit:

cd ~/.openclaw/workspace/skills/workspace-organization
./maintenance-audit.sh