# acestep

Скилл подключает API ACE-Step V1.5 для генерации треков по тексту, создания каверов и перерисовки аудио через скрипт scripts/acestep.sh.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 15059 у репозитория
- Автор: ace-step
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ace-step/ACE-Step-1.5/tree/HEAD/.claude/skills/acestep/SKILL.md
- Обновлён: 2026-10-11
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/ace-step-acestep

## Что делает

Скилл запускает генерацию музыки через локальный bash-скрипт `scripts/acestep.sh`, обращаясь к ACE-Step V1.5 API. Прямые вызовы эндпоинтов запрещены: агент всегда работает через CLI-обёртку. Доступны синтез треков с вокалом по готовому тексту песни, создание чистых инструменталов, генерация каверов на основе исходного файла и режим audio repainting для замены конкретного фрагмента по таймкодам `repaint-start` и `repaint-end`.

Результаты работы складываются в папку `acestep_output/` в корне проекта в виде MP3-файлов и JSON с метаданными задачи, включая использованный сид, BPM и тональность. Если включено улучшение промпта через языковую модель, итоговый текст песни может отличаться от введённого, поэтому точные слова берутся из верхнеуровневого поля `lyrics` в результирующем JSON.

Для загрузки тяжелых исходников в облачный API аудиофайл может заблокировать Cloudflare. В этом случае скрипт требует предварительно сжать файл утилитой ffmpeg.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ace-step/ACE-Step-1.5 --skill acestep -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/acestep/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/acestep/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ace-step/ACE-Step-1.5 --skill acestep -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/acestep/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ace-step/ACE-Step-1.5 --skill acestep -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/acestep/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ace-step/ACE-Step-1.5 .claude/skills/acestep
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/acestep/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ace-step/ACE-Step-1.5 --skill acestep -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ace-step/ACE-Step-1.5 --path .claude/skills/acestep
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/acestep/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ace-step/ACE-Step-1.5 --skill acestep -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ace-step/ACE-Step-1.5/tree/HEAD/.claude/skills/acestep/SKILL.md

## Когда брать
- Сгенерировать песню с вокалом по текстовому описанию стиля и полному тексту
- Сделать кавер на исходный MP3 с сохранением мелодической структуры
- Перерисовать фрагмент готовой аудиозаписи в заданном интервале секунд
- Создать инструментальный трек с нужным темпом BPM и тональностью

## Примеры запросов агенту
- Проверь статус сервиса через `./scripts/acestep.sh health`
- Сгенерируй поп-трек на 120 секунд с пианино через `./scripts/acestep.sh generate -c "pop, female vocal, piano" -l "[Verse] Текст куплета..." --duration 120`
- Сделай рок-кавер на песню через `./scripts/acestep.sh cover song.mp3 -c "Rock cover style" --duration 120 --bpm 128`

## Похожие
- [ai-music](https://affpapa.org/nevibecode/skills/ai-music.md) — скилл · 379800 установок
- [scenario-ace-step](https://affpapa.org/nevibecode/skills/scenario-ace-step.md) — скилл · 843 установки
- [ace-step](https://affpapa.org/nevibecode/skills/ace-step.md) — скилл · 379200 установок
- [suno-music](https://affpapa.org/nevibecode/skills/suno-music.md) — скилл · 287 установок
- [Vocuno](https://affpapa.org/nevibecode/mcp/vocuno.md) — MCP-сервер · ★ 1 у репозитория
- [music](https://affpapa.org/nevibecode/skills/music.md) — скилл · 15600 установок

## Другие версии с тем же именем
- [acestep · calesthio](https://affpapa.org/nevibecode/skills/acestep.md) — 1200 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
