File Category Organizer

Problem

Top-level folders often mix images, Office documents, archives, scripts, logs, and temporary files. Manual sorting by type is slow and can mishandle files such as .log, .tmp, or files that are already open. Without a rollback mechanism, recovering the original location after a mistaken move can be difficult. A clear, previewable, reversible workflow is needed.

How It Works

The skill matches file extensions and moves top-level files in the target directory into Images, Documents, Audio, Video, Archives, Code, Executables, or Others. Key behaviors include:
- It scans only the top level by default and does not recurse into subdirectories, reducing unexpected structural changes
- It supports --dry-run for preview, --exclude-ext for skipped extensions, and --undo based on .file-organizer-log.json
- It skips hidden files and the manifest itself, and appends numeric suffixes when names collide, lowering overwrite risk

Boundaries

It relies on extensions, so it cannot classify files without extensions, files with nonstandard suffixes, or objects that require content-based detection. If a file is locked by another process, it should be closed or excluded first. For complex directories, shared drives, or deep archival needs, combine it with content analysis, permission checks, or manual review before running it.