File Organizer Skill

Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities.

Security Scan

The skill's code and instructions match its stated purpose (organizing files locally) and request no external credentials or installs; behavior is coherent with the description.

Purpose & Capability

Name/description (organize files by extension/date, dry-run, recursive, undo) align with the included script and SKILL.md; there are no unrelated environment variables, binaries, or install steps.

Instruction Scope

Runtime instructions only instruct running the included Python script with expected flags (--dry-run, --date, --recursive, --undo). The script operates on the given directory and writes a local organize_history.json; it does not read unrelated system files or call external endpoints.

Install Mechanism

No install spec — instruction-only with a bundled Python script. No remote downloads or package installs are performed.

Credentials

The skill requests no environment variables or credentials (appropriate). Note: it records absolute source and destination paths in organize_history.json (privacy/metadata risk if that file is shared).

Persistence & Privilege

always is false and the skill does not modify other skills or global agent settings. It only writes a history file into the target directory, which is expected for undo functionality.

Assessment

This skill appears to do what it says: organize files locally and keep a history for undo. Before running: (1) run with --dry-run to verify results, (2) avoid pointing it at system/root directories (it will operate under whatever directory you give it), (3) be aware organize_history.json contains absolute paths—do not share that file if it contains sensitive locations, and (4) back up important data if you are nervous. If you want different category mappings, update get_default_mapping() as suggested in SKILL.md.

File Organizer (Gold Standard)

Features

• Smart Sorting: Group by Extension (Default) or Date (Year/Month).
• Safety: Conflict resolution (auto-rename), Dry Run mode, and Undo capability.
• Deep Clean: Recursive scanning option.
• Audit: Generates organize_history.json for tracking.

Usage

Basic Sort (by Extension)

python3 scripts/organize.py /path/to/folder

Date Sort (Year/Month)

Great for photos or archives.

python3 scripts/organize.py /path/to/folder --date

Dry Run (Simulate)

See what would happen without moving anything.

python3 scripts/organize.py /path/to/folder --dry-run

Undo

Revert changes using the history file.

python3 scripts/organize.py --undo /path/to/folder/organize_history.json

Config

Modify scripts/organize.py get_default_mapping() to add custom extensions.