← Back to Skills Marketplace
Downloads Folder Organizer
by
XuXinyuan2019
· GitHub ↗
· v1.0.0
· MIT-0
177
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install downloaded-file-organizer
Description
Organize files from the Downloads folder into appropriate local directories
README (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_subdiris the subdirectory relative to target rootrenamed: truemeans 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_subdirandfinal_targetfields 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
watchdogfor 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 |
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install downloaded-file-organizer - After installation, invoke the skill by name or use
/downloaded-file-organizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is Downloads Folder Organizer?
Organize files from the Downloads folder into appropriate local directories. It is an AI Agent Skill for Claude Code / OpenClaw, with 177 downloads so far.
How do I install Downloads Folder Organizer?
Run "/install downloaded-file-organizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Downloads Folder Organizer free?
Yes, Downloads Folder Organizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Downloads Folder Organizer support?
Downloads Folder Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Downloads Folder Organizer?
It is built and maintained by XuXinyuan2019 (@xuxinyuan2019); the current version is v1.0.0.
More Skills