← Back to Skills Marketplace
112
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install file-backup-organizer
Description
Intelligent file backup and organizer. Recursively scans folders, categorizes files by type, supports filtering/exclusion, handles duplicates, and generates...
README (SKILL.md)
file-backup-organizer v1.0.0 -- Intelligent File Backup & Organizer
Core Functions
| Feature | Description |
|---|---|
| Recursive Scan | Scans source folder and all subdirectories |
| Smart Categorization | Auto-classifies by extension (Word, Excel, PDF, Images, etc.) |
| Flexible Filtering | Supports excluding specific file types (e.g. .tmp, .log, .cache) |
| Duplicate Handling | Auto-appends sequential numbers to avoid overwriting |
| Detailed Reports | Generates backup inventory and deletion lists |
| Risk Warnings | Flags files that may break without directory structure |
How to Use
The main script is scripts/backup_files.py. It provides Python functions:
from scripts.backup_files import backup_files, organize_by_type
backup_files(source_path, exclude_extensions=None)
source_path: Source folder path (e.g. "D:\Projects")exclude_extensions: List of extensions to exclude (e.g. [".tmp", ".log"])- Returns: dict with success status, file counts, categories, backup directory
organize_by_type(source_path)
source_path: Source folder path- Returns: same as backup_files (without exclusion)
Execution
Run via Python:
python scripts/backup_files.py
Or import and call functions directly in your workflow.
Supported File Types
| Category | Extensions |
|---|---|
| Word | .doc, .docx, .docm, .odt, .rtf |
| Excel | .xls, .xlsx, .xlsm, .csv, .ods |
| PPT | .ppt, .pptx, .pptm, .ppsx |
| Images | .jpg, .jpeg, .png, .gif, .bmp, .webp, .svg, .psd |
| Videos | .mp4, .avi, .mkv, .mov |
| Audio | .mp3, .wav, .flac |
| Archives | .zip, .rar, .7z |
| Code | .py, .js, .html, .css, .java, .cpp, .php, .json, .xml |
| Text | .txt, .md, .log |
Output
Backup creates a folder named {source}_backup with:
- Subfolders per file type
backup_report.txt-- full inventory with file counts and namesexclusion_list.txt-- list of excluded files (only if exclude_extensions used)
Warnings
These file types may break without original directory structure:
- Web files: .html, .htm, .css, .js
- Server scripts: .php, .asp, .aspx, .jsp
- Config files: .json, .xml, .yaml, .ini
Such files are flagged in the backup report.
Dependencies
None -- uses Python standard library only (os, shutil, pathlib, collections, datetime).
Usage Guidance
This package appears to do what it claims (local file backup and organization) and uses only the Python standard library. Before installing/running: 1) note the documentation/code mismatch for backup folder and report filenames (the script uses Chinese filenames and a Chinese '_备份' suffix), so expect those names instead of the English ones in SKILL.md; 2) run it first on a small, non-sensitive test directory to verify behavior and output location; 3) be aware the script will copy any files readable by the process — do not point it at sensitive system or credential directories unless you intend to back them up; 4) because the tool runs locally with whatever file permissions the agent/process has, ensure the agent's runtime user has only the intended file access to avoid unintentional copying of secrets. If you want the filenames and backup-folder naming to match the English SKILL.md, inspect and (if acceptable) modify the script's naming strings before use.
Capability Analysis
Type: OpenClaw Skill
Name: file-backup-organizer
Version: 1.0.0
The skill bundle provides a legitimate file organization and backup utility that categorizes files by extension into subfolders. The implementation in `scripts/backup_files.py` uses standard Python libraries (os, shutil, pathlib) to perform recursive scans and file copies, including logic to handle filename collisions and generate summary reports. There is no evidence of data exfiltration, network activity, or unauthorized access to sensitive system directories.
Capability Assessment
Purpose & Capability
Overall the code implements the described recursive scan, categorization, exclusion, duplicate-handling, and report generation. Minor incoherences: SKILL.md states output filenames and an English-suffixed backup folder (e.g., '{source}_backup', 'backup_report.txt', 'exclusion_list.txt') but the implementation creates Chinese-named artifacts (e.g., '{source}_备份', '备份清单.txt', '删除清单.txt'). This is a localization/documentation mismatch but not evidence of malicious intent.
Instruction Scope
Runtime instructions are limited to running the provided Python script or importing its functions. The script only reads the user-supplied source_path and writes backups/reports to a sibling backup directory; it does not access other system configuration, environment variables, or network endpoints.
Install Mechanism
No install specification is provided and the code uses only Python standard library imports. Nothing is downloaded or written to system paths by an installer.
Credentials
The skill requests no environment variables or credentials. The script operates entirely on a path supplied by the user, which is appropriate for a file backup tool.
Persistence & Privilege
The skill is not marked always:true and does not modify other skills or system-wide agent settings. It performs only local file I/O scoped to the given source and backup directories.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install file-backup-organizer - After installation, invoke the skill by name or use
/file-backup-organizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
v1.0.0: initial ClawHub release, recursive scan + smart categorization + filtering + reports
Metadata
Frequently Asked Questions
What is file-backup-organizer?
Intelligent file backup and organizer. Recursively scans folders, categorizes files by type, supports filtering/exclusion, handles duplicates, and generates... It is an AI Agent Skill for Claude Code / OpenClaw, with 112 downloads so far.
How do I install file-backup-organizer?
Run "/install file-backup-organizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is file-backup-organizer free?
Yes, file-backup-organizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does file-backup-organizer support?
file-backup-organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created file-backup-organizer?
It is built and maintained by psyhl (@psyhl); the current version is v1.0.0.
More Skills