Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    folder tidy

    1

    Tidy messy folders with content-aware renaming, duplicate isolation, and a safety-first undo system.

    $5

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    folder tidy

    folder tidy

    Example session with this skill installed

    I have a messy Downloads folder with a bunch of random PDFs and screenshots. Can you help me organize it and rename the generic scan files?

    • Read your context and instructions
    • Compiled the folder tidy

    I have scanned your ~/Downloads folder. I found 142 files, including 45 generic PDFs like scan001.pdf and 12 duplicate images. I've prepared a plan to sort them by category and year, with smart names for the documents.

    Proposed Organization Plan

    File CategoryCountActionExample Transformation
    Documents58Move & Renamescan004.pdf → Documents/2024/2024-02_Internet_Invoice_Comcast.pdf
    Images64Move by DateScreenshot_12.png → Images/2024/Screenshot_12.png
    Installers8Groupvscode-setup.exe → Installers/vscode-setup.exe
    Duplicates12IsolateIMG_4103 (1).jpg → _Duplicates/IMG_4103 (1).jpg

    I have generated rules.json with a {category}/{year} structure and names.json based on document content analysis.

    Next steps

    1. Review the generated tidy-output/preview.html to see the full list of renames and moves.
    2. If the names look correct, tell me to "apply the plan".
    3. Use the undo command later if you need to revert the changes.

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

    About this skill

    Managing folders full of IMG_9942.jpg and scan01.pdf is a manual chore that most developers ignore until their drive is full. This skill provides a structured, script-based workflow to categorize, rename, and deduplicate messy directories without the risk of data loss.

    What it does

    • Smart categorization organizes files by type and date into a clean folder hierarchy.
    • Content-aware renaming reads PDFs and documents to propose descriptive names like 2024-05-Electricity-Bill.pdf.
    • Deduplication identifies identical file contents and moves them to a separate staging area to save space.
    • Safe previewing generates an HTML report showing exactly what will happen before any file is touched.
    • Atomic undo records every move in a journal, allowing a full rollback with a single command.

    How it works

    1. Scan the target directory to index file types, generic names, and potential duplicates.
    2. Configure the layout rules for folder structures and date prefixes via a JSON configuration.
    3. Analyze document contents to generate human-readable names for generic files.
    4. Apply the plan after user approval, maintaining a local journal for safety.

    Frameworks & tools

    This skill uses a standalone Python 3.8+ script utilizing only the standard library for maximum compatibility. It requires local file system access and does not perform any network requests.

    Why this beats prompting it yourself

    Writing a custom script to handle file moves safely is time-consuming and error-prone. This skill includes a pre-built journaled undo system and logic to avoid breaking sensitive directories like .git or system folders that a basic prompt might overlook.

    Use cases

    • Downloads cleanup to sort installers, archives, and PDFs into dated folders.
    • Photo ingestion to organize mobile backups into {year}/{month} structures.
    • Document archiving to rename scanned receipts and bills based on their actual text.
    • Disk space recovery by isolating large duplicate files for manual review.

    Known limitations

    The script refuses to run on root drives, home directories, or system folders. Renaming requires the agent to have permission to read file contents.

    Refuses to process whole drives, home folders, or system directories. Requires local Python 3.8+ and read/write permissions. Renaming logic depends on the agent's ability to parse file text.

    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

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 1 month ago

    Requires

    Python

    Permissions

    Read Files
    Write Files
    Listed1 month ago

    What's inside

    Frequently Asked Questions

    The skill uses a journaled 'Atomic Undo' system that records every operation; if you aren't happy with the organization, you can revert the entire folder to its original state with a single command.

    Yes, the tool generates a safe HTML preview report that outlines every proposed move, rename, and deletion, requiring your explicit approval before any changes are executed.

    The skill is built as a standalone Python 3.8+ script designed for local execution, making it compatible with any AI agent that has file system access and a Python environment.

    To prevent accidental data loss, the skill includes hardcoded safeguards that prevent it from running on root directories, system folders, or hidden directories like .git.

    The skill uses 'content-aware' analysis to read the text inside PDFs and documents, allowing it to replace generic filenames like 'scan001' with descriptive titles based on the actual content.

    You receive the full Python script, the JSON configuration template for custom rules, and a comprehensive guide on how to integrate the skill into your agent's workflow.

    New in Productivity