- Home
- Skills
- Productivity
- folder tidy
Works with the AI Agents you already use
folder tidy
Tidy messy folders with content-aware renaming, duplicate isolation, and a safety-first undo system.
$5
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 Category | Count | Action | Example Transformation |
|---|---|---|---|
| Documents | 58 | Move & Rename | scan004.pdf → Documents/2024/2024-02_Internet_Invoice_Comcast.pdf |
| Images | 64 | Move by Date | Screenshot_12.png → Images/2024/Screenshot_12.png |
| Installers | 8 | Group | vscode-setup.exe → Installers/vscode-setup.exe |
| Duplicates | 12 | Isolate | IMG_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
- Review the generated
tidy-output/preview.htmlto see the full list of renames and moves. - If the names look correct, tell me to "apply the plan".
- 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
- Scan the target directory to index file types, generic names, and potential duplicates.
- Configure the layout rules for folder structures and date prefixes via a JSON configuration.
- Analyze document contents to generate human-readable names for generic files.
- 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
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
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