smart-file-organizer

Installation
SKILL.md

Smart File Organizer

Reads actual file contents to recover broken filenames, generate meaningful names from scratch, and optionally reorganize files into categorized folders — all with a safe rollback map.

Analyze file contents in a target directory (including all subdirectories), rename files to reflect their content, and optionally reorganize them into a logical folder structure.

Modes

  • rename-only (default): Rename files in place based on content analysis.
  • full-organize: Rename files AND reorganize them into a categorized folder structure (create, rename, merge folders).
  • collect: Scan files across directories and copy those matching a user-defined purpose into a single output folder. Does not rename or move originals.

Procedure

Step 1: Gather Parameters

Ask the user for:

Installs
34
GitHub Stars
3
First Seen
Mar 9, 2026