moneyclaw-smart-file-organizer

ReviewAudited by ClawScan on May 10, 2026.

Overview

This skill appears to be a local file organizer, but it can recursively move, rename, and delete files while its documentation overstates how safely those actions are controlled.

Install or run this only if you are comfortable with a script changing files on your machine. Start with --preview on a small test folder, make your own backup first, avoid sudo/admin mode, and do not run duplicate cleanup with deletion enabled until you have reviewed what it will remove.

Findings (4)

Artifact-based informational review of SKILL.md, metadata, install specs, static scan signals, and capability signals. ClawScan does not execute the skill or run runtime probes.

ConcernMedium Confidence
ASI02: Tool Misuse and Exploitation
What this means

Running the organizer on a broad folder could move, rename, or delete many files, including duplicates, without a separate visible deletion confirmation in the shown code path.

Why it was flagged

The script recursively walks the chosen directory and can delete duplicate files during a non-preview run. The documentation examples describe duplicate handling as detection/cleanup, but the visible default action is delete.

Skill content
for item in dir_path.rglob("*") ... if not preview and self.config["deduplicate"]["action"] == "delete":
                        item.unlink()
Recommendation

Use --preview first, run only on a small test folder, keep an external backup, and configure duplicate handling to move rather than delete unless you have manually reviewed the results.

What this means

Users may trust the tool more than they should and run destructive organization or duplicate cleanup commands without independent backups.

Why it was flagged

The README makes an absolute no-loss safety claim, while the included code contains non-preview file mutation and duplicate deletion behavior. The undo script also says deleted files cannot be directly undone.

Skill content
Q: 整理会丢失文件吗?
A: 不会。技能提供预览模式、自动备份和撤销功能,三重保障。
Recommendation

Treat the safety features as optional safeguards, not guarantees. Verify backup behavior before real use and do not rely on undo for deleted files.

What this means

If run with sudo/admin privileges, mistakes or unsafe paths could affect files that a normal user account could not modify.

Why it was flagged

The README suggests running the file organizer with elevated privileges for permission problems. That is not hidden, but it expands the tool's ability to alter protected files.

Skill content
sudo python3 scripts/organize.py --path /path/to/folder
Recommendation

Avoid sudo/admin execution unless absolutely necessary; instead, fix folder permissions or choose a user-owned directory.

What this means

Some documented commands may fail or may require unreviewed files if obtained from elsewhere.

Why it was flagged

The skill documentation references helper scripts that are not present in the provided file manifest, which contains only config_generator.py, organize.py, test_runner.py, and undo.py.

Skill content
python3 scripts/rename.py --path ./photos ...
python3 scripts/deduplicate.py --path . --delete
python3 scripts/clean.py --path ./project
Recommendation

Use only the included reviewed scripts, and separately review any missing helper scripts before running them.