← Back to Skills Marketplace
albionaiinc-del

Fileclean

by albionaiinc-del · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
85
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install fileclean
Description
Removes dates, hashes, UUIDs, and extra symbols from filenames to create clean, readable file names.
README (SKILL.md)

FileClean

Cleans filename clutter by removing date timestamps, hashes, UUIDs, and excessive symbols, transforming messy filenames like report_20230101_a1b2c3d.pdf into clean, readable ones like Report.pdf.

Usage

Preview changes:

python fileclean.py ~/Downloads ~/Documents --skip-ext pdf jpg

Apply changes:

python fileclean.py myfile.txt --rename

Price

$2.75

Usage Guidance
This appears to be a simple filename-cleaning script. Before installing or running it: 1) Note the SKILL.md examples call fileclean.py but the repository contains tool.py — invoke the provided script (python tool.py) or rename it appropriately. 2) Run in preview mode (no --rename) first to verify planned changes. 3) Test on a small copy of files or a safe directory to confirm the regex behavior and capitalization meet your expectations. 4) Be aware renaming is done in-place and the script doesn't check for name collisions — backups are recommended to avoid accidental overwrite or data loss. 5) The inclusion of a price line in SKILL.md is informational only; it has no technical effect. If you want higher assurance, ask the author to fix the filename mismatch and to add collision detection or a dry-run/backup option.
Capability Analysis
Type: OpenClaw Skill Name: fileclean Version: 1.0.0 The skill is a straightforward utility for cleaning filenames by removing timestamps, UUIDs, and hex strings. The implementation in tool.py uses standard Python libraries (os, re, argparse) and performs only the file renaming actions described in SKILL.md, with no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
The code (tool.py) implements filename cleaning (removing timestamps, hex strings, UUIDs, separators) which matches the declared purpose. There are no unrelated environment variables, binaries, or external services requested. Minor mismatch: SKILL.md examples call python fileclean.py but the included script is tool.py.
Instruction Scope
Runtime instructions stay within the stated purpose (preview then rename). However SKILL.md references a different filename (fileclean.py) than the included tool (tool.py). Also the script operates non-recursively (os.listdir) and will rename files in place; name collisions during rename could overwrite files — the tool does not appear to check for existing destination filenames or provide collision avoidance.
Install Mechanism
No install spec or network downloads; the skill ships a small Python script. This is low-risk from an install perspective.
Credentials
No environment variables, credentials, or config paths are requested. The tool only accesses local filesystem paths provided as arguments, which is proportionate to its purpose.
Persistence & Privilege
The skill does not request permanent presence, does not modify other skills or system-wide configs, and has normal, on-demand invocation behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install fileclean
  3. After installation, invoke the skill by name or use /fileclean
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of FileClean. - Cleans filenames by removing date stamps, hashes, UUIDs, and excess symbols. - Transforms cluttered filenames into clean, readable formats. - Supports preview and direct renaming via command-line options. - Allows skipping specified file extensions.
Metadata
Slug fileclean
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Fileclean?

Removes dates, hashes, UUIDs, and extra symbols from filenames to create clean, readable file names. It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.

How do I install Fileclean?

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

Is Fileclean free?

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

Which platforms does Fileclean support?

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

Who created Fileclean?

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

💬 Comments