Claude AI Music Skills
bitwize-music-studio/claude-ai-music-skillsClaude Code плагин для музыкальных продюсеров: от концепции до мастеринга. Генерирует тексты, Suno-промпты, обрабатывает аудио и готовит релиз. 52 скилла, мультимодельная оркестровка, MCP-сервер с 80+ инструментами.
Установка
git clone https://github.com/bitwize-music-studio/claude-ai-music-skills.gitREADME
Claude AI Music Skills
Я люблю музыку, но так и не научился играть на инструментах. AI стал творческим выходом, который всегда был недосягаем. Этот проект начинался как способ глубоко погрузиться в архитектуру плагинов Claude Code, агентные воркфлоу, мультимодельную оркестровку и MCP-инструментарий. Музыка стала предметной областью, потому что это личное.
Что это делает на практике: плагин Claude Code, превращающий разговор в полный пайплайн производства альбома. Вы описываете, что хотите создать, а он берёт на себя разработку концепции, написание текстов, генерацию промптов для Suno (платформа генерации музыки с помощью AI), мастеринг аудио и подготовку к релизу — с контрольными точками качества и верификацией источников на каждом этапе.
[!NOTE] Активная разработка ведётся в ветке
develop— вmainпопадают только протестированные стабильные релизы. Если возникнут проблемы, создайте issue или отправьте PR.
Пример воркфлоу
Вы: "Let's make an album about the 2016 Bangladesh Bank heist"
Claude: Создаёт структуру альбома, запускает 7-фазное планирование концепции
Вы: "Start the research"
Claude: Параллельно запускает юридических, финансовых и технических исследователей
Собирает материалы DOJ, документацию SWIFT, анализ вредоносного ПО
Перекрёстно проверяет источники, помечает утверждения, требующие ревью человека
Вы: "Sources look good. Let's write track 1"
Claude: Пишет текст, проверяет просодию и схемы рифм
Сканирует риски произношения, предлагает фонетические правки
Формирует стилевой промпт Suno V5 с жанровыми тегами и вокальными указаниями
Вы: "Track sounds great, here's the WAV"
Claude: Импортирует аудио, разделяет стемы, полирует каждый стем
Мастерит до -14 LUFS для стриминга
Генерирует промо-видео и тексты для социальных сетей
От концепции до выпущенного альбома. Вы генерируете в Suno, всё остальное происходит в терминале.
Установка
/plugin marketplace add bitwize-music-studio/claude-ai-music-skills
/plugin install bitwize-music@claude-ai-music-skillsЗатем выполните /bitwize-music:setup для определения окружения и установки зависимостей. Запустите /bitwize-music:configure для настройки имени исполнителя и путей рабочего пространства.
Платформа: Linux или macOS (пользователи Windows: используйте WSL). Python 3.10+ для MCP-сервера и аудиоинструментов.
Архитектура
Здесь сосредоточена вся инженерная часть. Плагин — это практический пример того, насколько далеко можно продвинуть систему плагинов Claude Code.
Система скиллов (52 скилла)
Каждый скилл — самодостаточный markdown-файл с YAML-фронтматтером, который объявляет модель, описание и условия активации. Скиллы варьируются от простых операций с буфером обмена до многошаговых творческих воркфлоу. Claude автоматически маршрутизирует к скиллам по контексту, либо вы вызываете их напрямую через /bitwize-music:<name>.
Скилл написания текстов знает правила просодии, анализ схем рифм и особенности произношения в Suno. Скилл мастеринга знает целевые уровни громкости для каждой платформы и жанрово-специфичные EQ-кривые. Скилл исследователя координирует параллельные суб-агенты по 10 предметным специализациям.
См. docs/skills.md для полного справочника.
Мультимодельная оркестровка
Скиллы объявляют, какая модель Claude им нужна. Творческая работа, напрямую влияющая на качество музыки, выполняется на Opus. Задачи координации и рассуждений используют Sonnet. Механические операции (импорт, валидация, буфер обмена) работают на Haiku.
| Уровень | Модель | Скиллов | Обоснование |
|---|---|---|---|
| Творческий | Opus 4.6 | 6 | Тексты, Suno-промпты, концепции альбомов, юридические/верификационные исследования — качество вывода определяет музыку |
| Рассуждения | Sonnet 4.6 | 29 | Координация исследований, анализ произношения, большинство воркфлоу |
| Механический | Haiku 4.5 | 17 | Импорт, валидация, буфер обмена, справка — скорость важнее творчества |
Этот проект нагружает Claude Code по максимуму — мультиагентные исследования, анализ аудио в реальном времени, оркестровка суб-агентов по уровням моделей. Лучше всего работает на плане Max. Стандартный план Pro будет упираться в лимиты запросов при многотрековых сессиях.
См. reference/model-strategy.md для обоснования по каждому скиллу.
MCP-сервер (80+ инструментов)
Python MCP-сервер предоставляет 80+ инструментов для мгновенных запросов состояния, анализа аудио, обработки текстов и операций с базой данных. Сервер — нервная система плагина: скиллы вызывают MCP-инструменты вместо прямого чтения файлов, что обеспечивает быстрые ответы и согласованность состояния.
Основные категории инструментов:
- Управление состоянием — поиск альбомов/треков, контекст сессии, перестройка кэша
- Анализ текстов — подсчёт слогов, оценка читаемости, определение рифм, валидация секций, повторения между треками
- Обработка аудио — мастеринг, анализ стемов, QC-проверки, генерация промо-видео
- База данных — управление твитами и промо-контентом через PostgreSQL
Система исследований
Для документальных и основанных на реальных событиях альбомов система исследований координирует параллельное расследование через 10 специализированных суб-агентов. Ведущий исследователь направляет задачи специалистам (юридическим, финансовым, техническим, государственным, журналистским и др.), каждый из которых обучен находить первичные источники в своей области. Агент верификации перекрёстно проверяет все утверждения перед ревью человека.
Полный пайплайн: сбор источников, верификация цитат, обязательное подтверждение человеком — и только после этого разрешается генерация текстов. Каждое утверждение в музыке прослеживается до зафиксированного верифицированного источника.
Контрольные точки качества
Ничто не выходит без прохождения проверок:
- Тексты: чеклист из 13 пунктов (рифма, просодия, произношение, согласованность POV, фактическая точность)
- Перед генерацией: источники верифицированы, флаги явного контента установлены, стилевой промпт готов, имена исполнителей проверены
- Аудио: QC из 7 пунктов (громкость, клиппинг, тишина, фаза, стереоширина, частотный баланс, динамический диапазон)
- Структура: валидация директории альбома, проверка расположения файлов, целостность контента
Охват жанров
72 жанровых директории с руководствами по продакшену, пресетами мастеринга и глубоким анализом исполнителей.