# file-organization

Guides your agent to clear directory chaos, locate duplicate files by hash, and organize storage by file extension or date.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 608 installs · ★ 7
- Author: eyadsibai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/eyadsibai/ltk/tree/HEAD/plugins/ltk-product/skills/file-organization/SKILL.md
- Updated: 2026-01-15
- HTML: https://affpapa.org/en/nevibecode/skills/file-organization

## What it does

This skill outlines a systematic workflow for sorting messy directories such as `Downloads`. It prompts the assistant to inspect files with standard terminal utilities: identifying space hogs with `du` and spotting identical copies using `md5sum` hashes.

Work follows a strict five-step order. The assistant inspects the folder, drafts a directory structure, asks for user sign-off, moves items systematically, and outputs a brief summary.

Safety rules prevent silent file removal. Your agent requires a shell environment equipped with standard POSIX commands (`find`, `du`, `sort`).

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill file-organization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/file-organization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/file-organization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill file-organization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/file-organization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill file-organization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/file-organization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install eyadsibai/ltk file-organization
```

2. **Manually: put the files in place**
- File: `.github/skills/file-organization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill file-organization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/eyadsibai/ltk --path plugins/ltk-product/skills/file-organization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/file-organization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add eyadsibai/ltk --skill file-organization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/eyadsibai/ltk/tree/HEAD/plugins/ltk-product/skills/file-organization/SKILL.md

## When to use it
- locate exact file duplicates using hash or size checks
- clean up bloated download folders into categorized directories
- sort project files and images by date or department
- surface massive files before moving them to cold storage

## Example prompts
- Analyze `~/Downloads`, identify duplicate files, and suggest a clean folder hierarchy.
- List the largest files in this directory and group the rest by extension.
- Organize these exported reports into folders by calendar year.

## Similar
- [file-organizer](https://affpapa.org/en/nevibecode/skills/davepoon-file-organizer.md) — skill · 346 installs
- [disk-cleaner](https://affpapa.org/en/nevibecode/skills/disk-cleaner.md) — skill · 867 installs
- [janitor-report](https://affpapa.org/en/nevibecode/skills/janitor-report.md) — skill · ★ 122
- [gws-drive](https://affpapa.org/en/nevibecode/skills/gws-drive.md) — skill · 74600 installs
- [file-operations](https://affpapa.org/en/nevibecode/skills/file-operations.md) — skill · 414 installs
- [capgo-organization-management](https://affpapa.org/en/nevibecode/skills/capgo-organization-management.md) — skill · 685 installs

## Other versions with the same name
- [file-organization · akillness](https://affpapa.org/en/nevibecode/skills/akillness-file-organization.md) — 397 installs

From the same set: [eyadsibai/ltk](https://affpapa.org/en/nevibecode/by/eyadsibai/ltk.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md