- Home
- Skills
- Productivity
- cloud safe macos desktop organizer
cloud safe macos desktop organizer
Automated macOS Desktop cleanup that safely handles iCloud placeholders and prevents file collisions.
Free
Works with the AI Agents you already use
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 Item | Proposed Destination | Status | Reason |
|---|---|---|---|
Screenshot 2024-05-01.png | ~/Pictures/Screenshots/ | Ready | Matches image type |
Project_Specs_Final.pdf | ~/Documents/Work/ | Dataless | Requires hydration first |
Notes.txt | ~/Desktop/Notes.txt | Collision | Destination file already exists |
Vacation_List.pdf | ~/Documents/Travel/ | Ready | Matches 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
- Grant approval to hydrate the 3 cloud PDFs and proceed with the 46 moves.
- Manually resolve the collision for
Notes.txt. - 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
datalessflag 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
- Analyze: The agent scans your Desktop and logs every item while ignoring system files like
.DS_Store. - Plan: It proposes a dry-run manifest showing exactly where each file will go and why.
- Hydrate: For iCloud or Dropbox files not stored locally, it requests hydration through the file provider.
- Execute: It performs approved moves, using Finder-native methods for cloud-to-cloud transfers to maintain sync status.
- 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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 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