菜单
This skill should be used when the user asks to sync a playlist, push or pull from Yandex Music, search YM, manage YM playlists, or manage YM likes. Covers bidirectional sync, playlist management, ordered pushes, search and likes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when managing DJ techno music library, building DJ sets, analyzing audio/transitions, or working with Yandex Music/Beatport/Suno providers. Triggers on keywords: dj, set, mix, track, bpm, camelot, transition, playlist, library, techno, suno, yandex music, beatport. Use ONLY when the task involves DJ-specific domain (library management, set building, audio analysis, provider sync). Do NOT use for general programming.
This skill should be used when the user asks to build a DJ set, create a set from playlist or library, optimize track order, rebuild set, reorder tracks, or make a set. Covers candidate curation, GA/greedy optimization, L5 finalization, review and iteration.
This skill should be used when the user asks to classify tracks, audit playlist, get library stats, distribute to subgenres, run mood classification, curate a crate, or review library quality. Covers feature-first curation, mood classification, audits, dedup and stats.
This skill should be used when the user asks to deliver a set, export a set, finalize a set, do a rekordbox export, sync a set to YM, or generate a cheat sheet. Covers the generated-sets bundle (MP3 + M3U8 + cheatsheet + rekordbox XML), YM playlist push and backup.
This skill should be used when the user asks to expand a playlist, find similar tracks, add more tracks, discover new tracks, crate digging, import from Yandex Music, or fill gaps in a playlist. Covers seed-based discovery, import, download and analysis.
| name | ym-sync |
| description | This skill should be used when the user asks to sync a playlist, push or pull from Yandex Music, search YM, manage YM playlists, or manage YM likes. Covers bidirectional sync, playlist management, ordered pushes, search and likes. |
| version | 1.1.0 |
Синхронизация с YM через v1-диспетчеры (@docs/tool-catalog.md). Все namespace видимы со старта (v1.3.7+); unlock_namespace остаётся для audit-log и клиентов, честно обрабатывающих tools/list_changed.
provider_search(provider="yandex", query="...", type="tracks", limit=20); type ∈ tracks|albums|artists|playlists|all.provider_read(provider="yandex", entity="track", id=<ym_id>) (id — int или str); батч: entity="track_batch", params={"track_ids": [...]} (legacy ids тоже принимается).entity="track_similar", id=<ym_id>; альбом: entity="album"; треки артиста: entity="artist_tracks"; плейлист: entity="playlist", id="<owner>:<kind>" или bare <kind>; списки: entity="playlist_list" | "likes" | "dislikes".provider_write)Матрица операций — YandexAdapter.operations_supported: playlist × {create, rename, set_description, delete, add_tracks, remove_tracks}, likes × {add, remove}. create_from_set НЕ существует — пуш сета = create → add_tracks.
provider_write(provider="yandex", entity="playlist", operation="create", params={"title": "..."}) → из ответа возьми kind (и trackCount).provider_write(..., operation="add_tracks", params={"playlist_id": "<kind>", "track_ids": [<ym ids по порядку>], "at": <текущий trackCount>})
at YM вставляет в позицию 0 (prepend) — существующий плейлист получит треки в начало, порядок разрушен. Append = at=<trackCount>; свежесозданный плейлист: at=0.albumId.revision опционален — адаптер сам резолвит текущую ревизию; после каждой мутации ревизия меняется (следующая мутация — с fresh-состоянием).trackCount и durationMs должны сойтись с ожиданием — частичный пуш иначе останется незамеченным.operation="remove_tracks", params={"playlist_id": "<kind>", "from": <индекс вкл.>, "to": <индекс искл.>} (YM-семантика delete-diff; позицию трека найди через provider_read(entity="playlist")). rename/set_description/delete — с playlist_id.entity="likes", operation="add"|"remove", params={"track_ids": [...]}.playlist_sync)playlist_sync(playlist_id=<local_id>, direction="diff", source="yandex", dry_run=true); pull (YM→local), push (local→YM). dry_run=true — превью без мутаций. Default direction — всегда "diff".playlist.source_of_truth (local|yandex) — информационное: sync-логика его НЕ читает, направление выбирай явно.create с title = имя сета → kind.add_tracks одним вызовом: YM ids в порядке сета, at=0 (плейлист пуст).trackCount/durationMs из ответа.
YM ids бери из track_external_ids или из [<ym_id>] в именах скачанных файлов.@docs/ym-api-guide.md. Ключевое: rate limit 1.5 с/вызов + backoff на 429; budget общий на токен/IP — фоновая качалка (usb_download и т.п.) делает параллельные write/интеграционные вызовы флаки с реальными 429; playlist-правки идут diff-форматом внутри адаптера; broken endpoints: artist brief-info (403), lyrics (400).
track_batch, playlist_list) дешевле цикла по одному id.playlist_sync(direction="pull") перед сборкой сетов из YM-плейлистов.