setup-sandbox

setup-sandbox scaffolds the initial file system for a newly created Recoup sandbox workspace. It solves a first-run bootstrapping problem: a fresh sandbox has no folder structure, and this skill fetches the connected account's organizations and artists via the Recoup CLI and lays out the corresponding directory tree. It is intended to run only once, and the documentation instructs checking for an existing orgs/ directory first — if it exists, the skill is not needed.

The workflow is a short, deterministic sequence: optionally read a RECOUP_ACCOUNT_ID environment variable (used only with an Org API Key; a Personal API Key lets the CLI infer the account), run `recoup orgs list --json` to enumerate organizations, then `recoup artists list --org {id} --json` per organization, and create an `orgs/{org}/artists/{artist-slug}/` folder for each artist using the exact artistSlug from the CLI response. In each artist folder it writes a RECOUP.md identity file containing artistName, artistSlug, and artistId from the CLI, then commits and pushes the new folders to the main branch. The RECOUP.md marker connects the workspace to the Recoupable platform and signals that the workspace is active.

The target users are Recoupable platform users and agents provisioning a new artist/organization workspace. Credentials are supplied through standard API-key mechanisms and used only to read the account's own org and artist data; the skill performs local filesystem scaffolding and a routine git commit and push, with no destructive or exfiltration behavior.