cowork-folder-organizer — Claude Code skill: what it does
cowork-folder-organizer — a skill for Claude Code and Codex that tidies chaotic folders and shared drives. Scans the directory, proposes a folder hierarchy, and waits for user approval before moving any files.
MIT 108 installs ★ 440 updated 2026-10-20
npx skills add OneWave-AI/claude-skills --skill cowork-folder-organizer -a claude-codeWhat cowork-folder-organizer does
The skill inventories a given target directory, parsing document headers and media metadata. Files larger than 50MB are never opened directly; they are classified solely by extension and filename. Items are then clustered into contextual groups such as contracts, media assets, project archives, or temporary locks.
Duplicate detection checks cryptographic hashes first, followed by version suffixes. Nothing gets erased permanently. Duplicates and junk are quarantined inside _review-before-deleting/, while every rename and relocation gets appended to _organizer-log.md for rollbacks.
Once sorting wraps up, the root receives an INDEX.md outlining the tree and detailing the 20 most recent files. Single-action runs are also possible when you only want duplicate cleanup without restructuring.
What it helps with
- clean up cluttered desktop or downloads directories
- detect file duplicates via checksums and version tags
- standardize naming conventions across client assets
- generate a clear INDEX.md reference map for team drives
Example prompts for the agent
- Organize ~/Downloads with a full proposal first
- Just show me the plan for ./shared-drive without moving anything
- Dedupe only in ./project-files
How to install cowork-folder-organizer
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill cowork-folder-organizer -a claude-code2Manually: put the files in place
~/.claude/skills/cowork-folder-organizer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cowork-folder-organizer/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill cowork-folder-organizer -a codex2Manually: put the files in place
.agents/skills/cowork-folder-organizer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill cowork-folder-organizer -a cursor2Manually: put the files in place
.cursor/skills/cowork-folder-organizer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills cowork-folder-organizer2Manually: put the files in place
.github/skills/cowork-folder-organizer/SKILL.md1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill cowork-folder-organizer -a gemini-cli2Platform CLI
gemini skills install https://github.com/OneWave-AI/claude-skills --path cowork-folder-organizerManually: put the files in place
.devin/skills/cowork-folder-organizer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill cowork-folder-organizer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cowork-folder-organizer
How to install cowork-folder-organizer in Claude Code?
Run npx skills add OneWave-AI/claude-skills --skill cowork-folder-organizer -a claude-code in your terminal.
What does cowork-folder-organizer do?
It scans directory contents, groups files by topic, isolates redundant copies into quarantine, renames assets, and writes an INDEX.md index.
Does cowork-folder-organizer delete files permanently?
No, it moves duplicates and suspected junk into _review-before-deleting/ and logs every move in _organizer-log.md.
Source text
SKILL.md · MIT
--- name: cowork-folder-organizer description: 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. tools: Read, Glob, Grep, Write, Bash model: inherit --- # 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. Quarantine to `_review-before-deleting/` and let the human pull the trigger. - Preserve anything that looks like the only copy of original work (contracts, signed PDFs, raw footage) in place if its location seems intentional. - Keep names human-readable. No hash suffixes, no ALL_CAPS, no spaces-to-underscores churn on files that are already well named. - If the folder is a shared drive, flag files other people may have links to before renaming them. - Report at the end: files processed, moved, renamed, duplicates found, space reclaimable. ## Scheduled Mode When run as a recurring Cowork scheduled task (e.g. weekly on Downloads), skip the approval step only for previously approved rules: apply the established convention to new files, quarantine new junk, and post a summary of what moved. Anything that does not match an existing rule goes to `_needs-decision/` and is listed in the summary. ## Quick Commands - "Organize [path]" -- full workflow with proposal - "Just show me the plan" -- phases 1-4 only, no changes - "Dedupe only" -- duplicate detection and quarantine, no restructuring - "Undo" -- reverse the last run from `_organizer-log.md`
© OneWave-AI · MIT · OneWave-AI/claude-skills