file-batcher-tool

Batch file operations (rename, convert, organize). Use when user says "rename files", "batch rename", "convert files", "organize files", or wants to process...

Security Scan

The skill's code matches its stated purpose (batch file operations) but has a few concerning mismatches and data‑destructive behaviors (undeclared external dependency, no safeguards/backups) that you should review before use.

Purpose & Capability

The name/description align with the included bash script which implements rename, convert, organize, duplicates, count, and large-file commands. However the script requires the ImageMagick 'convert' binary (and other standard Unix tools) while the skill metadata lists no required binaries — a small but meaningful mismatch.

Instruction Scope

SKILL.md instructs the agent to run the script on arbitrary folders (including ~) which is expected for a file tool, but the script performs destructive actions (mv and rm) without confirmation or automatic backups (e.g., conversion removes originals). There are no explicit safeguards, prompts, dry-run mode, or warnings in the instructions — this increases risk of accidental data loss if invoked with an incorrect path or pattern.

Install Mechanism

No install spec (instruction-only plus bundled script). Nothing is downloaded or installed automatically, so there is no remote code-fetch risk from an installer. The included script will run if invoked.

Credentials

The skill declares no environment variables or credentials (appropriate). Still, it requires filesystem access (moves/deletes files) and an external binary ('convert') not listed in metadata. No unrelated credentials/config paths are requested.

Persistence & Privilege

always is false; the skill is user-invocable and does not request persistent/global privileges or modify other skills. Autonomous invocation is allowed (platform default) but not combined here with other red flags.

What to consider before installing

This skill appears to implement the promised file operations, but review and test before use. Specific recommendations: (1) Inspect scripts locally — they use mv and rm which will modify/delete files. (2) Run first in a safe test folder or with backups; don't point it at your home or root directory until you're sure. (3) Note ImageMagick 'convert' is required for image conversion (SKILL.md mentions it but the registry metadata doesn't list it). Install convert if you intend to use conversion, or skip that command. (4) If you need non‑destructive behavior, request a dry-run or modify the script to keep originals. If you want me to, I can (a) produce a safer modified script with dry-run/confirmation and backup options, or (b) walk through the script line‑by‑line explaining exactly what each command will do.

File Batcher

Batch file operations for efficient file management.

Commands

Batch Rename

When user says: "rename files in folder X", "batch rename with pattern Y"

bash skills/file-batcher-1.0.0/scripts/batcher.sh rename "<folder>" "<pattern>"

Patterns:

• prefix_* - Add prefix
• *_suffix - Add suffix
• img_### - Sequential numbering
• lowercase - Convert to lowercase
• uppercase - Convert to uppercase

Convert Images

When user says: "convert images to png", "convert folder to jpg"

bash skills/file-batcher-1.0.0/scripts/batcher.sh convert "<folder>" "<format>"

Supported: jpg, png, webp, gif

Organize by Type

When user says: "organize files by type", "sort files into folders"

bash skills/file-batcher-1.0.0/scripts/batcher.sh organize "<folder>"

Creates folders: images/, documents/, videos/, audio/, archives/

Find Duplicates

When user says: "find duplicate files"

bash skills/file-batcher-1.0.0/scripts/batcher.sh duplicates "<folder>"

Count Files

When user says: "count files in folder"

bash skills/file-batcher-1.0.0/scripts/batcher.sh count "<folder>"

List Large Files

When user says: "find large files", "show big files"

bash skills/file-batcher-1.0.0/scripts/batcher.sh large "<folder>" [--size 100M]

Examples

# Rename all photos with date prefix
bash skills/file-batcher-1.0.0/scripts/batcher.sh rename "./photos" "2026-03-10_###"

# Convert all images to PNG
bash skills/file-batcher-1.0.0/scripts/batcher.sh convert "./images" "png"

# Organize messy download folder
bash skills/file-batcher-1.0.0/scripts/batcher.sh organize "~/Downloads"

# Find files larger than 500MB
bash skills/file-batcher-1.0.0/scripts/batcher.sh large "~/Documents" --size 500M

Response Format

When renaming:

📁 Batch Rename Complete
   Folder: ./photos
   Renamed: 15 files
   Pattern: 2026-03-10_###

When organizing:

📁 Organization Complete
   images/: 23 files
   documents/: 8 files
   videos/: 3 files