← 返回 Skills 市场

Downloads Folder Organizer

Name: Downloads Folder Organizer
Author: xuxinyuan2019

作者 XuXinyuan2019 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

177

总下载

当前安装

版本数

在 OpenClaw 中安装

/install downloaded-file-organizer

功能描述

Organize files from the Downloads folder into appropriate local directories

使用说明 (SKILL.md)

Organize files from the Downloads folder into appropriate local directories.

Steps

1. Check configuration

Run:

python3 ~/.claude/skills/organize/organizer.py --scan 2>&1

If the output contains "error": "config_missing", first run setup interactively:

python3 ~/.claude/skills/organize/organizer.py --setup

Default target root is ~/Documents, default downloads dir is ~/Downloads.

Then re-run --scan.

2. Display dry-run plan

Parse the JSON array returned by --scan and display it as a table:

Filename	Destination	Reason	Notes
...	...	...	Renamed (if conflict)

target_subdir is the subdirectory relative to target root
renamed: true means the file will be renamed to avoid conflict
If the plan is empty, tell the user there are no files to organize

3. Ask for confirmation

Say: "The plan above covers N file(s). Reply confirm to proceed, or tell me what to adjust."

If the user confirms: proceed to step 4
If the user requests changes: adjust the plan (modify target_subdir and final_target fields accordingly), show the updated table, and ask again
If the user cancels: stop

4. Execute

Pass the (possibly modified) plan JSON back to the script:

python3 ~/.claude/skills/organize/organizer.py --execute '\x3CJSON>'

Display results:

How many files were moved successfully
Any errors
Mention that the log is saved at ~/.claude/skills/organize/logs/ and the index is updated at ~/.claude/skills/organize/index.md

5. Offer watch mode

Ask: "Would you like to enable watch mode? New files in your downloads folder will be organized automatically (stops when the terminal is closed)."

If yes:

python3 ~/.claude/skills/organize/organizer.py --watch

Notes

Script location: ~/.claude/skills/organize/organizer.py
Config: ~/.claude/skills/organize/config.json
Logs: ~/.claude/skills/organize/logs/YYYY-MM-DD.log
Index: ~/.claude/skills/organize/index.md
The script requires watchdog for watch mode: pip install watchdog

Configurable fields in config.json

Field	Description
`target_root`	Root directory where files are moved into
`downloads_dir`	Directory to scan for new files
`rules`	Keyword-based classification rules (array of `{keywords, target, reason}`)
`extension_fallbacks`	Extension-based fallback rules (array of `{extensions, target, reason}`)
`ignored_filenames`	Filenames to skip (case-insensitive), e.g. `desktop.ini`
`ignored_prefixes`	Filename prefixes to skip, e.g. `.` and `$`
`skip_dirs`	Directories excluded from index generation

安全使用建议

This skill appears to do what it says: it will inspect files (up to ~2KB of content) to classify them, move files from your configured Downloads folder into target folders, and write logs/index files under ~/.claude/skills/organize. Before running: (1) review organizer.py yourself if you don't fully trust the source, (2) run the --scan dry-run and carefully inspect the generated plan, (3) back up important files or test with a disposable downloads folder, (4) note that 'strings' (system utility) may be invoked for binary files and 'watchdog' is required for watch mode (pip install watchdog), and (5) only enable watch mode if you want automatic, ongoing file moves. If you want stronger guarantees, run the script in a controlled environment or with a test config first.

功能分析

Type: OpenClaw Skill Name: downloaded-file-organizer Version: 1.0.0 The skill is a legitimate file organization utility that moves files from a downloads folder to categorized subdirectories based on filename or content analysis. It uses standard Python libraries (shutil, pathlib) and the 'strings' utility via subprocess for classification, with appropriate safety measures like timeouts and error handling. No evidence of data exfiltration, malicious execution, or prompt injection was found; the script even includes safeguards to skip hidden files and sensitive directories like .git or venv.

能力评估

✓ Purpose & Capability

The name/description (Downloads Folder Organizer) align with the included code and SKILL.md: the script scans a downloads directory, classifies files, moves them into a target root, writes logs and an index, and optionally watches for new files. No unrelated credentials, services, or binaries are required by the metadata.

ℹ Instruction Scope

The runtime instructions stay within the stated purpose: they run the included script to --scan, show a dry-run plan, ask for explicit user confirmation, then --execute or enable --watch. The script will read up to ~2048 bytes of file content for classification (and may invoke the system 'strings' utility for binaries), will move files out of Downloads, and will write logs/index files under ~/.claude/skills/organize. This is expected for this tool, but users should be aware the script reads file contents (privacy) and performs destructive actions (moves files).

✓ Install Mechanism

No install spec; the skill is instruction-only with the script included. No remote downloads or third-party package installs are dictated by the SKILL.md (watch mode suggests installing the well-known 'watchdog' package via pip). No high-risk external URLs or extracted archives are used.

✓ Credentials

The skill requires no environment variables, credentials, or config paths beyond its own config/log/index under ~/.claude/skills/organize. That is proportionate to the stated function.

ℹ Persistence & Privilege

always:false (default). The skill can be invoked autonomously by the agent (disable-model-invocation:false) which is normal. Enabling watch mode starts a long-lived process that auto-organizes new downloads when the user agrees; this is expected but users should explicitly opt in and be aware of the persistent filesystem activity and logs in their home directory.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install downloaded-file-organizer
安装完成后，直接呼叫该 Skill 的名称或使用 /downloaded-file-organizer 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release of "organize" skill to sort files from 'Downloads' folder into appropriate local directories. - Interactive CLI setup with configurable target root and downloads directory. - Dry-run planning: shows which files will be moved, where, and why, with table display and rename handling for conflicts. - User can confirm, modify, or cancel the organization plan before execution. - Moves files and saves a log and an updated index for reference. - Optional "watch mode" to automatically organize new files as they arrive. - Configuration and rules easily adjustable in config.json.

元数据

Slug downloaded-file-organizer

版本 1.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 1

常见问题