file-backup-organizer

Intelligent file backup and organizer. Recursively scans folders, categorizes files by type, supports filtering/exclusion, handles duplicates, and generates...

Security Scan

The skill's code and instructions are consistent with an offline file backup/organizer tool that uses only the Python standard library; no network access, credentials, or risky installs are requested.

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.

Assessment

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.

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
PDF	.pdf
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 names
• exclusion_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).