Files

What This Skill Does

The Files skill is a sophisticated, high-performance agent tool designed for large-scale file management and reorganization. Unlike basic file browsers, this tool acts as a power-user utility that manages file operations with a safety-first approach. It specializes in deduplication, bulk organization, and disk analysis, providing users with the ability to manage thousands of files without fear of data loss or accidental deletion. By incorporating an intelligent undo system, mandatory path canonicalization, and transparent trash handling, it ensures that every operation is trackable and reversible.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/ivangdavila/files

Use Cases

• Mass Deduplication: Automatically identify and categorize duplicates across large directories while hashing files securely to ensure data integrity.
• Disk Cleanup: Efficiently analyze directory sizes and move forgotten or redundant files into organized archives without risking permanent loss.
• Bulk Renaming and Reorganization: Execute structured cleanup tasks on large datasets where manual renaming would be prone to error.
• System Housekeeping: Safely remove cluttered files by leveraging the system's native trash bin rather than permanent deletion.

Example Prompts

1. "Analyze my Documents folder and identify any duplicate files larger than 100MB, then suggest a deduplication plan."
2. "Move all files from last month's project folder into an archive directory and generate an undo record for me."
3. "Clean up my Downloads folder: move all installers to a 'software' directory and identify old documents for potential removal."

Tips & Limitations

Tips:

• Always review the manifest generated for bulk operations involving 10+ files. The system is designed to protect you from fat-finger errors.
• The tool uses a local SQLite database for hash caching; if you perform frequent operations on massive directories, you will notice significant performance gains after the initial scan.

Limitations:

• This is not a file browser. It cannot open or edit file contents. Use standard system commands for text editing or launching applications.
• Symlinks are treated as high-risk by default. The agent will never follow them automatically, which keeps your system secure from directory traversal attacks.