cloud safe macos desktop organizer

    1

    Automated macOS Desktop cleanup that safely handles iCloud placeholders and prevents file collisions.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    cloud safe macos desktop organizer

    Example session with this skill installed

    My desktop is a mess with about 50 screenshots and some iCloud PDFs. Can you help me clean it up safely?

    • Read your context and instructions
    • Compiled the cloud safe macos

    I have completed a read-only inventory of your Desktop. I found 42 PNG screenshots and 8 PDF documents. Three of the PDFs are currently "dataless" (iCloud placeholders).

    Desktop Organization Plan (Dry Run)

    Source ItemProposed DestinationStatusReason
    Screenshot 2024-05-01.png~/Pictures/Screenshots/ReadyMatches image type
    Project_Specs_Final.pdf~/Documents/Work/DatalessRequires hydration first
    Notes.txt~/Desktop/Notes.txtCollisionDestination file already exists
    Vacation_List.pdf~/Documents/Travel/ReadyMatches existing folder name

    Inventory Summary:

    • Total items: 50
    • To move: 46
    • To remain: 4 (1 collision, 3 sensitive/ambiguous)
    • Cloud hydration required: 3 items (~12.4 MB)

    Execution Details:
    I will use open -g to hydrate the dataless PDFs before moving them to Documents. For the screenshots, I will create the ~/Pictures/Screenshots/ directory as it does not yet exist.

    Next steps

    1. Grant approval to hydrate the 3 cloud PDFs and proceed with the 46 moves.
    2. Manually resolve the collision for Notes.txt.
    3. Review the 3 sensitive files I left on the Desktop to decide on a destination.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Stop wasting time dragging messy screenshots and downloads into folders. This skill automates macOS Desktop organization while specifically handling the risks of iCloud Drive and other file providers. It prevents data loss by identifying dataless placeholders and ensuring cloud files are hydrated before cross-provider moves.

    What it does

    • Inventory desktop: Generates a read-only manifest of all items including type, size, and symlink status.
    • Identify destinations: Maps files to existing folders in Documents, Pictures, or Applications based on file metadata and attributes.
    • Detect cloud status: Checks for the dataless flag to identify files that exist only in the cloud.
    • Safe hydration: Requests local downloads for cloud-only files before attempting moves to ensure data integrity.
    • Collision prevention: Rechecks sources and destinations immediately before execution to avoid overwriting existing data.

    How it works

    1. Analyze: The agent scans your Desktop and logs every item while ignoring system files like .DS_Store.
    2. Plan: It proposes a dry-run manifest showing exactly where each file will go and why.
    3. Hydrate: For iCloud or Dropbox files not stored locally, it requests hydration through the file provider.
    4. Execute: It performs approved moves, using Finder-native methods for cloud-to-cloud transfers to maintain sync status.
    5. Verify: A final audit confirms items reached their destinations and report any deferred items or sync blockers.

    Frameworks & tools

    Uses macOS shell utilities including ls -lO, mdls, mdfind, and file. Interacts with file providers via Finder and the open command for hydration.

    Why this beats prompting it yourself

    Generic prompts often cause agents to attempt moving dataless iCloud files, resulting in broken aliases or zero-byte transfers. This skill understands macOS-specific file flags and native provider behavior to move files without breaking sync or losing remote-only data.

    Use cases

    • Screenshot cleanup: Batch move years of screenshots into dated folders within Pictures.
    • Work session archival: Sort project-related PDFs and assets from the Desktop into dedicated Documents subfolders.
    • Cloud sync fix: Safely move local Desktop files into iCloud Drive folders without sync deadlocks.

    Known limitations

    Requires macOS. Does not assume full-disk access. Will not delete files or overwrite existing items. Cannot move files if the file provider is unresponsive or sync is permanently stalled.

    Requires macOS. No support for Windows/Linux. Cannot bypass lack of Full Disk Access if restricted by system settings. Will not overwrite files or delete items.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 1 day ago

    • Free with an Agensi account

    Requires

    macOS

    Permissions

    Read Files
    Write Files
    Listed1 day ago

    What's inside

    Frequently Asked Questions

    Unlike basic scripts, this skill detects 'dataless' placeholders. It ensures files are fully downloaded (hydrated) from the cloud before moving them, preventing the common issue of empty files or broken aliases during desktop cleanup.

    The skill uses a 'Dry-Run' manifest first, showing you exactly where each file will go. It also performs a final collision check immediately before moving a file to ensure it never overwrites an existing document in the destination folder.

    The skill is designed for any AI agent with macOS shell access and the ability to execute terminal commands. It utilizes native macOS utilities like `mdls` and `ls -lO`, so no third-party developer tools are required.

    No, this skill is built with a safety-first approach. It is programmed strictly to move and organize files; it does not have the permissions or logic to delete files, empty the Trash, or remove system-critical items.

    You receive the complete logic for the inventory, planning, hydration, and execution modules. This includes the specific macOS metadata filters used to categorize files (like screenshots vs. PDFs) and the safety protocols for cloud-provider interaction.

    While the skill handles file movement, it requires an active internet connection if cloud-only files need to be hydrated. It cannot resolve issues where the file provider (like iCloud or Dropbox) is unresponsive or stuck in a sync error.

    New in Productivity