Agent skill
file-organization
Automated file and folder organization with categorization and duplicate detection
Install this agent skill to your Project
npx add-skill https://github.com/ljchg12-hue/dotfiles/tree/main/skills/file-organization
SKILL.md
File Organization Skill
Intelligent file organization based on content, metadata, and best practices.
When to Use
- File/folder organization requests
- Directory cleanup, duplicate detection
- Batch renaming, categorization
- Keywords: "organize files", "cleanup", "sort files"
Core Capabilities
1. Auto-Categorization
- Content/type-based classification
- Date-based (year/month/project)
- Size-based sorting
2. Duplicate Detection
- Hash-based (MD5, SHA256)
- Similar file/image detection
- Version detection (v1, v2, final)
3. Smart Folder Structures
- Project-based organization
- Domain templates (dev, design, docs, media)
4. Batch Renaming
- Pattern-based (regex)
- Sequential numbering
- Date prefix, case normalization
Quick Reference
Commands
# Find by type
find /path -type f -name "*.pdf"
# Find large files (>100MB)
find /path -type f -size +100M
# Find duplicates
fdupes -r /path
# Batch rename
rename 's/\.txt$/.md/' *.txt
Recommended Structures
/Documents/{PDFs,Word,Excel}
/Media/{Images,Videos,Audio}
/Code/{Projects,Scripts}
/Archives/{Compressed,Backups}
Naming Convention
YYYYMMDD_description_version.ext
2025-01-15_project-report_v2.pdf
Workflow
- Analysis: Scan, count types, detect duplicates
- Planning: Define structure, create rules
- Execution: Create dirs, move files, rename (dry-run first)
- Maintenance: Automate, document, monitor
Best Practices
- ✅ Backup before bulk operations
- ✅ Use dry-run mode first
- ✅ Keep folder depth ≤4 levels
- ❌ Don't organize system folders
- ❌ Don't delete duplicates without verification
Integration
- digital-forensics: Evidence preservation
- metadata-extraction: File metadata analysis
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
random-selection
Randomly select items from lists using various algorithms for fair and unbiased selection
threat-hunting
Proactive threat detection using Sigma rules, IOCs, and behavioral analytics
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.
debugging-strategies
Master systematic debugging techniques, profiling tools, and root cause analysis to efficiently track down bugs across any codebase or technology stack. Use when investigating bugs, performance issues, or unexpected behavior.
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.
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.
Didn't find tool you were looking for?