# Organize Files

> Propose a plan first, then move or delete only what the user confirms, batch by batch. TRIGGER WHEN: organizing messy folders (Downloads, Desktop, Documents), finding duplicate files, cleaning up directories, or restructuring file hierarchies. DO NOT TRIGGER WHEN: the task is about code refactoring (use clean-code or python-refactor).

- Skill: `acaprino/organize-files` (Agent Skill)
- Install (CLI): `npx skillmds@latest add acaprino/organize-files`
- Raw SKILL.md: https://api.skillmd.com/api/skills/acaprino/organize-files/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: acaprino (https://skillmd.com/u/acaprino)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/acaprino/organize-files

---


> Arguments: `<path> [find duplicates | by type | by date]`. Wherever `<arguments>` appears below, substitute the text the user typed after the skill name.

<!-- Generated by the Daodan compiler for codex. Edit the kernel, never this file. -->

# File Organizer

Use the `file-organizer` skill to organize, cleanup, and restructure:

<arguments>

**Safety**: the skill always proposes a plan and asks for approval before moving or deleting anything. Destructive operations (duplicate removal, file deletion) require explicit confirmation per batch.

## Quick Examples

- `/organize-files Downloads` - Organize Downloads folder by file type
- `/organize-files ~/Documents find duplicates` - Find and remove duplicate files
- `/organize-files ~/Projects archive old` - Archive inactive projects
- `/organize-files . cleanup` - Clean up current directory