File Batch Processor

One-click batch processing for all files: rename, compress images, convert to PDF, auto organize. No software installation needed, runs locally, safe and ad-...

Security Scan

The skill's code and runtime instructions match its stated purpose (local batch file operations); the only meaningful mismatch is the marketing claim that 'no software installation needed' while the scripts require Python and third‑party Python packages and will modify user files in place.

Purpose & Capability

Name/description (batch rename, image compression, PDF conversion, auto-categorize) align with the provided Python scripts. However the marketing claim 'No software installation needed' contradicts other documentation which lists Python 3.8+ and libraries (Pillow, PyPDF2, fpdf). Requiring those dependencies is reasonable for the stated functionality, but the 'no installation' statement is misleading.

Instruction Scope

SKILL.md and README instruct running the included scripts against a user-selected folder. The runtime instructions and code only access local filesystem paths provided by the user and do not attempt to read unrelated system configuration, environment variables, or network endpoints.

Install Mechanism

No install spec is present (instruction-only). The package includes Python scripts that run locally — there are no remote downloads, no installers, and no obscure install URLs. Dependencies are standard Python libraries available from PyPI.

Credentials

The skill requests no environment variables, no credentials, and no config paths. That is proportionate to its local file-processing purpose. The only required resources are Python and the declared libraries.

Persistence & Privilege

The skill does not request persistent platform privileges (always:false). It does not modify other skills or system-wide agent settings. It runs locally when invoked.

Assessment

This skill appears to be what it says: local Python scripts for renaming, compressing, converting, and organizing files. Before installing/using: 1) Note the documentation is inconsistent — it claims 'no installation' but you need Python 3.8+ and Pillow, fpdf, PyPDF2 (install in a virtualenv). 2) Always test with --dry-run and on a small sample; these scripts modify files in place (image compression overwrites originals; there is no automatic backup even though a backup filename is constructed in the code). 3) Be aware convert_to_pdf writes a temporary file named 'temp_image.jpg' in the working directory (could overwrite an existing file); run from a safe directory. 4) Review the code locally if you have sensitive or system folders — do not point it at system directories. 5) If you plan to purchase or run this from an unknown source, prefer running it in an isolated environment and inspect/verify dependencies and code first.

File Batch Processor Master

🎯 Core Features

1. Batch File Rename - Multiple naming modes (sequence, date, prefix/suffix, etc.)
2. Batch Image Compression - Smart JPEG/PNG compression with quality preservation
3. Batch to PDF - One-click conversion of images and text files to PDF
4. Auto Categorization - Automatically categorize files by type (documents, images, audio, video, archives)

🚀 Quick Start

Basic Workflow

1. Select folder to process

2. Choose processing functions (can select multiple)

3. Configure parameters (rename rules, compression quality, etc.)

4. Execute processing

5. View results report

## 📁 Directory Structure

file-batch-processor/ ├── SKILL.md (current file) ├── scripts/ │ ├── batch_rename.py │ ├── image_compress.py
│ ├── convert_to_pdf.py │ └── auto_organize.py └── references/ ├── naming_patterns.md ├── compression_guide.md └── file_types.md

## 🔧 Feature Details

### 1. Batch File Rename
- **Supported Modes**:
  - Sequence mode: `file_001.jpg`, `file_002.jpg`
  - Date mode: `20240302_photo1.jpg`
  - Prefix/suffix add: `backup_file.docx`, `file_copy.pdf`
  - Batch replace: `old_name` → `new_name`

### 2. Batch Image Compression
- **Supported Formats**: JPEG, PNG
- **Compression Options**:
  - Quality levels: High (90%), Medium (70%), Low (50%)
  - Size adjustment: Original size, 50%, 30%
  - Batch processing: Supports 1000+ files

### 3. Batch to PDF
- **Supported Source Files**:
  - Image files (JPG, PNG, BMP, etc.)
  - Text files (TXT, MD)
  - Office documents (requires additional tools)

- **Categorization Rules**:
  - 📄 Documents: .doc, .docx, .pdf, .txt, .md
  - 🖼️ Images: .jpg, .jpeg, .png, .bmp, .gif
  - 🎵 Audio: .mp3, .wav, .aac
  - 🎥 Video: .mp4, .avi, .mkv
  - 📦 Archives: .zip, .rar, .7z
  - 📁 Others: Remaining files

## 🎨 Skill Icon
- Recommended icons: Folder/Tool type icons
- Color scheme: Blue tones (professional & reliable) + Green (efficiency boost)

- ?? Organize large amounts of photos downloaded from phone
- 📊 Process batches of work documents
- 🛒 Shop owners organizing product images
- 🎓 Students organizing study materials
- 💼 Professionals improving office efficiency

## ⚙️ Technical Implementation
- **Platform**: Windows (most compatible)
- **Dependencies**: Python 3.8+, Pillow, PyPDF2, pdfkit (optional)
- **Security**: Runs locally, no network requests, no data uploads

## 📝 Precautions
- Backup important files before processing
- Large batch processing may take time
- Test with small samples when compressing images

## 📚 References
- [naming_patterns.md] - Detailed naming patterns guide
- [compression_guide.md] - Image compression technical guide
- [file_types.md] - File type identification rules

> 💡 Tip: This skill is designed to be "out-of-the-box" ready, easy for beginners to use, and an essential efficiency tool for professionals, students, and shop owners!
## 📦 Version Information
- **Current Version**: 1.0.0
- **Release Date**: 2026-03-03
- **Release Platform**: [ClawHub](https://clawhub.com/skills/file-batch-processor)
- **Author**: lx19840614

## 📝 Changelog
### v1.0.0 (2026-03-03) - Initial Version
- ✅ Batch file rename (5 modes)
- ✅ Batch image compression (quality/size adjustable)
- ✅ Batch convert to PDF (images/text)
- ✅ Auto file organization (6 categories)
- ✅ Preview mode (--dry-run)
- ✅ Windows optimized
- ✅ Complete documentation (README + video script + promotion plan)
### 📋 Planned Updates
- [ ] Chinese font PDF support
- [ ] Batch backup function
- [ ] Progress bar display
- [ ] GUI graphical interface
- [ ] macOS/Linux support