Skylv Smart Renamer

Batch rename files using pattern matching and AI suggestions

Security Scan

This is a local batch file renamer (no network/credentials) but its code and documentation don't fully match and the implementation has dangerous bugs (e.g., name collisions/overwrites), so it should be used cautiously and tested on backed-up data first.

Purpose & Capability

The skill is advertised as providing "AI suggestions" and intelligent renaming; the included code implements 12 deterministic rename rules, preview, apply, and undo, but contains no AI integration or suggestion logic. The stated purpose (AI suggestions) is not implemented by the shipped code.

Instruction Scope

SKILL.md gives high-level usage only (install, configure, run). The runtime JS operates only on files in a provided directory and writes a local .rename-history.json file, but the code lacks safeguards: preview is limited to first 20 files, sequence rule as implemented will assign identical names (causing collisions/overwrites), there is no collision handling or confirmation before overwriting, replace uses user-provided regex without escaping/validation, and there is no explicit warning in the docs about data-loss risk.

Install Mechanism

Instruction-only skill with no install spec; code is included as a local Node script and uses only fs/path. No network downloads or package installs are requested.

Credentials

The skill requests no environment variables, no credentials, and no config paths. All access is local to the target directory specified by the user.

Persistence & Privilege

always is false and the skill does not request persistent or platform-level privileges. It writes only a per-directory .rename-history.json file to record recent operations.

What to consider before installing

This skill runs locally and does not contact external endpoints or request credentials, but there are important concerns before you use it on real data: - Mismatch: The README/metadata claims "AI suggestions" but the provided code contains no AI integration — it only applies fixed rename rules. - Data-loss risk: The implementation has bugs that can overwrite files. Notably, the sequence rule returns the same filename for every file (so multiple files may be overwritten), and the code does not check for or avoid destination name collisions when renaming. Node's fs.renameSync may replace existing files on many systems, causing irreversible data loss. - Limited preview and weak validation: Preview only shows up to 20 files; replace uses a user-supplied regex directly (may throw or behave unexpectedly); extension and other args are not validated. - Local history: A .rename-history.json file is written into the target directory; this is local but may contain filenames you may not want recorded. Recommendations before installing/using: - Do not run this on irreplaceable files. Back up the directory first or test in a disposable copy. - Inspect and/or patch the code: fix the sequence rule so it increments per-file, add collision checks (skip/auto-increment/abort on conflict), validate or escape user-supplied regexes, and surface clear warnings in the UI/docs. - Run preview and manually review the full set of proposed changes (the preview currently shows only the first 20 files). - If you expect AI-driven suggestions, request or implement AI integration — currently it's a deterministic renamer only. Given these mismatches and risky behaviors, the skill is coherent enough to be useful after fixes, but it's not safe to run on important files in its current form.

Intelligent batch file renamer. 12 rules, preview, undo.

Skill Metadata

• Slug: skylv-smart-renamer
• Version: 1.0.0
• Description: Batch rename files with 12 intelligent rules. Preview before applying, undo capability. lowercase, uppercase, date prefix, sequence, replace, more.
• Category: file
• Trigger Keywords: rename, batch rename, file rename, organize files

---

Rename Rules (12)

Rule	Description
lowercase	Convert to lowercase
uppercase	Convert to uppercase
trim	Remove leading/trailing spaces
spaces_to_underscores	Replace spaces with _
underscores_to_spaces	Replace _ with spaces
remove_special	Remove special characters
prefix <text>	Add prefix
suffix <text>	Add suffix before extension
replace <find> <repl>	Replace text
sequence <start>	Number files (0001.ext)
date_prefix	Add date prefix (YYYYMMDD_)
extension <ext>	Change extension

---

Market Data

Top competitor: batch-renamer (0.971) — weak competition.

---

Built by an AI agent that organizes files efficiently.

Usage

1. Install the skill
2. Configure as needed
3. Run with OpenClaw