ReddRadar
Agent skill
file-organizer
Organize files and folders intelligently with duplicate detection
Install this agent skill to your Project
npx add-skill https://github.com/48Nauts-Operator/opencode-baseline/tree/main/.opencode/skill/file-organizer
Metadata
Additional technical details for this skill
- audience
- users
- workflow
- productivity
SKILL.md
File Organizer
Intelligently organize files and folders by understanding context, finding duplicates, and suggesting better structures.
When to Use
- Downloads folder is a mess
- Need to consolidate scattered files
- Looking for duplicate files to clean up
- Reorganizing a project structure
- Archiving old files systematically
How to Use
Analyze Current State
Analyze the structure of ~/Downloads and suggest organization
Find duplicate files in ~/Documents
Organize Files
Organize ~/Downloads by file type
Sort these files by date and move to archive
Project Cleanup
Reorganize this project following standard conventions
Organization Strategies
By Type (Default)
organized/
├── documents/ # .pdf, .doc, .txt, .md
├── images/ # .jpg, .png, .gif, .svg
├── videos/ # .mp4, .mov, .avi
├── audio/ # .mp3, .wav, .flac
├── code/ # .py, .js, .ts, .go
├── archives/ # .zip, .tar, .gz
├── data/ # .csv, .json, .xml
└── other/ # everything else
By Date
organized/
├── 2025/
│ ├── 01-January/
│ ├── 02-February/
│ └── ...
├── 2024/
└── older/
By Project
organized/
├── project-alpha/
│ ├── docs/
│ ├── assets/
│ └── exports/
├── project-beta/
└── unsorted/
Duplicate Detection
Find Duplicates
# By content hash (exact duplicates)
find . -type f -exec md5sum {} + | sort | uniq -d -w32
# By name (potential duplicates)
find . -type f -name "*copy*" -o -name "*(1)*"
Handle Duplicates
| Strategy | When to Use |
|---|---|
| Keep newest | Active files, latest version matters |
| Keep oldest | Original documents, provenance matters |
| Keep largest | Photos/videos (higher quality) |
| Keep in preferred location | Organized > Downloads |
Process
1. Analyze
- List all files with sizes and dates
- Identify file types and categories
- Detect potential duplicates
- Note naming patterns
2. Plan
- Propose folder structure
- Show what moves where
- Highlight duplicates for decision
- Estimate space savings
3. Execute (with confirmation)
- Create directory structure
- Move files to destinations
- Handle duplicates per user choice
- Generate summary report
4. Verify
- Confirm all files accessible
- No broken links or references
- Summary of changes made
Safety Rules
- Never delete without asking - always confirm before removing
- Preserve originals - copy first, delete after verification
- Handle conflicts - ask when destination exists
- Skip system files - ignore .DS_Store, Thumbs.db, etc.
- Respect .gitignore - don't move tracked files unexpectedly
Example Session
User: "Organize my Downloads folder"
Response:
## Analysis of ~/Downloads
📊 Found 847 files (12.3 GB)
### By Type
- Documents: 234 files (890 MB)
- Images: 412 files (3.2 GB)
- Videos: 45 files (6.1 GB)
- Archives: 89 files (1.8 GB)
- Other: 67 files (340 MB)
### Duplicates Found
- 23 exact duplicates (could save 1.2 GB)
- 45 similar names (need review)
### Proposed Structure
Downloads/
├── organized/
│ ├── documents/
│ ├── images/
│ ├── videos/
│ ├── archives/
│ └── other/
├── duplicates/ # For review
└── to-sort/ # Ambiguous files
Proceed with organization? [y/n]
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
48Nauts-Operator/opencode-baseline
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.
48Nauts-Operator/opencode-baseline
auth-implementation-patterns
Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.
48Nauts-Operator/opencode-baseline
sql-optimization-patterns
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries. Use when debugging slow queries, designing database schemas, or optimizing application performance.
48Nauts-Operator/opencode-baseline
monorepo-management
Master monorepo management with Turborepo, Nx, and pnpm workspaces to build efficient, scalable multi-package repositories with optimized builds and dependency management. Use when setting up monorepos, optimizing builds, or managing shared dependencies.
48Nauts-Operator/opencode-baseline
git-advanced-workflows
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.
48Nauts-Operator/opencode-baseline
turborepo-caching
Configure Turborepo for efficient monorepo builds with local and remote caching. Use when setting up Turborepo, optimizing build pipelines, or implementing distributed caching.
Didn't find tool you were looking for?