A power-user skill for intelligent file reorganization, deduplication, and disk space analysis with built-in safety nets and undo capabilities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install files
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install files using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Files: Intelligent File Organization & Management?
The Files skill is a sophisticated tool designed for the Openclaw Skills ecosystem to handle complex file management tasks that standard operations cannot. It focuses on reorganization, deduplication, and deep disk analysis while maintaining a strict security posture. Unlike basic file commands, this skill provides intelligent proposals for organizing cluttered directories by date or type, identifies large disk space consumers, and flags temporary build folders like node_modules for safe cleanup.
Built with a safety-first mindset, the Files skill includes a robust undo system and leverages native OS trash mechanisms. It is specifically engineered to handle bulk operations—managing thousands of files across Linux, macOS, and Windows—ensuring that every move or rename is tracked and reversible.
Files: Intelligent File Organization & Management Use Cases
- Deep cleaning cluttered Downloads or Desktop folders by grouping files into date or type-based subdirectories.
- Finding and removing duplicate files using a multi-phase hashing algorithm to save disk space.
- Safely batch renaming hundreds of files with transformation previews and atomic rollback support.
- Analyzing disk usage to identify top space consumers and safely removable cache directories.
- Migrating large datasets between directories while maintaining an audit trail and manifest.
How Files: Intelligent File Organization & Management Works
- The skill canonicalizes and validates all file paths to ensure operations stay within safe user boundaries.
- It analyzes the target directory to identify file distributions and potential cleanup candidates.
- For bulk actions, it generates a manifest or summary for user review before any changes are committed.
- Operations are executed atomically per-file, with progress updates provided every 5% or 30 seconds.
- Every action is logged to a JSON-based undo record, allowing for full reversal of the operation.
Files: Intelligent File Organization & Management Setup
The Files skill is designed to work out of the box with Openclaw Skills, but certain environments benefit from native utilities:
# On macOS, ensure the trash utility is installed for better recycling support
brew install trash
# The skill automatically handles directory creation for metadata at:
# ~/.local/share/file-organizer/
Files: Intelligent File Organization & Management Data Schema & Taxonomy
The skill maintains a structured metadata system to ensure reliability and recoverability.
| Component | Location | Format | Purpose |
|---|---|---|---|
| Undo Records | ~/.local/share/file-organizer/undo/ |
JSON | Tracks source/dest, checksums, and timestamps. |
| Hash Cache | ~/.local/share/file-organizer/hash-cache.db |
SQLite | Stores file hashes for fast deduplication. |
| Manifests | Target Directory | .file-organizer-manifest.json |
Documents reorganization history for a specific folder. |
| Trash Metadata | ~/.local/share/file-organizer-trash/ |
JSON | Tracks original paths and deletion IDs if native trash fails. |
Files: Intelligent File Organization & Management Advanced Features
- Multi-phase duplicate detection (Size -> 4KB Hash -> Full Hash) with SQLite caching for extreme speed on large volumes.
- Atomic batch operations with automatic rollback on error to prevent partial or corrupted file states.
- Intelligent "Safe Path" logic that requires explicit confirmation and manifests for operations involving 10+ files.
- Automatic identification of developer-specific bloat like node_modules, pycache, and target folders.
- Native integration with macOS Trash, Windows Recycle Bin, and Linux XDG trash specifications.
SKILL.md
Loading
Related Openclaw Skills
FFmpeg
A technical guide for processing video and audio with precise codec selection, filtering, and high-performance encoding settings.
Feelings
A sophisticated personal emotional tracking system designed to identify mood patterns, triggers, and effective coping strategies.
Fashion
A personal AI stylist designed to provide body-aware outfit advice, decode complex dress codes, and optimize shopping habits based on real-world constraints.
Family
A structured AI framework for managing household operations, family schedules, and care routines while maintaining strict privacy boundaries.
Finance
A sophisticated financial intelligence skill that adapts its technical depth from personal budgeting to professional investment research.
Find
A sophisticated discovery pattern that utilizes progressive search expansion and multi-source validation to locate specific information until success criteria are met.
Featured*
