← Back to Skills Marketplace
albionaiinc-del

Clean Filenames

by albionaiinc-del · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
74
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clean-filenames
Description
Removes invalid characters and normalizes whitespace in filenames for safe, consistent, and cross-platform compatible file naming.
README (SKILL.md)

Clean Filenames

Strips invalid characters, normalizes whitespace, and safely renames files to ensure cross-platform compatibility and professional organization.

Usage

# Clean files in current directory
clean_filenames

# Clean files in specific directory
clean_filenames ~/Documents/Downloads

# Recursively clean all subdirectories
clean_filenames ~/Photos -r

# Clean a single file
clean_filenames "broken file name: 2023?.jpg"

Price

$2.50

Usage Guidance
This skill appears to do only local filename sanitization and contains no networking or credential access. Before installing or running it: (1) test it in a safe directory or on copies of files (it will rename files and skip conflicts), (2) back up important files in case names change in unexpected ways, and (3) note that SKILL.md references a 'clean_filenames' command while the package provides tool.py — you may need to run the script directly or create a small wrapper/installation if you want a named CLI.
Capability Analysis
Type: OpenClaw Skill Name: clean-filenames Version: 1.0.0 The skill is a straightforward utility for sanitizing filenames to ensure cross-platform compatibility. The Python script (tool.py) uses standard libraries to replace invalid characters and normalize whitespace, including safety checks to prevent file overwriting. There are no signs of data exfiltration, malicious execution, or prompt injection in SKILL.md.
Capability Assessment
Purpose & Capability
Name and description match the included tool.py which sanitizes and renames filenames; there are no unexpected environment variables, binaries, or external services required.
Instruction Scope
SKILL.md usage examples describe running a local CLI to clean filenames; the runtime instructions and the code operate only on local file paths. Minor note: SKILL.md refers to a command named 'clean_filenames' while the distributed file is tool.py (no install spec), so users may need to run the script directly or install a wrapper — this is an operational mismatch but not a security concern.
Install Mechanism
No install specification is provided (instruction-only with an included tool.py). Nothing is downloaded or extracted from external URLs.
Credentials
The skill requests no environment variables, credentials, or config paths — consistent with a local file-renaming utility.
Persistence & Privilege
always is false and the skill does not attempt to modify other skills or system-wide settings. It only performs local file operations when invoked.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clean-filenames
  3. After installation, invoke the skill by name or use /clean-filenames
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Clean Filenames. - Strips invalid characters and normalizes whitespace in file names. - Safely renames files for cross-platform compatibility. - Supports directories, recursive cleaning, and single-file cleaning. - Simple command-line interface with flexible options. - Available for $2.50.
Metadata
Slug clean-filenames
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Clean Filenames?

Removes invalid characters and normalizes whitespace in filenames for safe, consistent, and cross-platform compatible file naming. It is an AI Agent Skill for Claude Code / OpenClaw, with 74 downloads so far.

How do I install Clean Filenames?

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

Is Clean Filenames free?

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

Which platforms does Clean Filenames support?

Clean Filenames is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Clean Filenames?

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

💬 Comments