XSXB-Band — скилл
Локальная студия и скилл: агент пишет ноты, а играют их реальные записи инструментов, без генерации музыки моделью.
- 110 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Студия запускает локальный сервер, скачивает файлы из репозиториев авторов и пишет проекты на диск, а агент управляет всем этим по API.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/xsxb-bandОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Студия запускает локальный сервер, скачивает файлы из репозиториев авторов и пишет проекты на диск, а агент управляет всем этим по API.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
XSXB-Band — локальная студия аранжировки и скилл к ней. Пользователь описывает музыку в чате, агент пишет редактируемую партитуру в JSON, а студия играет ее записями настоящих инструментов и экспортирует WAV, MIDI и дорожки по отдельности. Модели генерации музыки и ключи API не нужны. В библиотеке 71 инструмент: пианино, струнные, духовые, ударные, китайские народные инструменты и бит-машина. Для каждой ноты движок подбирает ближайшую запись, меняет ее по силе нажатия, чередует повторы и добавляет живость и реверберацию. Агент читает отчет рендера с уровнями и клиппингом и сам выравнивает баланс. Доработки идут в браузере: пианоролл, ударная сетка, громкость, панорама и реверберация по дорожкам.
Для кого. Авторам видео и игр, которым нужна фоновая музыка по описанию, и музыкантам, которые хотят править ноты после агента.
Подходит, если
- Для ролика нужна 30-секундная композиция в заданном стиле: фолк, джаз или кинематографичная.
- Нужно поменять партию на лету: «двигай эрху назад» или «сделай одну минуту».
- Фоновую музыку хотят собрать из записей с открытой лицензией CC0, без генеративной модели.
- Пользователь записывает свой голос набором из 45 нот и использует его в аранжировке.
Не подходит, если
- Нужны слова песни: скилл не пишет тексты.
- Нужны живые партии с глиссандо на 808-басу или подтяжками гитары: их в библиотеке нет.
- Мало места на диске: полная загрузка записей занимает около 1,5 ГБ.
Пример запроса к агенту
Сделай тридцать секунд тревожной музыки в стиле trap и покажи отчет рендера.Ограничения
Нужен Node.js 22.12 или новее, студия запускается локально на порту 4318. Репозиторий не содержит звуковых файлов: при необходимости студия скачивает записи из репозиториев авторов и проверяет их по SHA-256, полный набор занимает около 1,5 ГБ. Модели гитарных усилителей NAM распространяются под GPL-3.0. Сэмплер слова не поет. Часть инструментов собрана из сжатых публичных записей или заменена близкими тембрами. Оценить качество на слух должен человек.
Как отключить. Остановите студию (`npm start` или `start.bat`) и удалите папку `skills/xsxb-band/` из каталога скиллов агента. Скачанные записи лежат в `data/samples/` внутри студии.
Частые вопросы
Как поставить студию?
Передайте агенту ссылку на репозиторий: он прочтет `AGENTS.md`, поставит зависимости, соберет, запустит и подключит скилл. Вручную нужны `npm ci`, `npm run build`, `npm start`.
Нужны ли ключи API?
Нет. Скилл обходится без моделей генерации музыки: партитуру пишет агент, а играют записи инструментов.
Как открыть редактор?
Запустите студию и откройте `http://127.0.0.1:4318`. Там доступны фортепианный свиток, ударная машина и настройки дорожек.
Можно ли добавить свой голос?
Да. Запишите 45 нот в `/voice-kit/`, запустите `python voice-kit/slice_voice.py`, и появится инструмент «мой голос». Запись остается в локальной папке `data/`.
Что можно экспортировать?
WAV, MIDI и дорожки по отдельности. Проект с партитурой сохраняется в песенную библиотеку студии и остается редактируемым.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыПлагин пишет оригинальную инструментальную музыку нотами без генератора звука: агент сочиняет, скилл проверяет и сводит.
Навык превращает запись песни в аранжировку для школьной группы из пяти инструментов: MIDI, PDF и редактируемый файл MuseScore
29 скиллов для сочинения и аранжировки поп-музыки: по запросу агент заполняет спецификацию для Suno, YuE2 и MIDI
Скилл MiniMax превращает короткое описание песни и размеченный текст в подробный запрос для генератора музыки MiniMax Music 3
MCP Music Studio — музыка в чате с агентом
mcp-music-studio
MCP-сервер, где агент пишет ноты в ABC или живой бит на Strudel, а плеер с редактором открывается прямо в чате
Локальная студия звука с MCP-сервером: агент создает эффекты, музыку, песни и озвучку на моделях с открытыми весами
Коротко о README
Репозиторий содержит студию на Node.js, скилл `skills/xsxb-band/`, документацию по API агента, девять примерных проектов и каталог источников записей с лицензиями. README ведется на китайском и английском.
Бейдж для README
Исходный SKILL.md
---
name: xsxb-band
description: "用 XSXB-Band（小宝乐队）本地工作室为用户作曲、编曲、修改音符、调音色，并用真实采样导出 WAV / MIDI。用户想要一段配乐、背景音乐、某种风格的曲子，或要修改工作室里的乐谱和音色时使用；不用于写歌词，也不调用音乐生成模型。"
---
# XSXB-Band · 小宝乐队
你负责写谱和编曲；工作室用真实录音的乐器演奏、混音、保存和导出。乐谱是可编辑的 JSON，用户之后可以在网页钢琴卷帘里继续改。不调用任何音乐生成模型。
## 找到工作室
- 工作室根目录按顺序确定：`--studio` 参数 → 环境变量 `XSXB_BAND_HOME` → 本 skill 目录下 `studio-path.txt` 的第一行 → 本 skill 所在仓库（skill 位于仓库 `skills/xsxb-band/` 时）。都没有时询问用户。
- 默认服务 `http://127.0.0.1:4318`，可用 `--url` 或 `KLEIN_URL` 覆盖。
- 先读工作室的 `AGENTS.md`、`docs/AGENT-API.md`，再获取 `/api/health`、`/api/state`、`/api/library`。以实时服务和清单为准，不沿用聊天里的版本号、曲名或音色数量。
- 服务未运行时在工作室目录启动：首次 `npm ci` 和 `npm run build`，之后 `npm start`（Windows 可双击 `start.bat`；后台启动用 `Start-Process -WindowStyle Hidden`）。服务已可用就复用，不为编曲重启。
- Windows PowerShell 读写中文文档 / JSON 时显式使用 UTF-8。
工作室 CLI（在工作室目录运行）：
```text
node scripts/agent.mjs state | library
node scripts/agent.mjs install <工程JSON> 下载工程用到的全部音源
node scripts/agent.mjs apply <{revision,project} JSON>
node scripts/agent.mjs song list | song save <{project} JSON> | song open <ID>
node scripts/agent.mjs request list | request complete <ID>
```
没有 CLI 的 Agent 直接调用同一 REST API，写请求用 `Content-Type: application/json`。
## 开工前先问
收到需求后，先拿实时音色清单和这种风格的常见编制比一比，看缺什么。然后用**一条消息**问 1–3 个会改变结果的问题，每个问题都带上你打算的默认做法，用户回一句"按默认"就能开工。优先问这几类：
- **编制缺口和新乐器**：库里最近加的乐器，见 references 的乐器表，风格对得上时要列为可选项。这种风格常用的乐器，清单里没有，或者只有替代品时，问用户：先补 CC0 音源，用相近的乐器代替，还是不用？例：spiritual jazz 缺叮叮镲、手鼓、风铃；民乐缺箫、唢呐；嘻哈缺采样 loop。
- **用途和长度**：视频配乐、游戏循环还是独立作品；时长多少；要不要能无缝循环；有没有对白需要避让。
- **参照和版权**：用户提到具体的歌或艺术家时，问清楚是"风格致敬"（原创旋律），还是"翻奏原曲"。翻奏要说明版权情况，公有领域的作品可以放心用。
- **人声**：采样器唱不了歌词。需要人声时，说明能做到的范围：哼鸣、无词元音、beatbox。
- **速度、调性、情绪**：只在需求里完全没有线索时才问。
不要问的：
- 清单内容、服务状态这类自己查得到的事；
- 用户已经说清楚的事；
- 纯实现细节。