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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

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