← Back to Skills Marketplace
Clean Filename
by
albionaiinc-del
· GitHub ↗
· v1.0.0
· MIT-0
76
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clean-filename
Description
Removes invalid characters and normalizes filenames for safe, cross-platform use in files and directories, with optional recursive cleaning.
README (SKILL.md)
Clean Filename
Removes invalid or unsafe characters from filenames and normalizes them for cross-platform use. Ideal for cleaning up messy file exports, downloads, or collaborative projects.
Usage
# Clean a single file
clean_filename "report:final?.txt"
# Clean all files in a directory (non-recursive)
clean_filename ./downloads/
# Clean recursively
clean_filename ./project/ --recursive
# See changes without applying
clean_filename ./data/ --dry-run
Price
$2.00
Usage Guidance
This skill appears coherent and limited to filename normalization. Before running it: (1) review the included tool.py (already provided) if you want to confirm behavior; (2) run with --dry-run first to verify changes; (3) test on a small sample directory or backup important files; (4) be cautious when giving recursive paths to avoid mass renames; and (5) ensure the agent only runs this on directories you intend to modify. There are no network calls or requested credentials in the package.
Capability Analysis
Type: OpenClaw Skill
Name: clean-filename
Version: 1.0.0
The skill bundle is a straightforward utility for cleaning and normalizing filenames. The code in tool.py uses standard Python libraries (os, re, argparse) to rename files by removing invalid characters and handling Windows reserved names, with no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the provided Python CLI (tool.py). Required capabilities are minimal and consistent: removing invalid characters, normalizing names, handling reserved Windows names, optional recursion and dry-run. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md usage examples match tool.py behavior (single file, directory, recursive, dry-run). The runtime instructions and code only operate on the filesystem paths the user supplies, skip hidden files/dirs, and print/rename as expected. Note: the tool performs in-place renames, so it will modify user files when not using --dry-run.
Install Mechanism
No install spec or external downloads; the implementation is included as a local Python script. There are no network calls, URL downloads, archives, or package installs in the package.
Credentials
No environment variables, credentials, or external service access are requested or used by the code. The script only reads the filesystem paths provided as arguments.
Persistence & Privilege
The skill is not force-installed (always: false) and does not request elevated platform privileges, but it does modify the filesystem by renaming files. Autonomous invocation is allowed by default (normal for skills); if you let an agent run this skill, it can rename any paths the agent is instructed to process.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clean-filename - After installation, invoke the skill by name or use
/clean-filename - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Clean Filename:
- Removes invalid or unsafe characters from filenames for cross-platform compatibility.
- Supports single files, all files in a directory, and recursive cleaning.
- Includes a dry-run mode to preview changes before applying.
- Simple command-line usage with clear examples provided.
- Priced at $2.00.
Metadata
Frequently Asked Questions
What is Clean Filename?
Removes invalid characters and normalizes filenames for safe, cross-platform use in files and directories, with optional recursive cleaning. It is an AI Agent Skill for Claude Code / OpenClaw, with 76 downloads so far.
How do I install Clean Filename?
Run "/install clean-filename" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Clean Filename free?
Yes, Clean Filename is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Clean Filename support?
Clean Filename is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Clean Filename?
It is built and maintained by albionaiinc-del (@albionaiinc-del); the current version is v1.0.0.
More Skills