File Organizer

file-organizer

基于 AI 语义分析的智能文件整理技能，根据文件内容动态创建 Johnny Decimal 分类。

当用户提到以下内容时触发：

• "整理文件"、"分类文件"、"组织下载"、"文件归档"
• "文件太多了"、"下载文件夹很乱"、"文件乱七八糟"
• "把文件按类别整理"、"自动分类文件"
• "清理下载文件夹"、"整理文档"
• "文件管理"、"文件分类整理"
• 提到需要将文件从一个目录移动到

File Organizer

基于 AI 语义分析的智能文件整理技能，根据文件内容动态创建 Johnny Decimal 分类。

当用户提到以下内容时触发：

• "整理文件"、"分类文件"、"组织下载"、"文件归档"
• "文件太多了"、"下载文件夹很乱"、"文件乱七八糟"
• "把文件按类别整理"、"自动分类文件"
• "清理下载文件夹"、"整理文档"
• "文件管理"、"文件分类整理"
• 提到需要将文件从一个目录移动到

Overview

File Organizer is a comprehensive agent skill designed for data & ai workflows. It provides structured guidance and automation patterns that enable AI coding agents to handle file organizer tasks with precision and reliability across diverse project environments.

This skill encapsulates best practices gathered from production deployments and open-source communities. It covers the complete lifecycle from initial setup through advanced configuration, ensuring consistent results whether you are working on a greenfield project or integrating into an existing codebase.

Built by openclaw, this skill follows the open SKILL.md standard and is compatible with all major AI coding tools including Claude Code, Cursor, Windsurf, Codex CLI, and ChatGPT.

When to Use

Activate this skill when the user needs to:

Set up or configure file organizer in a new or existing project

Debug issues related to file organizer implementation

Follow best practices for data & ai workflows

Automate repetitive file organizer tasks

Review and improve existing file organizer configurations

Integrate file organizer with data pipelines and ML model training workflows

Core Capabilities

Automated Setup & Configuration

Generates complete configuration files with sensible defaults, proper directory structure, and environment-specific overrides. Includes inline documentation explaining each configuration choice and its tradeoffs.

Intelligent Code Generation

Produces idiomatic, production-ready code following established patterns and conventions. The generated code includes proper error handling, logging, type annotations, and test scaffolding out of the box.

Debugging & Troubleshooting

Systematically diagnoses common issues by analyzing error messages, log output, and configuration state. Provides step-by-step resolution guides with explanations of root causes to prevent recurrence.

Performance Optimization

Identifies bottlenecks and applies targeted optimizations based on measured data rather than assumptions. Tracks before/after metrics and documents the rationale behind each optimization decision.

Example Prompts

Users might ask:

"Set up file organizer for my project"

"Debug why file organizer is failing in CI"

"Optimize the file organizer configuration for production"

"Add file organizer support to the existing codebase"

"Review my file organizer setup and suggest improvements"

"Migrate from the old file organizer approach to the latest version"

Configuration

ParameterDefaultDescription

modeautoProcessing mode: batch, streaming, or incremental

output_dir./outputDirectory for generated files and artifacts

verbosefalseEnable detailed logging for debugging

stricttrueEnforce strict validation on all inputs

timeout30000Maximum execution time in milliseconds

retry_count3Number of retry attempts on transient failures

Best Practices

Start with defaults — The default configuration is optimized for the most common use cases. Override only what you need to change.

Version control everything — Keep all configuration files and generated artifacts in version control for auditability and rollback capability.

Test in isolation first — Validate changes in a sandboxed environment before applying them to shared or production systems.

Document deviations — When you override defaults or apply custom configurations, document the reason in comments or a decisions log.

Monitor after changes — After applying any configuration change, monitor system behavior for at least one full cycle to catch unexpected regressions.

Keep dependencies updated — Regularly update dependencies and check for deprecation notices to avoid security vulnerabilities and compatibility issues.

Common Patterns

Quick setup

npx skills add openclaw/file-organizer

Verify installation

skills verify file-organizer

Run with custom config

skills run file-organizer --mode=auto --verbose

Troubleshooting

IssueCauseSolution

Skill not foundPackage not installed or path incorrectRun npx skills add openclaw/file-organizer to reinstall

Configuration errorInvalid parameter values or missing required fieldsRun skills validate file-organizer to check config

Timeout exceededOperation taking longer than configured limitIncrease timeout parameter or optimize the operation

Permission deniedInsufficient access to target files or directoriesCheck file permissions and ensure write access to output directory

Integration Guide

Follow these steps to integrate File Organizer into your workflow:

Install the skill using your preferred package manager (npx, bunx, or pnpm)

Initialize configuration by running the setup wizard or copying the default config

Customize settings based on your project requirements and team conventions

Add to CI/CD by including the skill invocation in your pipeline configuration

Set up monitoring to track skill execution results and catch failures early

Output Format

This skill produces structured output in the following format:

{ "status": "success", "skill": "file-organizer", "version": "1.0.0", "results": { "files_generated": 3, "warnings": [], "metrics": { "duration_ms": 1250, "memory_mb": 45.2 } } }

Advanced Usage

For power users and complex scenarios:

Chaining skills — Combine this skill with related skills for end-to-end workflows using the skills chain command

Custom templates — Override default templates by placing custom files in the .skills/templates/ directory

Environment variables — Configure behavior via environment variables prefixed with SKILL_ for container-friendly deployments

Hooks — Register pre/post execution hooks to run custom logic before or after the skill executes

Dry run mode — Use --dry-run flag to preview changes without applying them

Related Skills

Skills that work well alongside File Organizer:

Browse more skills in the Data & AI category

Check the full category listing for complementary tools