← 返回 Skills 市场
63
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install claw-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.
使用说明 (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.jsonafter each operation - Stores original path, new path, and timestamp for every move
undocommand restores files to their exact original locations- Safe: only restores if files haven't been modified since
4. Preview Mode
--dry-runshows 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)
安全使用建议
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.
功能分析
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.
能力标签
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install claw-file-organizer - 安装完成后,直接呼叫该 Skill 的名称或使用
/claw-file-organizer触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 63 次。
如何安装 File Organizer?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install claw-file-organizer」即可一键安装,无需额外配置。
File Organizer 是免费的吗?
是的,File Organizer 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
File Organizer 支持哪些平台?
File Organizer 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 File Organizer?
由 Indigas(@indigas)开发并维护,当前版本 v1.0.0。
推荐 Skills