{
  "schemaVersion": "1.0",
  "item": {
    "slug": "workspace-organization",
    "name": "Workspace Organization - Automated Health Checks",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/donovanpankratz-del/workspace-organization",
    "canonicalUrl": "https://clawhub.ai/donovanpankratz-del/workspace-organization",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/workspace-organization",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=workspace-organization",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "maintenance-audit.sh",
      "setup.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/workspace-organization"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/workspace-organization",
    "agentPageUrl": "https://openagent3.xyz/skills/workspace-organization/agent",
    "manifestUrl": "https://openagent3.xyz/skills/workspace-organization/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/workspace-organization/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Workspace Organization",
        "body": "Standards and automated maintenance for clean OpenClaw deployments."
      },
      {
        "title": "Files Included",
        "body": "SKILL.md — Agent instructions\nREADME.md — Setup guide\nmaintenance-audit.sh — Run to audit workspace health\nsetup.sh — Run once to initialize standard structure\n\nNote: Scripts auto-detect your workspace. Pass a path as argument to override: ./maintenance-audit.sh /custom/path"
      },
      {
        "title": "Problem Solved",
        "body": "Workspaces degrade over time:\n\nBroken symlinks from moved files\nEmpty directories from deleted projects\nLarge files eating disk space\nMalformed names breaking scripts\nNo visibility into workspace health\n\nThis skill provides automated audits + cleanup guidance to prevent entropy."
      },
      {
        "title": "When to Use",
        "body": "New workspace setup — Initialize standard directory structure\nPeriodic maintenance — Weekly/monthly health checks (cron recommended)\nPre-deployment cleanup — Remove cruft before backups\nDebugging workspace issues — Find broken symlinks, malformed names\nDisk space review — Identify large files and bloat"
      },
      {
        "title": "1. maintenance-audit.sh",
        "body": "Automated health check script that detects:\n\n✅ Broken symlinks\n✅ Empty directories (excluding node_modules, .git)\n✅ Large files (>10MB)\n✅ Malformed file/directory names (spaces, special chars)\n✅ Disk usage by top-level directory\n✅ File/directory counts\n✅ Recent changes (last 24 hours)"
      },
      {
        "title": "2. setup.sh",
        "body": "Initializes standard workspace structure:\n\n~/.openclaw/workspace/\n├── projects/           # Active work\n│   ├── writing/        # Writing projects\n│   └── code/           # Code projects\n├── notes/              # Organized notes\n│   ├── daily-reviews/\n│   ├── decisions/\n│   └── cost-tracking.md\n├── memory/             # Long-term memory\n│   ├── owner/          # Cross-channel user memory\n│   └── sessions/       # Per-session isolated memory\n├── skills/             # Custom skills\n├── subagents/          # Permanent specialists\n│   └── _archived/      # Old/deprecated subagents\n├── docs/               # Documentation\n└── scripts/            # Utility scripts"
      },
      {
        "title": "3. Organization Standards (docs/)",
        "body": "Best practices for:\n\nFile naming conventions (kebab-case, no spaces)\nDirectory structure guidelines\nCleanup policies (what to keep/delete)\nGit integration patterns"
      },
      {
        "title": "Setup",
        "body": "Install skill:\n\ncd ~/.openclaw/workspace/skills\nclawhub install workspace-organization\n# Or: download from ClawHub and extract\n\nInitialize workspace (optional, if starting fresh):\n\ncd ~/.openclaw/workspace/skills/workspace-organization\n./setup.sh\n\nRun first audit:\n\ncd ~/.openclaw/workspace/skills/workspace-organization\n./maintenance-audit.sh\n\nSchedule automated audits (recommended):\n\nopenclaw cron add \\\n  --name \"Weekly Workspace Audit\" \\\n  --schedule \"0 4 * * 0\" \\\n  --task \"Run workspace maintenance audit: bash skills/workspace-organization/maintenance-audit.sh. Log results to notes/maintenance-log.md\""
      },
      {
        "title": "Manual Audit",
        "body": "cd ~/.openclaw/workspace/skills/workspace-organization\n./maintenance-audit.sh\n\nExample output:\n\n=== Workspace Maintenance Audit ===\nDate: 2026-02-21 16:00\nPath: /home/user/.openclaw/workspace\n\n1. Checking for broken symlinks...\n⚠️  Found broken symlinks:\n/home/user/.openclaw/workspace/old-project/link-to-deleted\n\n2. Checking for empty directories...\nℹ️  Found empty directories:\n/home/user/.openclaw/workspace/projects/abandoned\n\n3. Checking for large files (>10MB)...\nℹ️  Found large files:\n24M\t/home/user/.openclaw/workspace/logs/debug.log\n\n4. Checking for malformed file/directory names...\n⚠️  Found malformed names:\n/home/user/.openclaw/workspace/projects/my project/file.md\n\n5. Disk usage by top-level directory:\n150M\tskills\n80M\tnotes\n50M\tprojects\n30M\tmemory\n\n6. File counts:\n  Total files: 1,234\n  Total directories: 156\n  Skills: 18\n  Subagents: 3\n\n7. Recently modified files (last 24 hours):\n/home/user/.openclaw/workspace/notes/cost-tracking.md\n/home/user/.openclaw/workspace/memory/owner/decisions.md\n\n=== Audit Complete ==="
      },
      {
        "title": "Agent-Driven Audit",
        "body": "Ask your agent:\n\n\"Run workspace maintenance audit\"\n\"Check workspace health\"\n\"Audit my workspace\"\n\nAgent will execute script and present findings with cleanup recommendations."
      },
      {
        "title": "1. Broken Symlinks",
        "body": "Causes:\n\nMoved/renamed files\nDeleted dependencies\nIncorrect relative paths\n\nFix: Remove symlink or update target"
      },
      {
        "title": "2. Empty Directories",
        "body": "Causes:\n\nDeleted projects\nFailed installations\nIncomplete migrations\n\nFix: Remove unless intentionally placeholder"
      },
      {
        "title": "3. Large Files",
        "body": "Common culprits:\n\nUncompressed logs (debug.log, error.log)\nBinary artifacts (.zip, .tar.gz)\nDownloaded datasets\nVideo/media files\n\nFix: Compress, move to external storage, or delete"
      },
      {
        "title": "4. Malformed Names",
        "body": "Problems caused by:\n\nSpaces in filenames → breaks scripts\nSpecial characters → shell escaping issues\nBraces/brackets → glob conflicts\n\nFix: Rename using kebab-case or snake_case\n\nExample:\n\n# Bad\nmy project/file (copy).md\n\n# Good\nmy-project/file-copy.md"
      },
      {
        "title": "Workspace Health Score",
        "body": "After running maintenance-audit.sh, your workspace gets a score:\n\nScoreStatusMeaning90-100🟢 HealthyMinor issues or none70-89🟡 FairSome cleanup needed50-69🟠 DegradedMultiple issues accumulating<50🔴 CriticalImmediate cleanup required\n\nScore is calculated based on: broken symlinks (-10 each), empty dirs (-2 each), files >100MB (-5 each), malformed names (-3 each)."
      },
      {
        "title": "Automation Strategy",
        "body": "FrequencyActionReasonDailyNoneToo aggressive, creates noiseWeeklyAudit only, log resultsCatch issues earlyMonthlyAudit + present to userReview & approve cleanupOn-demandBefore backups/deploymentsReduce backup size"
      },
      {
        "title": "Companion Skills",
        "body": "system-resource-monitor — Disk usage alerts complement workspace health\ncost-governor — Track subagent costs alongside workspace hygiene"
      },
      {
        "title": "Integration with Other Skills",
        "body": "openclaw-backup: Audit before backup to reduce size\ncost-governor: Track disk usage for storage costs\ndrift-guard: Organizational entropy as drift indicator"
      },
      {
        "title": "Adjust Large File Threshold",
        "body": "Edit maintenance-audit.sh:\n\n# Change from 10MB to 50MB\nfind \"$WS\" -type f -size +50M 2>/dev/null"
      },
      {
        "title": "Exclude Directories",
        "body": "Add to script:\n\nfind \"$WS\" -type d -empty 2>/dev/null \\\n  | grep -v \"node_modules\" \\\n  | grep -v \".git\" \\\n  | grep -v \"your-custom-dir\""
      },
      {
        "title": "Add Custom Checks",
        "body": "Extend script with:\n\nGit repo status checks\nDependency vulnerability scans\nLicense compliance audits"
      },
      {
        "title": "Philosophy",
        "body": "Prevent entropy — Structure degrades without maintenance\nAutomate detection — Scripts catch what humans miss\nUser-approved cleanup — Never auto-delete without permission\nStandards over rigidity — Guidelines, not laws"
      },
      {
        "title": "Troubleshooting",
        "body": "\"Script fails on macOS\"\n\nInstall GNU findutils: brew install findutils\nUse gfind instead of find\n\n\"Too many empty directories flagged\"\n\nExclude more dirs in script (e.g., .cache, .venv)\n\n\"Large files are necessary\"\n\nDocument in notes/workspace-notes.md why they're kept\nConsider moving to external storage (S3, NAS)"
      },
      {
        "title": "Advanced: Multi-Workspace Support",
        "body": "If managing multiple OpenClaw instances:\n\n# Audit all workspaces\nfor ws in ~/.openclaw-*; do\n  WS=\"$ws/workspace\" ./maintenance-audit.sh\ndone\n\nAuthor: OpenClaw Community\nLicense: MIT\nRequires: Bash, GNU coreutils (find, du, sort)"
      }
    ],
    "body": "Workspace Organization\n\nStandards and automated maintenance for clean OpenClaw deployments.\n\nFiles Included\nSKILL.md — Agent instructions\nREADME.md — Setup guide\nmaintenance-audit.sh — Run to audit workspace health\nsetup.sh — Run once to initialize standard structure\n\nNote: Scripts auto-detect your workspace. Pass a path as argument to override: ./maintenance-audit.sh /custom/path\n\nProblem Solved\n\nWorkspaces degrade over time:\n\nBroken symlinks from moved files\nEmpty directories from deleted projects\nLarge files eating disk space\nMalformed names breaking scripts\nNo visibility into workspace health\n\nThis skill provides automated audits + cleanup guidance to prevent entropy.\n\nWhen to Use\nNew workspace setup — Initialize standard directory structure\nPeriodic maintenance — Weekly/monthly health checks (cron recommended)\nPre-deployment cleanup — Remove cruft before backups\nDebugging workspace issues — Find broken symlinks, malformed names\nDisk space review — Identify large files and bloat\nWhat It Provides\n1. maintenance-audit.sh\n\nAutomated health check script that detects:\n\n✅ Broken symlinks\n✅ Empty directories (excluding node_modules, .git)\n✅ Large files (>10MB)\n✅ Malformed file/directory names (spaces, special chars)\n✅ Disk usage by top-level directory\n✅ File/directory counts\n✅ Recent changes (last 24 hours)\n2. setup.sh\n\nInitializes standard workspace structure:\n\n~/.openclaw/workspace/\n├── projects/           # Active work\n│   ├── writing/        # Writing projects\n│   └── code/           # Code projects\n├── notes/              # Organized notes\n│   ├── daily-reviews/\n│   ├── decisions/\n│   └── cost-tracking.md\n├── memory/             # Long-term memory\n│   ├── owner/          # Cross-channel user memory\n│   └── sessions/       # Per-session isolated memory\n├── skills/             # Custom skills\n├── subagents/          # Permanent specialists\n│   └── _archived/      # Old/deprecated subagents\n├── docs/               # Documentation\n└── scripts/            # Utility scripts\n\n3. Organization Standards (docs/)\n\nBest practices for:\n\nFile naming conventions (kebab-case, no spaces)\nDirectory structure guidelines\nCleanup policies (what to keep/delete)\nGit integration patterns\nSetup\nInstall skill:\ncd ~/.openclaw/workspace/skills\nclawhub install workspace-organization\n# Or: download from ClawHub and extract\n\nInitialize workspace (optional, if starting fresh):\ncd ~/.openclaw/workspace/skills/workspace-organization\n./setup.sh\n\nRun first audit:\ncd ~/.openclaw/workspace/skills/workspace-organization\n./maintenance-audit.sh\n\nSchedule automated audits (recommended):\nopenclaw cron add \\\n  --name \"Weekly Workspace Audit\" \\\n  --schedule \"0 4 * * 0\" \\\n  --task \"Run workspace maintenance audit: bash skills/workspace-organization/maintenance-audit.sh. Log results to notes/maintenance-log.md\"\n\nUsage\nManual Audit\ncd ~/.openclaw/workspace/skills/workspace-organization\n./maintenance-audit.sh\n\n\nExample output:\n\n=== Workspace Maintenance Audit ===\nDate: 2026-02-21 16:00\nPath: /home/user/.openclaw/workspace\n\n1. Checking for broken symlinks...\n⚠️  Found broken symlinks:\n/home/user/.openclaw/workspace/old-project/link-to-deleted\n\n2. Checking for empty directories...\nℹ️  Found empty directories:\n/home/user/.openclaw/workspace/projects/abandoned\n\n3. Checking for large files (>10MB)...\nℹ️  Found large files:\n24M\t/home/user/.openclaw/workspace/logs/debug.log\n\n4. Checking for malformed file/directory names...\n⚠️  Found malformed names:\n/home/user/.openclaw/workspace/projects/my project/file.md\n\n5. Disk usage by top-level directory:\n150M\tskills\n80M\tnotes\n50M\tprojects\n30M\tmemory\n\n6. File counts:\n  Total files: 1,234\n  Total directories: 156\n  Skills: 18\n  Subagents: 3\n\n7. Recently modified files (last 24 hours):\n/home/user/.openclaw/workspace/notes/cost-tracking.md\n/home/user/.openclaw/workspace/memory/owner/decisions.md\n\n=== Audit Complete ===\n\nAgent-Driven Audit\n\nAsk your agent:\n\n\"Run workspace maintenance audit\"\n\"Check workspace health\"\n\"Audit my workspace\"\n\n\nAgent will execute script and present findings with cleanup recommendations.\n\nCommon Issues Caught\n1. Broken Symlinks\n\nCauses:\n\nMoved/renamed files\nDeleted dependencies\nIncorrect relative paths\n\nFix: Remove symlink or update target\n\n2. Empty Directories\n\nCauses:\n\nDeleted projects\nFailed installations\nIncomplete migrations\n\nFix: Remove unless intentionally placeholder\n\n3. Large Files\n\nCommon culprits:\n\nUncompressed logs (debug.log, error.log)\nBinary artifacts (.zip, .tar.gz)\nDownloaded datasets\nVideo/media files\n\nFix: Compress, move to external storage, or delete\n\n4. Malformed Names\n\nProblems caused by:\n\nSpaces in filenames → breaks scripts\nSpecial characters → shell escaping issues\nBraces/brackets → glob conflicts\n\nFix: Rename using kebab-case or snake_case\n\nExample:\n\n# Bad\nmy project/file (copy).md\n\n# Good\nmy-project/file-copy.md\n\nWorkspace Health Score\n\nAfter running maintenance-audit.sh, your workspace gets a score:\n\nScore\tStatus\tMeaning\n90-100\t🟢 Healthy\tMinor issues or none\n70-89\t🟡 Fair\tSome cleanup needed\n50-69\t🟠 Degraded\tMultiple issues accumulating\n<50\t🔴 Critical\tImmediate cleanup required\n\nScore is calculated based on: broken symlinks (-10 each), empty dirs (-2 each), files >100MB (-5 each), malformed names (-3 each).\n\nAutomation Strategy\nFrequency\tAction\tReason\nDaily\tNone\tToo aggressive, creates noise\nWeekly\tAudit only, log results\tCatch issues early\nMonthly\tAudit + present to user\tReview & approve cleanup\nOn-demand\tBefore backups/deployments\tReduce backup size\nCompanion Skills\nsystem-resource-monitor — Disk usage alerts complement workspace health\ncost-governor — Track subagent costs alongside workspace hygiene\nIntegration with Other Skills\nopenclaw-backup: Audit before backup to reduce size\ncost-governor: Track disk usage for storage costs\ndrift-guard: Organizational entropy as drift indicator\nCustomization\nAdjust Large File Threshold\n\nEdit maintenance-audit.sh:\n\n# Change from 10MB to 50MB\nfind \"$WS\" -type f -size +50M 2>/dev/null\n\nExclude Directories\n\nAdd to script:\n\nfind \"$WS\" -type d -empty 2>/dev/null \\\n  | grep -v \"node_modules\" \\\n  | grep -v \".git\" \\\n  | grep -v \"your-custom-dir\"\n\nAdd Custom Checks\n\nExtend script with:\n\nGit repo status checks\nDependency vulnerability scans\nLicense compliance audits\nPhilosophy\nPrevent entropy — Structure degrades without maintenance\nAutomate detection — Scripts catch what humans miss\nUser-approved cleanup — Never auto-delete without permission\nStandards over rigidity — Guidelines, not laws\nTroubleshooting\n\n\"Script fails on macOS\"\n\nInstall GNU findutils: brew install findutils\nUse gfind instead of find\n\n\"Too many empty directories flagged\"\n\nExclude more dirs in script (e.g., .cache, .venv)\n\n\"Large files are necessary\"\n\nDocument in notes/workspace-notes.md why they're kept\nConsider moving to external storage (S3, NAS)\nAdvanced: Multi-Workspace Support\n\nIf managing multiple OpenClaw instances:\n\n# Audit all workspaces\nfor ws in ~/.openclaw-*; do\n  WS=\"$ws/workspace\" ./maintenance-audit.sh\ndone\n\n\nAuthor: OpenClaw Community\nLicense: MIT\nRequires: Bash, GNU coreutils (find, du, sort)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/donovanpankratz-del/workspace-organization",
    "publisherUrl": "https://clawhub.ai/donovanpankratz-del/workspace-organization",
    "owner": "donovanpankratz-del",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/workspace-organization",
    "downloadUrl": "https://openagent3.xyz/downloads/workspace-organization",
    "agentUrl": "https://openagent3.xyz/skills/workspace-organization/agent",
    "manifestUrl": "https://openagent3.xyz/skills/workspace-organization/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/workspace-organization/agent.md"
  }
}