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

- **Type:** Skill
- **Install:** `agentstack add skill-masslab-sii-open-agent-skills-file-organization`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MassLab-SII](https://agentstack.voostack.com/s/masslab-sii)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [MassLab-SII](https://github.com/MassLab-SII)
- **Source:** https://github.com/MassLab-SII/open-agent-skills/tree/main/portable-skills/file_organization

## Install

```sh
agentstack add skill-masslab-sii-open-agent-skills-file-organization
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [MassLab-SII](https://github.com/MassLab-SII)
- **Source:** [MassLab-SII/open-agent-skills](https://github.com/MassLab-SII/open-agent-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-masslab-sii-open-agent-skills-file-organization
- Seller: https://agentstack.voostack.com/s/masslab-sii
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.