Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OneWave-AI/claude-skills --skill cowork-folder-organizer -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/cowork-folder-organizer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cowork-folder-organizer/

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

Similar skills

All skills for Notes, tasks and projects →

From the same set185

The whole set →
local-seo-optimizer local-seo-optimizer — a Claude Code skill for local SEO audits and Google Business Profile optimization. Identifies listing gaps and benchmarks performance against map pack competitors. CX Codex +1 114installs cowork-rfp-response cowork-rfp-response — a skill for Claude Code that shreds RFP documents and maps requirements against company archives. It flags unanswerable criteria and disqualifiers before drafting starts. CX Codex +1 112installs review-response-writer The review-response-writer Claude Code skill drafts review replies in the owner’s voice and sorts reviews by situation. It flags mentions of injury, illness, discrimination, or legal threats for the owner. CX Codex +1 110installs dark-mode-converter The dark-mode-converter Claude Code skill turns a light-only project into a dark theme built around semantic color roles. It also wires up theme switching and saved preferences. CX Codex +1 108installs cowork-hiring-screener cowork-hiring-screener — a Claude Code skill that scores resumes against a job description and ranks candidates with supporting evidence. It takes a resume folder and the role requirements. CX Codex +1 107installs design-tokens-sync design-tokens-sync — a skill for Claude Code tracks drift between canonical design tokens and UI code. It catches hardcoded values, outdated duplicates, and unused variables across stylesheets. CX Codex +1 107installs cowork-inbox-triage cowork-inbox-triage — a Claude Code skill that triages unread email via Microsoft 365 or Gmail MCP connectors. Scans threads from the last 24 hours and prepares drafts for review. CX Codex +1 106installs cowork-expense-audit The cowork-expense-audit Claude Code skill checks receipts against statement entries and sorts transactions into expense categories. It produces a ledger plus a memo covering gaps and flagged items. CX Codex +1 106installs

Project sponsors

Companies that keep this analytics open