Folder Organizer Auditor

Scan a folder, propose a reorganization plan, and execute it on approval. No blind file moves.

Productivityp4
by AgentVoltv1.0.0Published 1y ago1 install
Free to sign up · every skill included with AgentVolt Pro

Before & after

Same prompt, same agent — the only difference is the skill.

PromptMy Downloads folder has 3000 files and I hate it
Beforegeneric AI agent
That sounds painful. Downloads folders do tend to accumulate junk over time. You could sort by date and archive old files, or organize by file type (documents, images, installers). But first, it'd help to know: What matters to you—keeping important projects findable, cleaning up old stuff, or both? Do you want a time-based approach (archive anything over 6 months old) or a manual sort? Once I understand your priorities, I can suggest a cleanup strategy.
Afterwith Folder Organizer Auditor
DOWNLOADS AUDIT REPORT

CURRENT STATE
Total files: 2,847
Total size: 47.2 GB
Duplicate detected: 143 files (identical MD5, 2.1 GB)
Orphaned shortcuts: 34
Oldest file: Feb 2023 (1.5 years)

FILE BREAKDOWN
Images (screenshots, photos): 1,204 files (31%)
  → Duplicates found: 89 near-identical (same size, <1 week apart)
Installers (.dmg, .exe, .zip): 412 files (11%)
  → Recommendation: Delete (reinstall if needed)
Documents (PDF, Sheets, Word): 634 files (18%)
  → Keep (archive by project to Desktop/Archived)
Video: 342 files (9%)
  → Move to external HD (size-heavy, rarely needed)

PROPOSED STRUCTURE
Downloads/
  Current/ (files <30 days old)
  2026-Q2/ (files 30-90 days old)
  Archive/ (files >90 days old)
  Duplicates/ (review before deleting)

MOVE PLAN
→ Step 1: Flag 143 duplicates for review (your approval needed)
→ Step 2: Archive 1,240 images by month (auto-created folders)
→ Step 3: Delete 412 installers (keep list if paranoid)
→ Step 4: Move 342 videos to External HD
→ Result: 85% size reduction, 15 minutes total

RUNNING THE PLAN
Dry run first? Run /audit-execute --dry-run
Then: /audit-execute --confirm-all (starts moving)

About this skill


name: folder-organizer-auditor description: Scan a folder, propose a reorganization plan, and execute it on approval. No blind file moves. Use when working on folder organizer auditor.

Folder Organizer Auditor

Reads a target directory, diagnoses the current mess, presents a proposed structure, and only then makes the moves. Handles Downloads, Photos, and general project routes. Use when your Downloads folder has become a horror show and you actually want a plan before mass-moving files.

What you get

  • Current-state audit
  • Proposed structure
  • Move plan (before/after paths)
  • Execution log
  • Dedupe report
  • Archive-by-age rule application

Customize your output

  • Target directory: dir
  • Naming convention: date-first, project-first, mixed
  • Dedupe strategy: keep newest, keep oldest, ask
  • Age-based archive rule: 90 days, 180, 365, off
  • Dry run: yes, no
  • Recurse into subfolders: yes, no

Example output

'56 orphan screenshots in Downloads. Move to Assets/Screenshots by month, dedupe 12 near-duplicates.'

Best for

Anyone whose Downloads folder is a horror show.


Note: High confidence. Approval gate before any move is the killer feature.

SKILL.md preview

SKILL.md
---
name: folder-organizer-auditor
description: Use this skill to scan a messy folder, propose a reorganization plan, and execute the moves only after approval.
version: 1.0.0
category: Productivity
author: AgentVolt
license: proprietary
tags:
  - productivity
  - p4
---

# Folder Organizer Auditor

Audits a directory's current state, proposes a new structure, and only executes file moves after the plan is explicitly approved — never a blind bulk move.

## When to use

… (sign up to view the full skill)
Sign up to view, copy, and install the full skill