file-organization

name	file_organization
description	File organization toolkit. Provides duplicate detection, file merging/splitting, pattern matching, text processing (like case conversion, word counting), and file classification by size or time.

File Organization Skill

This skill provides file analysis, manipulation, and organization:

1. Duplicate detection: Find and organize files with identical content
2. File merging: Combine multiple small files into one
3. File splitting: Split large files into smaller equal-sized parts
4. Pattern matching: Find files containing specific substrings
5. Text transformation: Convert files to uppercase and count words
6. Size classification: Organize files by size thresholds
7. Time classification: Organize files by creation time

---

1. Duplicate File Detection

Scans all files in a directory, identifies files with duplicate content, and moves them to a separate subdirectory.

Example

# Find and organize duplicate files (default directory name: 'duplicates')
python find_duplicates.py /path/to/directory

# Use a custom directory name for duplicates
python find_duplicates.py /path/to/directory --duplicates-dir my_duplicates

---

2. File Merging

Identifies the N smallest .txt files, sorts them alphabetically, and merges their content into a single file.

Example

# Merge the 10 smallest .txt files (default)
python merge_files.py /path/to/directory

# Merge the 5 smallest files
python merge_files.py /path/to/directory --count 5

# Use a custom output filename
python merge_files.py /path/to/directory --output merged_content.txt

---

3. File Splitting

Splits a large text file into multiple smaller files with equal character counts.

Example

# Split large_file.txt into 10 equal parts (default)
python split_file.py /path/to/directory large_file.txt

# Split into 5 parts
python split_file.py /path/to/directory large_file.txt --parts 5

---

4. Pattern Matching

Finds all files that contain a substring of N or more characters that also appears in a reference file.

Example

# Find files with 30+ character matches (default)
python pattern_matching.py /path/to/directory large_file.txt

# Use a custom minimum length
python pattern_matching.py /path/to/directory large_file.txt --min-length 50

---

5. Text Transformation (Uppercase)

Converts text files to uppercase and counts words in each file.

Example

# Convert specific files to uppercase
python convert_uppercase.py /path/to/directory --files file_01.txt file_02.txt file_03.txt

---

6. File Size Classification

Classifies files into different subdirectories based on their file sizes.

Example

# Using default thresholds (300 and 700 bytes)
python classify_files_by_size.py /path/to/directory

# Custom thresholds
python classify_files_by_size.py /path/to/directory --small 1024 --large 10240

# Custom category names
python classify_files_by_size.py /path/to/directory --small-category tiny --medium-category normal --large-category huge

---

7. File Time Classification

Classifies files into MM/DD directory structure based on their creation time.

Example

# Classify files by creation time
python classify_files_by_time.py /path/to/directory