Intelligent File Classifier

Problem It Solves

When local file trees accumulate downloads, project copies, backups, and shared folders, organizing by extension or year often loses business context. file-classifier handles bulk directory cleanup by inventorying, classifying, migrating, and validating files without deleting or overwriting the source.

How It Works

The skill requires an original directory and a target directory, then checks disk space and read/write permissions. Each run creates a YYYYMMDDNN task prefix to link related output files.
Core steps include:
- Inventory: traverses the source tree, counts files and folders, records depth and top-level distribution, and detects professional domains.
- Classification plan: prioritizes domain-specific taxonomy, with management or scenario-based categories as fallback; folders marked as project, system, complete, collection, version, or containing README-style files are migrated as whole units.
- Migration details: emits Markdown and Excel tables mapping each entry to a new path, noting nested folders, whole-unit moves, and rename decisions.
- Copy execution: creates target directories, copies files with Copy-Item to preserve metadata, appends numeric suffixes on name conflicts, and logs failures.
- Validation reports: produces inventory, planning, detail, and result reports for review.

Boundaries

It is best for complex directories where project folders must remain intact, not for cleanup or deletion. Users should ensure the source is read-only, the target is writable, and avoid pre-existing name collisions; top-level folders should stay between 15 and 30, and non-archive trees should generally stay within three levels.