SuperAPI AI Directory
Partner中文AI newsFavorites
Skillsfile-sorter

file-sorter

Office & productivity

View repository

Updated 10-16 06:52

About this skill

In the commands below, <skill-dir> is this skill's base directory, announced when the skill loads. Substitute the literal path. On Windows, py -3 may replace python.

Default: scan and assemble a review plan. --execute is forbidden until the user approves the shown plan_id in this turn.

Routing

  • Local folder / same-parent files, categorize, organize, rename suggestions: this skill.
  • Windows dev process cleanup: windows-dev-process-cleanup.
  • Git worktree create/list/remove: git-worktree.
  • Commit: git-commit.
  • Repository source-layout refactors, duplicate deletion, Drive sync, PARA cabinets: refuse.

Workflow

  1. Scan (absolute --root only):
python "<skill-dir>/scripts/file_sorter.py" scan --root <abs> [--recursive] [--output <scan.json>]

If ok_to_scan is false, report skipped and stop.

  1. Propose category / subcategory / optional suggested_name from taxonomy.md. Use document excerpts only when the name is vague (max about 8000 characters). Use an image description only when the host already has vision. Screenshots describe on-screen content; do not label ordinary images as Installers or Operating Systems. Do not compute target_dir.

  2. Assemble:

python "<skill-dir>/scripts/file_sorter.py" assemble-plan --scan <scan.json> --proposals <proposals.json> [--mode more-consistent|more-refined] [--operation categorize|rename|categorize-and-rename] [--whitelist <whitelist.json>] [--output <plan.json>]

Default mode is more-consistent. Default operation is categorize.

  1. Show plan_id, items, rejected, skipped. Preview apply:
python "<skill-dir>/scripts/file_sorter.py" apply --plan <plan.json>
  1. After this-turn approval of that plan_id:
python "<skill-dir>/scripts/file_sorter.py" apply --plan <plan.json> --execute
  1. Undo with the sidecar from undo_path only after showing it and getting approval:
python "<skill-dir>/scripts/file_sorter.py" undo --undo <plan.undo.json> --execute

Do not call mv, Move-Item, or delete user files. Helper default is dry-run.

Output

Report plan_id, ok_to_apply, destination paths, skipped reasons, and whether apply was dry-run or executed. Mark install proof, provider comparison, and human blind review as missing evidence.

Resources