← Back to Skills Marketplace
File Organizer
by
akira82-ai
· GitHub ↗
· v0.1.0
· MIT-0
207
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install smart-file-organizer
Description
基于 AI 语义分析的智能文件整理技能,根据文件内容动态创建 Johnny Decimal 分类。 当用户提到以下内容时触发: - "整理文件"、"分类文件"、"组织下载"、"文件归档" - "文件太多了"、"下载文件夹很乱"、"文件乱七八糟" - "把文件按类别整理"、"自动分类文件" - "清理下载文件夹"、...
Usage Guidance
This skill appears to do what it says: it will ask you for a source and target directory, show a classification plan, and only move or delete files after you confirm. Before installing/using it: 1) back up important files (especially if you plan to allow automatic deletion of duplicates); 2) ensure python3 is available (scripts/check_duplicates.py is used for duplicate detection/deletion); 3) note the small doc inconsistencies (README says 'zero scripts' but a Python script exists) and minor bugs (the duplicate-deletion reporting prints an undefined variable and may raise a runtime error when deletion mode is used); 4) prefer absolute paths and review the proposed classification plan carefully — the bash listing/counting approach can mis-handle unusual filenames (e.g., names with newlines); 5) confirm the target is not the same as the source and that you have write permission to the target. If you want higher assurance, inspect scripts/check_duplicates.py locally before running deletion options.
Capability Analysis
Type: OpenClaw Skill
Name: smart-file-organizer
Version: 0.1.0
The skill is a legitimate file organization tool that uses AI to categorize files according to the Johnny Decimal system. It utilizes standard Bash commands (ls, mkdir, mv) and a local Python script (scripts/check_duplicates.py) for file management and MD5-based duplicate detection. The instructions in SKILL.md explicitly require the agent to obtain user confirmation via AskUserQuestion before moving files or deleting duplicates, and there is no evidence of data exfiltration, obfuscation, or unauthorized network activity.
Capability Assessment
Purpose & Capability
The name/description (AI-based file organizer using Johnny Decimal) aligns with the included instructions and the single helper script (duplicate detection). The skill only requires local source/target directory access and uses python3 for MD5 checks — reasonable for this purpose. Minor documentation inconsistency: README claims '零脚本 / 纯 Bash' while a Python script (scripts/check_duplicates.py) is included; numbering format examples also vary (01-01 vs 10.01) but these are documentation issues, not security mismatches.
Instruction Scope
SKILL.md restricts actions to scanning the specified source and target directories, generating a classification preview, asking the user for confirmation via AskUserQuestion, creating target subdirectories, moving files, and optionally running the included duplicate-checker. It does not access network endpoints, other system credentials, or arbitrary config paths. Notes: some bash usage (ls parsing, wc -l) can mis-handle filenames with newlines; the skill explicitly waits for user confirmation before destructive moves and before deletion of duplicates.
Install Mechanism
No install spec; instruction-only skill with one bundled Python script. No downloads from external URLs or package installation steps. This minimizes install-time risk.
Credentials
No environment variables, credentials, or config paths are requested. The skill requires filesystem write access to the chosen target directory (expected and proportional).
Persistence & Privilege
always:false and no persistent or cross-skill configuration changes. The skill does file operations only when invoked and after explicit user confirmation, so it does not request elevated persistent privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install smart-file-organizer - After installation, invoke the skill by name or use
/smart-file-organizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Smart File Organizer v1.0.0 provides AI-powered, interactive file sorting by content with dynamic Johnny Decimal classification.
- Uses AI to analyze file names and generate categories using the Johnny Decimal system (XX-YY format).
- Interactive workflow: confirms source and target directories with the user before acting.
- Displays a clear, adaptive classification plan (full or summarized) and always asks for confirmation.
- Automatically detects duplicate files using MD5; offers options for duplicate handling.
- Creates categorized directories and organizes files accordingly, supporting both Chinese and English names.
- Requires explicit user approval before making changes.
Metadata
Frequently Asked Questions
What is File Organizer?
基于 AI 语义分析的智能文件整理技能,根据文件内容动态创建 Johnny Decimal 分类。 当用户提到以下内容时触发: - "整理文件"、"分类文件"、"组织下载"、"文件归档" - "文件太多了"、"下载文件夹很乱"、"文件乱七八糟" - "把文件按类别整理"、"自动分类文件" - "清理下载文件夹"、... It is an AI Agent Skill for Claude Code / OpenClaw, with 207 downloads so far.
How do I install File Organizer?
Run "/install smart-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 akira82-ai (@akira82-ai); the current version is v0.1.0.
More Skills