visual-file-sorter

What This Skill Does

The Visual File Sorter is an intelligent digital assistant designed to declutter your local filesystem. Instead of relying solely on generic metadata like file names or creation dates, this skill utilizes advanced Computer Use (vision) capabilities to actually 'view' the contents of files. It mimics a human workflow: opening a file, visually analyzing the document or image, synthesizing its context, and then intelligently renaming and moving it into an organized directory structure. It acts as an automated clerk that maintains your workspace cleanliness without requiring manual intervention.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/anotherj1/visual-file-sorter Ensure you have the necessary computer-use permissions enabled for the agent to allow it to interface with your OS-level GUI to open and read files.

Use Cases

This skill is ideal for professionals and power users who accumulate high volumes of unorganized downloads. It is perfect for:

• Organizing monthly financial documents like invoices, receipts, and bank statements into standardized formats.
• Managing research papers and work-related PDF documents that are saved with cryptic filenames.
• Categorizing creative assets, screenshots, or design drafts by their actual visual content.
• Maintaining a clean Desktop environment by automatically routing "temporary" files to appropriate project or archival folders.

Example Prompts

1. "I'm tired of the clutter, can you please organize my downloads folder for me?"
2. "Please scan my Desktop and move any work documents or invoices to the sorted archive."
3. "Execute a full cleanup of the downloads directory, renaming files by their contents and moving them to the Documents folder."

Tips & Limitations

• Safety First: The skill explicitly forbids the deletion of any files. It only performs renames and moves. If you decide to clean up specific "junk" files, you must do so manually.
• Performance: As this skill involves opening files and taking screenshots, it may take several seconds per file. Do not interrupt the process while a file is open.
• Accuracy: The quality of naming depends on the model's visual reasoning capabilities. For highly complex or password-protected files, the skill will fall back to the 'Other/Uncategorized' category to avoid misclassification.
• Extension Safety: The logic is hardcoded to protect file extensions; you never have to worry about the skill breaking your file associations by stripping or changing suffixes.