---
id: gh-recoup-roster-add-artist
name: "recoup-roster-add-artist"
url: https://skills.yangsir.net/skill/gh-recoup-roster-add-artist
author: recoupable
domain: automation
tags: ["artist-onboarding", "roster-management", "music-industry", "api-integration", "workflow-automation"]
install_count: 4600
rating: 4.40 (120 reviews)
github: https://github.com/recoupable/skills/tree/main/skills/recoup-roster-add-artist
---

# recoup-roster-add-artist

> 此技能用于将新艺人入职到厂牌，通过8步调用链自动化创建账户、Spotify匹配、研究、目录、社交和知识库构建，确保艺人信息完整并建立工作空间文件夹。适用于“新增艺人”、“设置艺人档案”等场景，大幅提升入职效率。

**Stats**: 4,600 installs · 4.4/5 (120 reviews)

## Before / After 对比

### 新艺人入职时间

**Before**:

在没有此技能之前，用户需要手动通过多个系统完成艺人入职：创建账户、搜索Spotify、收集社交链接、整理知识库等，步骤繁琐且易出错，整个过程平均耗时2小时。

**After**:

此技能一键执行8步自动化流程，从创建账户到知识库构建全部自动完成，5分钟内即可完成艺人入职，且信息准确完整。

| Metric | Before | After | Change |
|---|---|---|---|
| 耗时 | 120分钟 | 5分钟 | -96% |

## Readme

# Recoup — Add Artist

Bring a new artist into the box: create the account, enrich it, and scaffold their
workspace. Driven by a checklist so the long chain is resumable.

## The 8-call onboarding chain (drive from the RECOUP.md checklist)

Long chains run from prose drop steps, so **drive from the `RECOUP.md` checklist**:
scaffold it first (frontmatter holds captured values; body holds the unchecked
steps), tick + persist after each step — the file IS the workflow state, resumable
from the first unchecked box. Don't run under an `agent+` account (data gets
orphaned). The 8 calls:

1. `POST /api/artists {name, organization_id}` → capture `account_id`.
2. `GET /api/spotify/search` → best match → `id`, `external_urls.spotify`, `images[0]`.
3. `PATCH /api/artists/{id}` with image + `profileUrls:{SPOTIFY}` (UPPERCASE keys).
4. Structured research (retry transient misses): `/research/lookup?spotifyId=` →
   `songstats_artist_id`, then `/research/profile|career|playlists` + `/research/web`.
5. Spotify catalog (`topTracks`, `albums`, `album`) → write `releases/{slug}/RELEASE.md`
   per album + `releases/top-tracks.md`.
6. Web search for socials (ig/tiktok/twitter/youtube).
7. `PATCH /api/artists/{id}` with discovered `profileUrls` (only platforms found).
8. Synthesize a `## Knowledge base` section into `RECOUP.md`.

Run in order; don't continue past a 4xx/5xx without recovery. Uses
recoup-platform-api-access for the call shapes.

## Guardrails

- **The file is the state** — tick + persist each step or a fresh turn redoes/skips work.
- **No placeholder data** in artist files — real content or leave the section out.
- **Never invent a roster/artist** — confirm via recoup-platform-api-access first; an
  empty filesystem is not an empty roster.


---
*Source: https://skills.yangsir.net/skill/gh-recoup-roster-add-artist*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-recoup-roster-add-artist/markdown*