Xpersona
F

File Organizer Skill

CLAWHUB · Unverified

Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities. Skill: File Organizer Skill Owner: 1999azzar Summary: Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-02-12T23:26:34.313Z | auto - Initial release of the File Organizer skill. - Organize files by extension (default) or by date (year/month). - Supports dry run mode to pre

62
Rank
84
Safety
13k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 12.7K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17bnq7bcwrm6mwmx7ryseen81885fxg:file-organizer-skill
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-1999azzar-file-organizer-skill-er-skill-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

4,620 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: file-organizer-skill
description: Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities.
---

# File Organizer (Gold Standard)

## Features
- **Smart Sorting**: Group by Extension (Default) or Date (Year/Month).
- **Safety**: Conflict resolution (auto-rename), Dry Run mode, and Undo capability.
- **Deep Clean**: Recursive scanning option.
- **Audit**: Generates `organize_history.json` for tracking.

## Usage

### Basic Sort (by Extension)
```bash
python3 scripts/organize.py /path/to/folder
```

### Date Sort (Year/Month)
Great for photos or archives.
```bash
python3 scripts/organize.py /path/to/folder --date
```

### Dry Run (Simulate)
See what *would* happen without moving anything.
```bash
python3 scripts/organize.py /path/to/folder --dry-run
```

### Undo
Revert changes using the history file.
```bash
python3 scripts/organize.py --undo /path/to/folder/organize_history.json
```

## Config
Modify `scripts/organize.py` `get_default_mapping()` to add custom extensions.

_meta.json

{
  "ownerId": "kn75beh7fdqwjqc7rd6q1fnk2x81082h",
  "slug": "file-organizer-skill",
  "version": "1.0.0",
  "publishedAt": 1770938794313
}

references/categories.md

# File Categories Reference

This reference provides a mapping of common file extensions to their respective categories/folders.

## Default Mappings

- **Images**: .jpg, .jpeg, .png, .gif, .bmp, .svg, .webp, .tiff
- **Documents**: .pdf, .doc, .docx, .txt, .rtf, .odt, .xls, .xlsx, .ppt, .pptx, .csv
- **Audio**: .mp3, .wav, .flac, .aac, .ogg, .m4a
- **Video**: .mp4, .mkv, .mov, .avi, .wmv, .flv, .webm
- **Archives**: .zip, .tar, .gz, .7z, .rar, .bz2
- **Code**: .py, .js, .ts, .html, .css, .cpp, .c, .h, .java, .go, .rs, .sh, .json, .yml, .yaml, .md
- **Executables**: .exe, .bin, .msi, .appimage, .deb, .rpm
- **Fonts**: .ttf, .otf, .woff, .woff2

skill-card.md

## Description:

Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities.

This skill is ready for commercial/non-commercial use.

## Publisher:

[1999azzar](https://clawhub.ai/user/1999azzar)

### License/Terms of Use:


## Use Case:

Developers and external users can use this skill to organize a chosen local directory by file extension or modification date, preview file moves, run recursive organization, and undo prior organization runs from a history file.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The local organizer script moves files in the selected directory, and recursive mode can affect nested files.

Mitigation: Run dry-run first, target only directories you explicitly choose, and avoid recursive mode on broad or sensitive folders.

Risk: Undo mode can move arbitrary files when supplied with an untrusted history JSON file.

Mitigation: Use --undo only with an organize_history.json file that you created and inspected.

## Reference(s):

- [File Categories Reference](references/categories.md)

## Skill Output:

**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]

**Output Format:** [Markdown with inline shell commands and Python script guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Produces local file-move guidance and command examples; the bundled script can write organize_history.json for audit and undo.]

## Skill Version(s):

1.0.0 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Sponsored

Ads related to File Organizer Skill and adjacent AI workflows.