# Recoup Roster List Artists

> See who's on your roster — answers "what artists do I have" by walking the workspace and falling back to your live account when the filesystem is empty. Use for "what artists do I have", "list my roster", "who's on my roster", or "what's in this sandbox". To add a new artist use recoup-roster-add-artist; to work inside one artist's files use recoup-roster-manage-artist.

- Skill: `om-scogo/recoup-roster-list-artists` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds add om-scogo/recoup-roster-list-artists`
- Raw SKILL.md: https://api.skillmd.com/api/skills/om-scogo/recoup-roster-list-artists/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: om-scogo (https://skillmd.com/u/om-scogo)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/om-scogo/recoup-roster-list-artists

---


# Recoup — List Artists

Inventory the roster. Artist dirs live at `artists/{artist-slug}/`; `RECOUP.md`
(frontmatter `artistName`/`artistSlug`/`artistId`) is the identity file.

## Procedure

Walk the filesystem when it's a real sandbox (`ls -d artists/*/`,
`find artists -name RECOUP.md`); if `artists/` is missing/empty, fall back to
recoup-platform-api-access roster discovery (`GET /accounts/id` → `GET /organizations`
→ `GET /artists?org_id=…`).

**Never report an empty roster from a missing filesystem** — an empty `artists/`
dir is not an empty roster; confirm against the live account first.

## Guardrails

- **Never invent a roster/artist** — empty filesystem ≠ empty roster.
- Report names + identity (slug/id), not a raw JSON dump.