← Back to Skills Marketplace
File Organizer
by
New Age Investments
· GitHub ↗
· v1.0.0
· MIT-0
125
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nai-file-organizer
Description
Scan, deduplicate, and organize files in a directory by type, generating a dry-run plan before optionally moving files without deleting anything.
Usage Guidance
This skill appears coherent and implements the described functionality locally. Before running any execution step that moves files: 1) Always run the dry-run (default) and inspect the generated plan/plan.json; 2) Do not run with --execute --yes until you have reviewed the plan — the --yes flag skips confirmation and will let the script move files; 3) Consider running scans against a small test directory first to confirm behavior; 4) Make a backup (or ensure files are in a recoverable state) if you plan to move large or important collections; 5) If you need different category mappings, review or edit references/categories.md before executing. If you want extra assurance, manually review the bundled scripts (they are included) — they perform local filesystem operations only and do not contact external services.
Capability Analysis
Type: OpenClaw Skill
Name: nai-file-organizer
Version: 1.0.0
The skill bundle is a legitimate file management utility designed to scan, deduplicate, and organize files into categorized folders. The Python scripts (scan.py, find_duplicates.py, organize.py, manifest.py) use standard libraries like os, shutil, and hashlib, and lack any network capabilities, obfuscation, or execution of external commands. Safety features are explicitly implemented, such as a mandatory dry-run mode by default, the absence of file deletion logic, and clear instructions in SKILL.md for the agent to seek user confirmation before moving files.
Capability Assessment
Purpose & Capability
Name/description align with included scripts. All required actions (scanning, hashing, duplicate detection, planning, moving, manifest generation) are implemented locally; no unrelated credentials, binaries, or network endpoints are requested.
Instruction Scope
SKILL.md instructs the agent to scan local directories and run included Python scripts — exactly the expected scope. The scripts can move (not delete) files when run with --execute; dry-run is the default. Be aware that an agent or user could explicitly pass --execute --yes to perform moves without an interactive prompt.
Install Mechanism
No install spec or external downloads; this is an instruction-only skill with bundled Python scripts. Nothing is pulled from remote URLs or package registries.
Credentials
The skill requests no environment variables, credentials, or config paths. All file and path access is limited to directories the user supplies to the scripts.
Persistence & Privilege
The skill is not always-enabled and does not modify other skills or global agent settings. It can be invoked autonomously (platform default), but it does not request elevated persistence or special privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nai-file-organizer - After installation, invoke the skill by name or use
/nai-file-organizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of file-organizer.
- Scans directories, categorizes files by type, finds duplicates, and generates or executes an organization plan.
- Dry-run by default—always shows a summary plan before moving any files.
- Never deletes files; only moves them and skips symlinks or hidden files (unless specified).
- Provides inventory and before/after manifest reports in markdown.
- All scripts are standalone Python 3 with no third-party dependencies.
Metadata
Frequently Asked Questions
What is File Organizer?
Scan, deduplicate, and organize files in a directory by type, generating a dry-run plan before optionally moving files without deleting anything. It is an AI Agent Skill for Claude Code / OpenClaw, with 125 downloads so far.
How do I install File Organizer?
Run "/install nai-file-organizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is File Organizer free?
Yes, File Organizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does File Organizer support?
File Organizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created File Organizer?
It is built and maintained by New Age Investments (@newageinvestments25-byte); the current version is v1.0.0.
More Skills