← Back to Skills Marketplace
yushimohuang

file-batcher-tool

by yushimohuang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
330
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install file-batcher-tool
Description
Batch file operations (rename, convert, organize). Use when user says "rename files", "batch rename", "convert files", "organize files", or wants to process...
README (SKILL.md)

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 "\x3Cfolder>" "\x3Cpattern>"

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 "\x3Cfolder>" "\x3Cformat>"

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 "\x3Cfolder>"

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 "\x3Cfolder>"

Count Files

When user says: "count files in folder"

bash skills/file-batcher-1.0.0/scripts/batcher.sh count "\x3Cfolder>"

List Large Files

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

bash skills/file-batcher-1.0.0/scripts/batcher.sh large "\x3Cfolder>" [--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
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: file-batcher-tool Version: 1.0.0 The skill provides batch file management utilities but contains a shell injection vulnerability in the `find_large` function within `scripts/batcher.sh`. Specifically, the `$size` variable is used unquoted in a `find` command, which could allow for arbitrary command execution if the input is manipulated. While the tool's capabilities are aligned with its stated purpose, this lack of input sanitization in a shell-based tool poses a security risk.
Capability Assessment
ℹ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install file-batcher-tool
  3. After installation, invoke the skill by name or use /file-batcher-tool
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of file-batcher - Introduces batch operations for file renaming, image conversion, and organization by type. - Supports finding duplicate files, counting files, and listing large files in a folder. - Allows pattern-based renaming and basic image format conversions (jpg, png, webp, gif). - Provides command examples and clear response formats for each operation.
Metadata
Slug file-batcher-tool
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 330 downloads so far.

How do I install file-batcher-tool?

Run "/install file-batcher-tool" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is file-batcher-tool free?

Yes, file-batcher-tool is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does file-batcher-tool support?

file-batcher-tool is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created file-batcher-tool?

It is built and maintained by yushimohuang (@yushimohuang); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments