Overview

File-organizer uses user instructions to categorize, rename, and relocate files in a target directory using Bash commands. It starts by inspecting the directory with ls or find, then plans actions (mkdir, mv, cp, rename) aligned to the goal, and finally executes and verifies the results.

How This Skill Works

It inventories the target directory with ls or find to understand structure. It crafts a Bash plan that uses mkdir, mv, cp, and rename to implement the requested organization. If any action could be destructive, it asks for permission via notify_user unless the user has already authorized.

When to Use It

• Group files by extension into separate folders (e.g., images, docs).
• Rename batches of files to a consistent naming scheme.
• Move related files into project-specific subdirectories.
• Archive or relocate temporary or stray files to designated folders.
• Sort downloads by type and date to improve accessibility.

Quick Start

1. Step 1: Run ls or find in the target directory to understand current structure.
2. Step 2: Plan actions with mkdir, mv, cp, or rename; confirm with notify_user if actions are destructive.
3. Step 3: Execute the Bash script and verify results with ls -la, then report back.

Best Practices

• List the directory with ls or find before acting to understand structure.
• Draft a concrete plan using mkdir, mv, cp, and rename before running.
• Require explicit user permission with notify_user before destructive changes.
• Test on a copy or subset to avoid data loss.
• Verify the final structure with ls -la and spot-check critical files.

Example Use Cases

• Organize a photo dump by year and month, renaming files to IMG_YYYYMMDD.jpg.
• Group work documents by project and standardize filenames like PROJECT-Name-001.
• Move media files into media/ and docs into docs/ while preserving originals.
• Batch rename Excel files to a consistent prefix and sequence.
• Sort music by artist/album and normalize track names.

Frequently Asked Questions