Works with the AI tools you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+22 more

    folder tidy

    1

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

    $5

    Secure checkout via Stripe

    30-day refund 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.

    How to use

    Skills on Agensi run inside your AI agent. Copy the prompt, paste it into your agent, and it connects to Agensi and installs this skill for you. If a payment is needed, your agent shows it to you first.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    30-day refund

    Not a fit? Get your money back

    Trust & safety

    Security scanned

    Verified clean 3 days ago

    • Passed all security checks, Safe to install

    Listed3 days ago

    What's inside

    Frequently Asked Questions