An intelligent file management tool that uses AI semantic analysis to categorize files into a structured Johnny Decimal system.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install smart-file-organizer
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install smart-file-organizer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is AI File Organizer (Johnny Decimal System)?
The AI File Organizer is a sophisticated skill designed to transform cluttered directories into perfectly structured repositories. By leveraging AI semantic analysis, it understands the content and context of your filenames—regardless of extension—and dynamically creates a hierarchical Johnny Decimal numbering system (XX.YY). This tool is essential for developers and power users who want to maintain a professional file structure automatically.
As part of the growing ecosystem of Openclaw Skills, it bridges the gap between chaotic downloads and an organized digital archive. It prioritizes existing directory structures when available, ensuring that your automated organization remains consistent with your previous manual efforts.
AI File Organizer (Johnny Decimal System) Use Cases
- Organizing messy Downloads folders into structured archives
- Transitioning project files to a Johnny Decimal numbering system
- Consolidating scattered documents into semantic categories
- Cleaning up workspace directories by grouping related scripts and assets
- Automated deduplication of files during migration tasks
How AI File Organizer (Johnny Decimal System) Works
- The skill identifies the source and target directories, prompting the user if they are not specified through the AskUserQuestion interface.
- it scans the target directory for any existing Johnny Decimal categories to ensure numbering consistency.
- Source files are analyzed using AI to determine semantic similarity based on filename context rather than just file extensions.
- A classification plan is generated, mapping files to specific XX.YY numbered categories (e.g., 01-01_AI_Tech).
- The system presents a visual summary (complete or collapsed based on file count) and waits for explicit user confirmation.
- Upon approval, it executes Bash commands to create the directory structure and move the files.
- An MD5-based duplicate check is performed via a Python script to identify and optionally handle redundant files.
AI File Organizer (Johnny Decimal System) Setup
To use this within your environment, ensure you have the necessary permissions for file system operations. This skill utilizes Bash for core movements and Python 3 for advanced duplicate detection.
# Ensure the duplicate detection script is available
ls scripts/check_duplicates.py
# Trigger the skill via natural language
# "Organize my ~/Downloads folder into ~/Documents/Archive"
This workflow is optimized for the Openclaw Skills framework, requiring no manual configuration of numbering rules as the AI handles the Johnny Decimal logic automatically.
AI File Organizer (Johnny Decimal System) Data Schema & Taxonomy
The skill organizes data using a strict taxonomic structure based on the Johnny Decimal System:
| Level | Format | Logic |
|---|---|---|
| Main Category | XX-YY | XX represents the broad domain (e.g., 01 for Technical, 02 for Business) |
| Sub Category | YY | Incremental sequence within the main domain |
| Folder Name | XX-YY_Name | The ID and the semantic name are separated by an underscore |
| File Integrity | MD5 | Files are hashed to identify duplicates across different categories |
AI File Organizer (Johnny Decimal System) Advanced Features
- Contextual Domain Mapping: Automatically increments the main category number (XX) when it detects a shift in thematic domain.
- Smart Summary Mode: For batches exceeding 30 files, the skill provides a collapsed summary view to prevent chat overflow while maintaining transparency.
- Priority Matching: If the target folder already contains Openclaw Skills formatted directories, the AI will prioritize fitting new files into existing categories.
- MD5 Deduplication: After moving files, the skill can automatically delete redundant copies while preserving the earliest version based on modification time.
- User-Controlled Adjustments: Users can choose to expand the full file list, adjust specific categories, or cancel the operation entirely before any disk changes occur.
SKILL.md
Loading
Related Openclaw Skills
Discount Impact Calculator
A sophisticated financial modeling tool that calculates the real commercial effect of discounts on margins, conversion, and acquisition costs.
Weather Litiao
A lightweight, no-API-key weather integration providing instant atmospheric data via simple curl commands.
Influencer Marketing Strategy Skill
A comprehensive AI agent skill designed to help teams plan, execute, and optimize influencer and creator marketing strategies for AI and SaaS products.
Xueersi Essay Correction Assistant
An advanced AI-driven assistant designed to grade, analyze, and provide structured feedback for Chinese language essays across all grade levels.
AuctionClaw: AI Agent Auction Gateway
AuctionClaw lets AI agents compete in real-time sealed-bid auctions to handle your tasks at the best possible price and quality.
Forget Something
A professional framework for implementing forgetting mechanisms to manage memory overload and data privacy in AI systems.
Featured*
