← Back to Skills Marketplace
indigas

File Organizer

by Indigas · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
63
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install claw-file-organizer
Description
Automatically sort and rename files by type into structured folders with undo support, configurable filters, and dry-run preview for safe batch organization.
README (SKILL.md)

File Organizer Skill

Automatically sort, rename, and organize files into structured folders. Reduces chaos in Downloads and any directory with scattered files.

Quick Start

# Install the skill
npx clawhub install file-organizer

# Organize your downloads folder
"Organize my Downloads folder"

# Organize a specific directory
"Organize ~/Documents/projects"

# Undo the last organization
"Undo the last file organization"

Core Features

1. Automatic Sorting

Files are categorized into standard folders:

  • Images (images/) — JPG, PNG, GIF, SVG, WEBP, BMP, TIFF, ICO
  • Documents (documents/) — PDF, DOC, DOCX, TXT, RTF, ODT, PPT, PPTX, XLS, XLSX, PPT, ODP
  • Audio (audio/) — MP3, WAV, FLAC, OGG, AAC, M4A
  • Video (video/) — MP4, MKV, AVI, MOV, WEBM, FLV
  • Archives (archives/) — ZIP, TAR, GZ, 7Z, RAR, BZ2, XZ
  • Code (code/) — PY, JS, TS, HTML, CSS, MD, JSON, YAML, SH, BAT
  • Data (data/) — CSV, JSON, XML, SQL, DB, SQLITE, DAT
  • Executables (installers/) — EXE, MSI, DMG, APP, PKG, DEB, RPM, APK
  • Fonts (fonts/) — TTF, OTF, WOFF, WOFF2, FON
  • Other (other/) — uncategorized files

2. Smart File Renaming

  • Extracts dates from filenames (YYYY-MM-DD patterns) and places them in naming
  • Converts spaces to underscores for consistency
  • Strips special characters (preserving hyphens in compound names)
  • Handles duplicate names by appending _2, _3, etc.
  • Preserves original extension case (lowercased for consistency)

3. Undo / Restore

  • Generates a ORGANIZE_LOG.json after each operation
  • Stores original path, new path, and timestamp for every move
  • undo command restores files to their exact original locations
  • Safe: only restores if files haven't been modified since

4. Preview Mode

  • --dry-run shows what would change without moving files
  • Reports counts by category and renamed files
  • No disk writes in dry-run mode

Configuration

Edit config.yaml to customize:

source_dirs:
  - ~/Downloads

target_base: ~/organized-files
auto_sort: true
rename_pattern: "{name}_{date}"  # or "none" to skip renaming
max_file_size_mb: 500  # skip files larger than this
exclude_patterns:
  - "*.tmp"
  - "*.swp"
  - ".DS_Store"
  - "Thumbs.db"
log_file: ORGANIZE_LOG.json

File Type Patterns

Full mapping is in references/file-patterns.md. You can add custom mappings:

custom_types:
  - name: "Design Assets"
    folders: "design/"
    extensions: [AI, PSD, SKETCH, FIG, INDD]

Safety

  • Dry-run first: Always review changes before committing
  • Undo-safe: Every move is logged; full restore possible
  • Size limits: Skip large files to avoid moving heavy media
  • Exclude patterns: Configurable file filters to skip unwanted types
  • No data loss: Only moves files; never deletes

Integration

  • Works with any directory (Downloads, Documents, Desktop, project roots)
  • Integrates with cron-manager for periodic auto-organizing
  • Compatible with file-sync workflows
  • Output is compatible with cloud storage (consistent naming)
Usage Guidance
This skill appears to implement a sensible file organizer, but the docs and tests claim behaviors the code doesn't clearly provide. Before installing or running it with real data: (1) Review the full scripts (the main script was truncated in the manifest) to confirm it actually writes ORGANIZE_LOG.json after each run and implements the 'only restore if file unchanged' safety check the docs promise; (2) Run the script in --dry-run mode on a copy of a folder and verify the output; (3) Do not run a non-dry-run operation directly on important directories (Downloads/Desktop) without backing them up; (4) If you rely on undo, ensure the tool persists a properly structured log and that undo returns structured results (the tests expect a returned dict but the visible undo function prints and returns None); (5) If you need cron or cloud integration, add explicit, audited integration code rather than trusting the README's claims. These inconsistencies look like sloppy/incomplete implementation rather than malicious intent, but they do increase risk of unexpected file moves or loss if used blindly.
Capability Analysis
Type: OpenClaw Skill Name: claw-file-organizer Version: 1.0.0 The skill is a standard file management utility designed to categorize and rename files based on their extensions. Analysis of 'scripts/organize.py' shows transparent logic for moving files, implementing safety features such as dry-run mode, file size limits, and a JSON-based undo log for restoration. There is no evidence of network activity, data exfiltration, or malicious prompt injection in 'SKILL.md' or the supporting documentation.
Capability Tags
crypto
Capability Assessment
Purpose & Capability
Name/description match the code: the script sorts, renames, provides dry-run and undo functionality. However SKILL.md/README claim features that the visible script doesn't implement or fully support (e.g., automatic creation of ORGANIZE_LOG.json after each run, safety check that 'only restores if files haven't been modified since', and integration with cron-manager/cloud). Those claims are not present in the shown code.
Instruction Scope
Runtime instructions are limited to organizing directories and using dry-run/undo — appropriate for the purpose. But the instructions assert behaviors (persistent logging, modification-time checks before restore) that are not implemented in the visible code. The SKILL.md also suggests integrations (cron-manager, cloud) without code or config demonstrating those integrations.
Install Mechanism
No install spec (instruction-only + included scripts) — lowest install risk. There are no network downloads or unusual install steps in the manifest.
Credentials
No credentials, no environment variables, and no access to unrelated system config are requested. The skill only needs filesystem access (source/target paths), which is proportionate to its stated purpose.
Persistence & Privilege
The skill is not always-enabled and does not request elevated privileges. It writes logs and moves files within the filesystem (normal for this utility). No evidence it modifies other skills or global agent config.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install claw-file-organizer
  3. After installation, invoke the skill by name or use /claw-file-organizer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the file-organizer skill. - Automatically sorts files in a directory into categorized folders (images, documents, audio, etc.). - Renames files using consistent, configurable patterns, handling duplicates and extracting dates. - Supports undo/restore operations with logs to safely revert changes. - Includes preview mode (`--dry-run`) to review changes before applying. - Customizable via `config.yaml` for sources, naming, exclusions, and size limits. - Prioritizes safety: moves only, never deletes; skips large/unwanted files; full change logs kept.
Metadata
Slug claw-file-organizer
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is File Organizer?

Automatically sort and rename files by type into structured folders with undo support, configurable filters, and dry-run preview for safe batch organization. It is an AI Agent Skill for Claude Code / OpenClaw, with 63 downloads so far.

How do I install File Organizer?

Run "/install claw-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 Indigas (@indigas); the current version is v1.0.0.

💬 Comments