Setup Sandbox

1---2name: setup-sandbox3description: Set up the initial file system for a new sandbox. Fetches the account's organizations and artists via the Recoup CLI and scaffolds the folder structure. Use when a sandbox has just been created and has no existing file system. Before running, check if the sandbox already has an orgs/ directory — if it does, this skill is not needed.4---5 6# Setup Sandbox7 8Create the folder structure for the connected account's organizations and artists.9 10## Environment11 12- `RECOUP_ACCOUNT_ID` — The account ID to fetch data for. Only needed when using an Org API Key. When using a Personal API Key, omit the `--account` flag and the CLI will use the authenticated account automatically.13 14## Steps15 161. Check if `RECOUP_ACCOUNT_ID` is set. If set, use `--account $RECOUP_ACCOUNT_ID` on all CLI commands below. If not set, omit the `--account` flag.172. Run `recoup orgs list --json [--account $RECOUP_ACCOUNT_ID]` to get all organizations183. For each organization, run `recoup artists list --org {organization_id} --json [--account $RECOUP_ACCOUNT_ID]` to get its artists194. Create the folder structure and a `RECOUP.md` marker in each artist folder:20   - Use `artistSlug` from the CLI response as the exact directory name — never append UUIDs, IDs, or suffixes21   - If `orgs/{org}/artists/{artist-slug}/` already exists, skip it22   - `mkdir -p orgs/{org}/artists/{artist-slug}` for each new artist23   - Write a `RECOUP.md` using the template below245. Commit and push:25   - `git add -A && git commit -m "setup: create org and artist folders" && git push origin main`26 27## `RECOUP.md`28 29Every artist directory has a `RECOUP.md` at its root. This is the **identity file** — it connects the workspace to the Recoupable platform. The existence of this file means the workspace is active.30 31Fill it with data from the CLI response:32 33```markdown34---35artistName: {Artist Name}36artistSlug: {artist-slug}37artistId: {uuid-from-recoupable}38---39```40 41**Fields:**42 43- `artistName` — display name from the CLI (e.g. `Gatsby Grace`)44- `artistSlug` — lowercase-kebab-case folder name (e.g. `gatsby-grace`)45- `artistId` — the UUID from Recoup