Agent skill · operations · onewave-ai
cowork-folder-organizer
Cowork-style cleanup of a messy folder or shared drive -- classifies every file, proposes a target structure, renames to a consistent convention, deduplicates, and writes an index. Use on Downloads, Desktop, client folders, or team shared drives.
Why this skill is useful
Adds a comprehensive executable script for organizing and managing files in a directory, including deduplication and logging capabilities.
What it needs
Requires bash installed locally. About 2k tokens when loaded. Last updated 2026-07-15. 242 stars on the source repository.
What this skill does
Cowork Folder Organizer Turn a chaotic folder into an organized, navigable workspace the way Claude Cowork works through a directory: inventory everything first, propose before moving, then execute with a full undo trail. Never destroy information -- every move is logged and reversible. Input Take a directory path. If none is provided, ask for one. Confirm scope before touching anything: subdirectories included or not, and whether any paths are off-limits. Workflow 1. Inventory. Walk the directory. For every file record name, extension, size, modified date, and a one-line content summary (read headers/first lines for documents, metadata for media). Do not open files larger than 50MB; classify by name and type only. 2. Classify. Group files into categories inferred from the actual contents -- not a generic template. Typical clusters: active project files, reference material, financial documents, contracts, media/assets, installers and archives, duplicates, junk (temp files, ~$ locks, empty files). 3. Detect duplicates. Match by checksum first, then by near-identical names with version suffixes (final, final2, v3, (1)). Identify the canonical copy (newest complete version) and mark the rest. 4. Propose. Present the target folder tree, the naming convention (default: YYYY-MM-DD-descriptive-name.ext for dated documents, client-project-doctype for client work), the duplicate resolution list, and the junk list. Wait for approval before moving anything. 5. Execute. Create the structure, move and rename files, quarantine duplicates and junk into review-before-deleting/ -- never delete outright. Log every operation as old-path -> new-path in organizer-log.md. 6. Index. Write INDEX.md at the root: the new tree, what lives where, and a table of the 20 most recently active files so the owner can re-orient instantly. Rules Propose first, move second. Never reorganize without showing the plan. Never delete. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills onewave-ai/cowork-folder-organizer