mcpField
R
recoup-roster-list-artists

recoup-roster-list-artists

github.com/recoupableOther94.8k installsUpdated 1d ago
Repository

About recoup-roster-list-artists

A Recoup skill for inventorying an artist roster from workspace files or, when those are missing or empty, through Recoup platform API roster discovery. It reports artist names with their slugs or IDs and avoids treating an absent filesystem as an empty roster.

Key features

  1. 01Scans artist workspace directories
  2. 02Finds RECOUP.md identity files
  3. 03Falls back to platform API discovery
  4. 04Reports names with slugs or IDs
  5. 05Checks live roster when files are absent

Use cases

  1. 01Listing artists in a Recoup workspace
  2. 02Checking the roster when artist files are missing
  3. 03Preparing an inventory with artist identities

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/recoupable/skills --skill recoup-roster-list-artists

After installing, type/recoup-roster-list-artistsin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported