SkillFoxx

Sorting the Downloads folder on Yandex Disk: an agent skill

yandex-disk-downloads-sort-skill

A skill that sorts Downloads on Yandex Disk into categories, finds duplicates and keeps a move journal with undo

  • 0 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • A token with write access to Yandex Disk sits in a file on disk: after a leak a stranger can move files
  • Folder moves on the Yandex side sometimes stop halfway and leave a half-sorted structure
All reasons and checks
Russian stack

akinfold/yandex-disk-downloads-sort-skillAuthor:akinfold

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/yandex-disk-downloads-sort-skill

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • A token with write access to Yandex Disk sits in a file on disk: after a leak a stranger can move files
  • Folder moves on the Yandex side sometimes stop halfway and leave a half-sorted structure

This is third-party code. Review the repository files before installing.

What it does

The skill in Agent Skills format works through the Yandex Disk REST API. The agent finds the downloads folder (`disk:/Загрузки` or `disk:/Downloads`) and shows what is in it: types, sizes, age, exact duplicates by `md5`, partial downloads, keys and certificates. It then proposes a plan of moves into categories (documents, spreadsheets, images, archives, installers and others), runs it after confirmation and writes a journal that `undo` works from. Files are never deleted or overwritten: duplicates go to `_Duplicates` and name clashes get a suffix. The `downloads_sort.py` and `yadisk_api.py` scripts use only the Python standard library. The skill suits Claude Code, Codex and Cowork, and the repository ships a Custom GPT with `openapi.yaml` for ChatGPT.

Who it is for. People whose Downloads folder on Yandex Disk has grown out of hand and who do not want to sort it manually.

Good fit when

  • The Downloads folder on the Disk is stuffed with screenshots, invoices and installers
  • You need to find exact duplicates and learn how much space they take
  • You want to sort files by rules but be able to undo any move
  • Only PDFs and spreadsheets should be sorted while installers stay where they are

Not a fit when

  • You need to sort local folders on the computer: the skill works only with Yandex Disk through its API
  • You need to delete duplicates: the skill erases nothing and only moves copies to `_Duplicates`
  • You need nested subfolders sorted through: by default the skill does not enter them

Example request

What is in my Downloads folder on Yandex Disk? Show duplicates and propose a plan, but move nothing yet

Limitations

The skill gets access to Yandex Disk through an OAuth token with read and write permissions, and the token sits in a file on disk. Folder moves run on the Yandex side in the background and sometimes stop halfway, so the skill verifies each move and merges the remainder by hand. It works with one downloads folder and does not go deeper than the first level of subfolders without a separate mode. The repository is fresh and small: zero stars, last commit in August 2026. The `install.sh` installer downloads a release and edits `~/.claude/settings.json`, so read the script before running it.

How to disable. Delete the `yandex-disk-downloads-sort` skill folder from the agent skills directory, remove `YANDEX_DISK_TOKEN_FILE` from `~/.claude/settings.json`, delete the token file and revoke the token in the Yandex console.

FAQ

Does the skill delete files?

No: nothing is deleted or overwritten, duplicates move to `_Duplicates` and clashing names get a suffix.

How do I undo a sort?

With the `undo` command: every move is written to the journal before it is sent, so undo works even after an interrupted run.

Where do I get the token?

The quickest way is the Poligon page at yandex.ru/dev/disk/poligon with its OAuth token button. You can also create your own app at oauth.yandex.ru.

Does it work with ChatGPT?

Yes, for the web version the `chatgpt/` folder holds a Custom GPT with `openapi.yaml` and instructions.

Can I change the categories?

Yes: the rules live in `assets/rules.default.json`, and you copy and edit them.

Discussion

No questions or reviews yet.

All Yandex Disk tools
Russian stack

A Yandex Disk MCP server built for finding large files and cleaning up via the API, bypassing local sync

MCP serverExtended access
Russian stack

A Yandex Disk MCP server with 22 tools covering files, public links and trash, background uploads for large files, and a read-only mode

MCP serverExtended access1
Russian stack

A skill pack for Yandex 360: Mail, Calendar, Contacts, Directory, Telemost, Disk, Forms and Tracker

SkillBroad access12
Russian stack

Yandex Disk MCP server: folders, metadata, copy, move, delete and upload or download links

MCP serverBroad access4
Russian stack

A small read-focused MCP server for Yandex Disk: folder listings, file search, download links and public links

MCP serverExtended access
Russian stack

A small Python MCP server for Yandex Disk: browse, upload, download and create files, but never modify existing ones

MCP serverExtended access

README in short

The README covers one-command installation, getting an OAuth token manually in two ways, classification rules by extension and name, behavior for duplicates and subfolders, the repository layout and connection to Claude, Codex and ChatGPT.

README badge

Report a problem