Setup Artist

# Recoup Setup Artist Skill

An LLM skill for scaffolding a complete artist workspace inside a sandbox environment.

## What It Does

- Creates the full directory structure for an artist workspace
- Populates context files (identity, audience, era)
- Sets up the memory system with scope-aware instructions (MEMORY.md + README)
- Creates a lean services guide (no pre-filled JSON) and environment files
- Creates README files for every directory so agents know what goes where
- Fills in artist data when available, uses placeholders when not

## Prerequisites

Run the `setup-sandbox` skill first to create the org/artist folder structure.

## Usage

> "Set up the workspace for [Artist Name]"

> "Create artist directory for [Artist Name]"

> "Initialize [Artist Name]'s artist workspace"

## Files

| File | Purpose |
|------|---------|
| `SKILL.md` | Core skill instructions |
| `references/context-files.md` | Templates for `context/` files (artist, audience, era, tasks, images) |
| `references/memory-system.md` | Templates for the `memory/` directory (includes scope system) |
| `references/services-guide.md` | Template for `config/SERVICES.md` — lean, add-as-you-go approach |
| `references/env-template.md` | Templates for `.env.example` and `.env` files |
| `references/directory-readmes.md` | Templates for `songs/`, `releases/`, `config/`, `library/`, `apps/` READMEs |
| `references/root-readme.md` | Template for the root `README.md` |


---
name: setup-artist
description: Set up the workspace for a new artist inside a sandbox. Creates the directory structure, context files, memory system, and placeholder content so agents can immediately start working. Use after setup-sandbox has created the org/artist folders, when RECOUP.md has status not-setup. Triggers on "set up artist", "create artist workspace", "initialize artist", or "onboard new artist".
---

# Setup Artist

Scaffold a complete artist workspace so agents can start working immediately.

## Prerequisites

- The sandbox has already been set up (see `setup-sandbox` skill)
- An artist folder exists at `orgs/{org}/artists/{artist-slug}/` with a `RECOUP.md` marker file
- The `RECOUP.md` file contains the artist's name, slug, and Recoup ID (created by `setup-sandbox`)

## Folder Structure

```
{artist-slug}/
├── RECOUP.md
├── README.md
├── .env.example
├── .env
├── context/
│   ├── artist.md
│   ├── audience.md
│   ├── era.json
│   ├── tasks.md
│   └── images/
│       └── README.md
├── memory/
│   ├── README.md
│   └── MEMORY.md
├── songs/
│   └── README.md
├── releases/
│   └── README.md
├── content/
│   ├── README.md
│   ├── images/
│   └── videos/
├── config/
│   ├── README.md
│   └── SERVICES.md
├── library/
│   └── README.md
└── apps/
    └── README.md
```

## Steps

### Step 1: Read `RECOUP.md` and create the directory structure

1. Navigate to the artist folder and read `RECOUP.md` to get the artist's name, slug, and ID:

```bash
cd orgs/{org}/artists/{artist-slug}
cat RECOUP.md
```

2. Create the directory structure:

```bash
mkdir -p {context/images,memory,songs,releases,content/images,content/videos,config,library,apps}
```

### Step 2: Update `RECOUP.md`

Update the `status` field from `not-setup` to `active` and replace the body with a brief description:

```markdown
---
artistName: {Artist Name}
artistSlug: {artist-slug}
artistId: {uuid-from-recoupable}
status: active
---

# {Artist Name}

Connects this workspace to the Recoupable platform. See `README.md` for the full directory guide and setup checklist.
```

### Step 3: Create context files

Create each file from the templates in `references/context-files.md`. The essential files:

| File | What to do |
|------|-----------|
| `context/artist.md` | Fill with artist identity, brand, visual world, voice, tone. Ask the user for details or research the artist. |
| `context/audience.md` | Fill with audience insights. Focus on WHY they listen, what they relate to, how they talk. |
| `context/era.json` | Set the current rele