{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mac-cleaner",
    "name": "Mac Cleaner - Because your Mac shouldn't have more baggage than your ex.",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/apprithm/mac-cleaner",
    "canonicalUrl": "https://clawhub.ai/apprithm/mac-cleaner",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/mac-cleaner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mac-cleaner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/mac-cleanup.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. 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. 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-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/mac-cleaner"
    },
    "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/mac-cleaner",
    "agentPageUrl": "https://openagent3.xyz/skills/mac-cleaner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mac-cleaner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mac-cleaner/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Mac Cleaner",
        "body": "Safely analyze and reclaim disk space on macOS. Designed for everyday Mac users — no technical knowledge required."
      },
      {
        "title": "When to use",
        "body": "\"My Mac says System Data is taking too much space\"\n\"How do I free up disk space?\"\n\"Why is my disk full?\"\n\"Clean up my Mac storage\"\n\"What's taking up space on my Mac?\""
      },
      {
        "title": "What this skill covers",
        "body": "CategorySafe to CleanNotesUser Caches✅ YesApp temporary filesiOS Simulators✅ YesUnused simulator devicesXcode Derived Data✅ YesBuild artifacts (rebuildable)Browser Caches✅ YesChrome, Safari, FirefoxSystem Logs✅ Old only7+ days old, requires sudoTrash✅ YesEmpty trashiOS Backups⚠️ ReviewCheck if backups are neededParallels VMs⚠️ ReviewOnly if Windows not neededTime Machine Snapshots⚠️ ReviewCan delete old snapshots"
      },
      {
        "title": "NEVER delete",
        "body": "/System folder contents\n/Library/Extensions or kernel extensions\n/private/var/db (system databases)\nActive iOS backups you need\nParallels VMs you use"
      },
      {
        "title": "Analyze (safe, read-only)",
        "body": "bash scripts/mac-cleanup.sh analyze\n\nShows disk usage and identifies large items without making changes."
      },
      {
        "title": "Clean (with confirmation)",
        "body": "bash scripts/mac-cleanup.sh clean\n\nPerforms safe cleanup after user confirmation."
      },
      {
        "title": "What gets cleaned",
        "body": "User Caches (~/Library/Caches/*)\n\nApp temporary files, thumbnails, downloaded content\nSafe: apps rebuild these automatically\n\n\n\nXcode Derived Data (~/Library/Developer/Xcode/DerivedData/*)\n\nBuild artifacts and intermediate files\nSafe: rebuilds on next compile\n\n\n\niOS Simulators (unavailable devices only)\n\nOld iOS simulator images\nSafe: easily re-downloaded via Xcode\n\n\n\nBrowser Caches\n\nChrome, Safari, Firefox cache files\nSafe: websites reload, login sessions preserved\n\n\n\nOld System Logs (7+ days)\n\nRequires sudo password\nPreserves recent logs for debugging\n\n\n\nTrash\n\nEmpties .Trash folder\nSafe: user already chose to delete these"
      },
      {
        "title": "Manual cleanup for large items",
        "body": "If the script identifies large items you want to handle manually:"
      },
      {
        "title": "iOS Device Backbacks (~/Library/Application Support/MobileSync/Backup)",
        "body": "# List backups\nls -lah ~/Library/Application\\ Support/MobileSync/Backup/\n\n# Delete specific backup (use folder name from above)\nrm -rf ~/Library/Application\\ Support/MobileSync/Backup/[FOLDER_NAME]\n\nOr use Finder → Locations → [Your iPhone] → Manage Backups"
      },
      {
        "title": "Time Machine Local Snapshots",
        "body": "# List snapshots\ntmutil listlocalsnapshots /\n\n# Delete all local snapshots\nsudo tmutil deletelocalsnapshots /\n\n# Or delete specific date\nsudo tmutil deletelocalsnapshots 2024-01-15-123456"
      },
      {
        "title": "Parallels VMs",
        "body": "Open Parallels Desktop:\n\nRight-click VM → Reclaim Disk Space (safest)\nOr Delete if you don't need Windows"
      },
      {
        "title": "WeChat / Large Apps",
        "body": "Clear from within the app:\n\nWeChat: Settings → General → Storage → Manage\nTelegram: Settings → Data and Storage → Storage Usage\nSlack: Help → Troubleshooting → Clear Cache"
      },
      {
        "title": "Large folders to review manually",
        "body": "PathWhat it isSafe to delete?~/DownloadsDownloaded filesReview first~/MoviesVideosReview first~/ParallelsWindows VMsOnly if not using~/Library/Containers/com.tencent.xinWeChatWeChat dataClear from WeChat app~/Library/Application SupportApp dataReview per app"
      },
      {
        "title": "Expected results",
        "body": "Typical cleanup results for an everyday Mac user:\n\nLight user: 2-5 GB freed\nDeveloper: 20-50 GB freed (Xcode, simulators)\nHeavy messaging apps: 50-100 GB freed (WeChat, Telegram)\nWith VMs: 50-200 GB freed (if deleting Parallels)"
      },
      {
        "title": "\"Operation not permitted\" errors",
        "body": "Grant Terminal Full Disk Access:\n\nSystem Settings → Privacy & Security → Full Disk Access\nAdd Terminal (or iTerm)\nRestart terminal"
      },
      {
        "title": "Cleanup didn't free much space",
        "body": "Run the analyze mode again:\n\nbash scripts/mac-cleanup.sh analyze\n\nLook for:\n\niOS device backups (often 50-200GB)\nParallels VMs (20-100GB each)\nWeChat/Telegram data (can be 100GB+)\nTime Machine snapshots (can accumulate)\n\nThese require manual review before deletion."
      },
      {
        "title": "References",
        "body": "Apple's storage documentation: https://support.apple.com/guide/mac-help/check-storage-space-mchlc03eb677/mac\nSafe macOS cleanup practices: https://support.apple.com/en-us/HT202083"
      }
    ],
    "body": "Mac Cleaner\n\nSafely analyze and reclaim disk space on macOS. Designed for everyday Mac users — no technical knowledge required.\n\nWhen to use\n\"My Mac says System Data is taking too much space\"\n\"How do I free up disk space?\"\n\"Why is my disk full?\"\n\"Clean up my Mac storage\"\n\"What's taking up space on my Mac?\"\nWhat this skill covers\nCategory\tSafe to Clean\tNotes\nUser Caches\t✅ Yes\tApp temporary files\niOS Simulators\t✅ Yes\tUnused simulator devices\nXcode Derived Data\t✅ Yes\tBuild artifacts (rebuildable)\nBrowser Caches\t✅ Yes\tChrome, Safari, Firefox\nSystem Logs\t✅ Old only\t7+ days old, requires sudo\nTrash\t✅ Yes\tEmpty trash\niOS Backups\t⚠️ Review\tCheck if backups are needed\nParallels VMs\t⚠️ Review\tOnly if Windows not needed\nTime Machine Snapshots\t⚠️ Review\tCan delete old snapshots\nNEVER delete\n/System folder contents\n/Library/Extensions or kernel extensions\n/private/var/db (system databases)\nActive iOS backups you need\nParallels VMs you use\nQuick start\nAnalyze (safe, read-only)\nbash scripts/mac-cleanup.sh analyze\n\n\nShows disk usage and identifies large items without making changes.\n\nClean (with confirmation)\nbash scripts/mac-cleanup.sh clean\n\n\nPerforms safe cleanup after user confirmation.\n\nWhat gets cleaned\n\nUser Caches (~/Library/Caches/*)\n\nApp temporary files, thumbnails, downloaded content\nSafe: apps rebuild these automatically\n\nXcode Derived Data (~/Library/Developer/Xcode/DerivedData/*)\n\nBuild artifacts and intermediate files\nSafe: rebuilds on next compile\n\niOS Simulators (unavailable devices only)\n\nOld iOS simulator images\nSafe: easily re-downloaded via Xcode\n\nBrowser Caches\n\nChrome, Safari, Firefox cache files\nSafe: websites reload, login sessions preserved\n\nOld System Logs (7+ days)\n\nRequires sudo password\nPreserves recent logs for debugging\n\nTrash\n\nEmpties .Trash folder\nSafe: user already chose to delete these\nManual cleanup for large items\n\nIf the script identifies large items you want to handle manually:\n\niOS Device Backbacks (~/Library/Application Support/MobileSync/Backup)\n# List backups\nls -lah ~/Library/Application\\ Support/MobileSync/Backup/\n\n# Delete specific backup (use folder name from above)\nrm -rf ~/Library/Application\\ Support/MobileSync/Backup/[FOLDER_NAME]\n\n\nOr use Finder → Locations → [Your iPhone] → Manage Backups\n\nTime Machine Local Snapshots\n# List snapshots\ntmutil listlocalsnapshots /\n\n# Delete all local snapshots\nsudo tmutil deletelocalsnapshots /\n\n# Or delete specific date\nsudo tmutil deletelocalsnapshots 2024-01-15-123456\n\nParallels VMs\n\nOpen Parallels Desktop:\n\nRight-click VM → Reclaim Disk Space (safest)\nOr Delete if you don't need Windows\nWeChat / Large Apps\n\nClear from within the app:\n\nWeChat: Settings → General → Storage → Manage\nTelegram: Settings → Data and Storage → Storage Usage\nSlack: Help → Troubleshooting → Clear Cache\nLarge folders to review manually\nPath\tWhat it is\tSafe to delete?\n~/Downloads\tDownloaded files\tReview first\n~/Movies\tVideos\tReview first\n~/Parallels\tWindows VMs\tOnly if not using\n~/Library/Containers/com.tencent.xinWeChat\tWeChat data\tClear from WeChat app\n~/Library/Application Support\tApp data\tReview per app\nExpected results\n\nTypical cleanup results for an everyday Mac user:\n\nLight user: 2-5 GB freed\nDeveloper: 20-50 GB freed (Xcode, simulators)\nHeavy messaging apps: 50-100 GB freed (WeChat, Telegram)\nWith VMs: 50-200 GB freed (if deleting Parallels)\nTroubleshooting\n\"Operation not permitted\" errors\n\nGrant Terminal Full Disk Access:\n\nSystem Settings → Privacy & Security → Full Disk Access\nAdd Terminal (or iTerm)\nRestart terminal\nCleanup didn't free much space\n\nRun the analyze mode again:\n\nbash scripts/mac-cleanup.sh analyze\n\n\nLook for:\n\niOS device backups (often 50-200GB)\nParallels VMs (20-100GB each)\nWeChat/Telegram data (can be 100GB+)\nTime Machine snapshots (can accumulate)\n\nThese require manual review before deletion.\n\nReferences\nApple's storage documentation: https://support.apple.com/guide/mac-help/check-storage-space-mchlc03eb677/mac\nSafe macOS cleanup practices: https://support.apple.com/en-us/HT202083"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/apprithm/mac-cleaner",
    "publisherUrl": "https://clawhub.ai/apprithm/mac-cleaner",
    "owner": "apprithm",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mac-cleaner",
    "downloadUrl": "https://openagent3.xyz/downloads/mac-cleaner",
    "agentUrl": "https://openagent3.xyz/skills/mac-cleaner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mac-cleaner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mac-cleaner/agent.md"
  }
}