SafeSort: Download Organizer

    1

    Safely organize messy folders into type and topic subfolders with dry-runs, secret detection, and full undo support.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    SafeSort: Download Organizer

    Example session with this skill installed

    Clean up my ~/Downloads folder and group the files by topic.

    • Read your context and instructions
    • Compiled the safesort

    I have scanned ~/Downloads. I found 22 files to organize. I will skip 2 sensitive files and 1 file that already exists in the destination.

    Plan for ~/Downloads: 22 files, 0 moved yet

    Destination FolderCountExample Files
    Documents/Invoices/4invoice_oct.pdf, utility_bill.pdf
    Documents/Resumes/3software_eng_cv.docx, resume_draft.pdf
    Images/Screenshots/8Screenshot 2024-05-01.png, cap_02.jpg
    Code/_review/5script.py, index.html
    Archives/2backup.zip, project.tar.gz

    Skipped (sensitive): prod_secret.pem, recovery_codes.txt
    Skipped (exists): Images/logo.png (file already in destination)

    Type

    yes to move these files, or tell me what to change (e.g., "move script.py to Documents", "rename Resumes to Careers").

    Next steps

    • Type yes to execute this organization plan.
    • Ask to see the full list of files in Images/Screenshots before proceeding.
    • Tell me to leave the Archives folder untouched.

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

    About this skill

    Organizing a cluttered Downloads or Desktop folder is a manual chore that usually results in lost files or accidental deletions. Safesort automates the categorization of loose files into a clean, hierarchical structure while strictly prioritizing file safety and user control.

    What it does

    • Dry-run verification Proposes a complete folder structure and file list for review before touching any data.
    • Categorization by type Automatically groups files into standard directories like Documents, Images, Code, and Archives.
    • Topic clustering Analyzes file names and text content to create logical subfolders like Invoices or Resumes for large groups.
    • Secret detection Identifies and skips sensitive files such as API keys, PEM files, and recovery codes to keep them in place.
    • Undo capability Maintains a detailed JSONL log of every operation to allow for full reversal of any cleanup run.

    How it works

    1. Target confirmation The user specifies a folder, which the skill scans to resolve absolute paths and filter out hidden or system files.
    2. Structure proposal The skill generates a summary plan showing where files will be moved and which files will be skipped.
    3. User approval The skill waits for an explicit "yes" input before executing any move operations.
    4. Logged execution Files are moved using no-overwrite flags, with every action recorded to a timestamped log file in a hidden undo directory.

    Frameworks & tools

    This tool uses standard shell commands like mv -n on Unix-like systems and Move-Item in PowerShell for file operations. It requires filesystem access via a local agent environment like Claude Code or Cursor.

    Why this beats prompting it yourself

    Generic prompts often hallucinate file moves or accidentally delete data using aggressive shell commands. Safesort implements rigid safety checks, including path resolution to prevent directory traversal and a mandatory "no-overwrite" policy that simple prompts ignore.

    Use cases

    • Tidying Downloads Sorting months of web downloads into specific project and file-type folders.
    • Clearing Desktops Moving loose screenshots and documents into a structured archive without losing track of them.
    • Identifying Secrets Finding stray .env or .pem files that should be moved to a secure vault.
    • Reverting Changes Undoing a sorting run that didn't meet expectations using the built-in log.

    Known limitations

    Does not support recursive sorting of subfolders or file renaming. It skips files currently being downloaded and will not move files if the destination name already exists.

    Skips hidden files and subdirectories. Does not support file renaming or deduplication. Requires manual "yes" for every execution. Cannot move files if the target filename already exists.

    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 17 days ago

    • Free with an Agensi account

    Permissions

    Read Files
    Write Files
    Listed17 days ago

    What's inside

    Frequently Asked Questions

    Safesort runs a dry-run first to show you exactly where files will go, and it never overwrites existing files. If you aren't happy with the result, you can use the built-in undo command to instantly restore all files to their original locations.

    Yes, Safesort includes a secret detection layer that identifies sensitive files like API keys, .env files, and PEM keys. These files are flagged and skipped during the sorting process to ensure your credentials remain exactly where you put them.

    Safesort is designed for local agent environments like Claude Code, Cursor, or any AI assistant with filesystem and shell access. It works across Unix-like systems (macOS/Linux) and Windows via PowerShell.

    The skill targets loose files within a specific folder to ensure maximum safety. It currently does not perform recursive sorting of existing subfolders or rename your files, focusing instead on moving loose items into a clean, new hierarchy.

    You will receive the Safesort skill configuration, the core logic for the safety-first sorting engine, and clear instructions on how to load it into your preferred AI agent environment.

    New in Productivity