Rename File Skill

This skill renames all files in a specified directory by adding a prefix to each filename. It shows a preview of changes and asks for user confirmation before executing the rename operation.

When to use this skill

Use this skill when:

• - User wants to batch rename files in a directory
• User needs to add a consistent prefix to multiple files
• User wants to preview changes before applying them
• User wants a safe, interactive file renaming tool

Prerequisites

The skill uses a JavaScript script for file operations, which requires Node.js to be installed.

Implementation steps

1. Ask for user inputs

Use AskUserQuestion to get:

1. 1. Prefix: What prefix should be added to the filenames?
2. Directory path: Which directory contains the files to rename? (Enter absolute or relative path)
3. Confirmation: Show preview and ask for confirmation before proceeding

Example AskUserQuestion call for prefix and directory:

CODEBLOCK0

2. Process user inputs

After getting answers:

• - Prefix: Use the user-provided prefix (sanitize if needed)
• Directory path:

3. Generate preview

Read the directory contents and generate a preview of rename operations:

• - List all files (excluding directories) in the target directory
• Show current filename → new filename mapping
• Count total files to be renamed

Display the preview to the user and ask for confirmation:

CODEBLOCK1

4. Execute rename operation

If user confirms, run the JavaScript rename script:

CODEBLOCK2

5. Display results

Show the user:

• - Number of files successfully renamed
• Any errors encountered
• Summary of changes made

Script details

The JavaScript script (scripts/rename-files.js):

1. 1. Validates the directory exists and is accessible
2. Reads all files in the directory (excluding subdirectories)
3. For each file, constructs new filename by prepending the prefix
4. Performs the rename operation using INLINECODE2
5. Handles errors gracefully (e.g., permission issues, duplicate names)
6. Returns success/failure status

Error handling

• - If directory doesn't exist or is not accessible, show error and abort
• If no files found in directory, inform user and exit
• If a file with the new name already exists, skip that file and report
• If permission denied for any file, skip and report error
• Rollback on critical errors (optional, can be implemented)

Safety features

• - Always shows preview before making changes
• Asks for explicit confirmation
• Skips directories (only renames files)
• Preserves file extensions
• Reports all operations for transparency

Usage example

CODEBLOCK3