Batch Rename Skill#

Purpose#

Provides powerful batch file renaming capabilities with multiple pattern support. Rename files with sequential numbers, find/replace text, add prefixes/suffixes, use regex patterns, filter by extension, and process subfolders recursively.

When to Use#

Use this skill when user wants to:

• Rename multiple files at once (批量重命名)
• Add sequential numbers to filenames
• Find and replace text in filenames
• Add date prefixes or other prefixes/suffixes
• Use regex patterns for complex renaming
• Filter files by extension before renaming
• Process files in subfolders recursively

Usage Workflow#

Step 1: Identify User's Rename Intent#

Ask the user (or infer from their request):

1. Target directory/folder path
2. Rename pattern type:
   • Sequential numbering: photo_{n}.jpg → photo_001.jpg
   • Find & replace: Replace specific text in filenames
   • Add prefix/suffix: Add date or other text
   • Regex pattern: For complex transformations
3. File extension filter (optional)
4. Whether to process subfolders recursively

Step 2: Construct Rename Command#

Use the scripts/batch_rename.py script with appropriate arguments:

bash

# Sequential numbering
python scripts/batch_rename.py --path "C:/folder" --pattern "number" --format "file_{n:03d}" --ext "jpg"

# Find and replace
python scripts/batch_rename.py --path "C:/folder" --pattern "replace" --find "old" --replace "new"

# Add prefix
python scripts/batch_rename.py --path "C:/folder" --pattern "prefix" --prefix "2026-" --ext "*"

# Add suffix
python scripts/batch_rename.py --path "C:/folder" --pattern "suffix" --suffix "_backup" --ext "*.txt"

# Regex pattern
python scripts/batch_rename.py --path "C:/folder" --pattern "regex" --regex "(\d+)" --replace "ID_$1"

# Recursive with extension filter
python scripts/batch_rename.py --path "C:/folder" --pattern "number" --format "doc_{n}" --ext "pdf" --recursive

Step 3: Execute Rename#

Run the command. The script will:

1. Scan the target directory
2. Apply filters (extension, recursive)
3. Perform renaming operations
4. Report results

Step 4: Report Results#

Present a summary showing:

• Number of files renamed successfully
• Any errors or skipped files
• Original → New name mappings for verification

Script Arguments Reference#

ArgumentDescriptionRequired--pathTarget directory pathYes--patternRename pattern: number, replace, prefix, suffix, regexYes--formatFormat string for numbering (e.g., file_{n:03d})For --pattern number``--findText to findFor --pattern replace``--replaceReplacement textFor --pattern replace``--prefixPrefix to addFor --pattern prefix``--suffixSuffix to addFor --pattern suffix``--regexRegular expression patternFor --pattern regex``--extFile extension filter (e.g., jpg, * for all)No (default: all)--recursiveProcess subfolders recursivelyNo

Examples#

Example 1: Add Sequential Numbers#

text

User: "把 photos 文件夹里的图片重命名为 IMG_001, IMG_002..."
Command: python scripts/batch_rename.py --path "C:/Users/12891/photos" --pattern number --format "IMG_{n:03d}" --ext "jpg"

Example 2: Find and Replace#

text

User: "把所有文件名里的 '_v1' 改成 '_final'"
Command: python scripts/batch_rename.py --path "C:/folder" --pattern replace --find "_v1" --replace "_final"

Example 3: Add Date Prefix#

text

User: "给所有文档加上日期前缀 2026-04-10"
Command: python scripts/batch_rename.py --path "C:/docs" --pattern prefix --prefix "2026-04-10_" --ext "docx"

Example 4: Regex to Normalize#

text

User: "把所有文件名的空格替换成下划线"
Command: python scripts/batch_rename.py --path "C:/folder" --pattern regex --regex "\s+" --replace "_"

Safety Notes#

• Always report what will be renamed before executing
• For subfolder operations, be extra careful and confirm the scope
• Use --ext filter to limit scope when possible
• Script uses os.rename() which may fail if file already exists at target name