File Organization

masslab-sii/file_organization

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.

21k tokens

context cost

the whole folder, loaded on every use

files

ships runnable scripts

copies elsewhere

how many repositories repackaged it

133

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/MassLab-SII/open-agent-skills --skill file_organization

The instruction itself

15 sections, as written by the author

File Organization Skill

This skill provides file analysis, manipulation, and organization:

Duplicate detection: Find and organize files with identical content
File merging: Combine multiple small files into one
File splitting: Split large files into smaller equal-sized parts
Pattern matching: Find files containing specific substrings
Text transformation: Convert files to uppercase and count words
Size classification: Organize files by size thresholds
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

How to use it

Copy the folder

Take masslab-sii/file_organization from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.