file-skill

Moves scattered files into existing or fallback folders with auditable logs and rollback.

Updated May 4, 2026
One-click install
npx skills add https://github.com/234194027-cpu/xianclaw --skill file-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-skill
Source: https://github.com/234194027-cpu/xianclaw/tree/main/resources/openclaw/config/skills/file-skill
Command: npx skills add https://github.com/234194027-cpu/xianclaw --skill file-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lsof, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you automatically organize scattered files and desktop clutter into appropriate folders without deleting or overwriting anything, while producing a fully auditable log with one-click rollback.

Core Features & Use Cases

  • Zero deletion / zero overwrite file moving: Moves files only (or creates target folders when needed) while skipping protected targets like shortcuts and existing folders.
  • Two-phase classification workflow: First matches into existing folders using keyword and naming-pattern logic, then applies frequency-based and file-type-based fallback categorization.
  • Reversible operations with logs: Records every move into structured logs so you can restore everything or rollback a single file.

Use Case: Your desktop contains mixed downloads and documents after a busy workday. Trigger this Skill to classify files into existing project folders when possible, otherwise place them into intelligent categories like images, documents, spreadsheets, media, archives, and logs.

Quick Start

Tell the AI: "整理桌面并自动归类文件,生成可回撤的整理报告。"

Frequently Asked Questions about file-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically organize desktop clutter without deleting files?

Automated desktop cleanup tools move scattered files into categorized folders without deletion. They skip shortcuts and protected directories while generating structured rollback logs for safe restoration.

How does smart file categorization handle files that don't match existing folders?

Smart file categorization uses a two-phase workflow. It first matches files into existing folders using keyword and naming-pattern logic, then applies frequency-based and file-type-based fallback classification for unmatched items.

Can I rollback a single file move after an automated desktop cleanup?

Yes, you can rollback a single file move after desktop cleanup. The operation records every move into structured logs, enabling you to restore everything or selectively rollback individual files to their original locations.

Does file organization require any specific dependencies to run safely?

Safe file organization requires the lsof dependency to ensure cross-platform execution. This script-driven approach scans and moves files while strictly skipping shortcuts and existing folders to prevent data loss.

What's the best way to clean up mixed downloads and documents on my desktop?

The best way to clean up mixed downloads and documents is using a two-phase classification workflow. It places files into existing project folders when possible, otherwise categorizing them into images, documents, spreadsheets, media, archives, and logs.

Why are shortcuts skipped during automated file moving?

Shortcuts are skipped during automated file moving to prevent breaking application links and system paths. The script strictly avoids protected targets like shortcuts and existing folders, ensuring zero overwrite and safe moving.