Folder Cleanup Audit and Approved Moves

Get a folder audit, an exact move plan, and approved file moves with collision checks, duplicate evidence, and an undo log.

Productivityfolder-organizationfile-management
by AgentVoltv1.0.0
Free to sign up · every skill included with AgentVolt Pro

Before & after

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

Prompt“My 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 Cleanup Audit and Approved Moves
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

Your Downloads folder is full, but a bulk cleanup could bury current work or overwrite a file with the same name. This skill audits what is actually there, proposes an exact destination for each candidate, and executes the reviewed moves only after approval.

What it does

  • Separates eligible files from recent work, ambiguous items, linked directories, and protected project structures.
  • Proposes a shallow folder layout based on the files present, with explicit source and destination paths.
  • Finds byte-identical duplicate candidates using size and content hashes while keeping similar photos and filenames separate.
  • Checks destinations for existing files, case conflicts, and unsafe paths before moving anything.
  • Applies optional age-based archive rules using a stated date source and threshold.
  • Verifies completed moves and records enough information to reverse them without overwriting later work.

What you get

A current-state audit, a proposed folder tree, and a complete move manifest for approval. If execution is available and approved, you also get a verified execution log, duplicate findings, skipped items, and rollback instructions.

Best for

People cleaning up Downloads, ordinary photo folders, or accumulated document folders who want control over every move. Also useful for project-folder audits where files with dependencies need to be identified before anything changes.

SKILL.md preview

SKILL.md
---
name: folder-cleanup-audit-and-approved-moves
description: Audit a folder with a read-only inventory, propose an exact source-to-destination move manifest, then execute approved moves with collision checks, verification, and a rollback log. Use when the user says "organize my Downloads", "audit this folder before moving anything", "my files keep ending up in the wrong folders", "find duplicate files without deleting them", "sort these photos by date", "archive old downloads", or "show me a cleanup plan I can approve".
---

# Folder Cleanup Audit and Approved Moves

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

Featured in

More productivity skills

View all Productivity skills →