# recoup-roster-add-artist

Скилл добавляет артиста в ростер Recoup: проверяет Spotify, создаёт или привязывает профиль в нужной организации и наполняет его данными.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4700 установок · ★ 9
- Автор: recoupable
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/recoupable/skills/tree/HEAD/skills/recoup-roster-add-artist/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/recoup-roster-add-artist

## Что делает

Скилл ведёт артиста по цепочке из восьми шагов, а состояние держит в `RECOUP.md`. Сначала проверяется Spotify-ссылка или ID: находится точный `spotify_artist_id` из 22 символов, регистрозависимый. Неоднозначные совпадения останавливают работу и ждут выбора. Дальше идёт `POST /api/artists` с именем, Spotify ID и `organization_id` — ответ `200` означает, что переиспользован существующий канонический профиль, `201` — что создан новый. Статус и ID сохраняются сразу.

Потом скилл тянет исследование через `GET /api/research/lookup`, читает профиль, карьеру и плейлисты, собирает каталог Spotify в `releases/{slug}/RELEASE.md` и `releases/top-tracks.md`, ищет соцсети и дописывает их через `PATCH /api/artists/{id}`, а в конце собирает раздел базы знаний. Все вызовы идут через доступ recoup-platform-api-access.

Ручной путь без Spotify — отдельный: только `{name, organization_id}` и режим `manual`. Он не связывает артиста по совпадению имени и не создаёт запись профессионального ростера. Если канонический запрос упал, этот путь использовать нельзя. Ещё момент: мутацию не повторяют автоматически при сетевой ошибке или `5xx` — она могла пройти, поэтому сначала сверяют ростер. Для примеров из `scripts/onboarding_examples.sh` нужны Bash, jq и настроенный `RECOUP_API_KEY` или `RECOUP_ACCESS_TOKEN`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add recoupable/skills --skill recoup-roster-add-artist -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add recoupable/skills --skill recoup-roster-add-artist -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add recoupable/skills --skill recoup-roster-add-artist -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install recoupable/skills recoup-roster-add-artist
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add recoupable/skills --skill recoup-roster-add-artist -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/recoupable/skills --path skills/recoup-roster-add-artist
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add recoupable/skills --skill recoup-roster-add-artist -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/recoupable/skills/tree/HEAD/skills/recoup-roster-add-artist/SKILL.md

## Когда брать
- завести подписанного артиста в ростер, не создав дубль
- проверить Spotify-личность до первой записи в базу
- привязать артиста к нужной организации, а не к случайной
- собрать релизы и топ-треки в файлы `releases/`
- найти соцсети артиста и записать их в профиль

## Примеры запросов агенту
- добавь артиста в ростер: имя и ссылка на Spotify
- мы только что подписали нового артиста, заведи его
- заведи артиста вручную, Spotify-профиля у него нет

## Похожие
- [connector-spotify](https://affpapa.org/nevibecode/skills/connector-spotify.md) — скилл · 6500 установок
- [Spotify Automation](https://affpapa.org/nevibecode/skills/spotify-automation.md) — скилл · 4600 установок
- [add-feishu](https://affpapa.org/nevibecode/skills/add-feishu.md) — скилл · 454 установки
- [save-to-spotify](https://affpapa.org/nevibecode/plugins/save-to-spotify.md) — плагин · ★ 406
- [spotify-player](https://affpapa.org/nevibecode/skills/spotify-player.md) — скилл · 5400 установок
- [sonoscli](https://affpapa.org/nevibecode/skills/sonoscli.md) — скилл · 5300 установок

Из того же набора: [recoupable/skills](https://affpapa.org/nevibecode/by/recoupable/skills.md) — 4 карточки

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