@recoupable/recoup-api
Call the Recoupable API from the sandbox to fetch artist data, socials, organizations, research, documents and any other platform resource — and to invoke external connector actions (Google Docs / Drive / Sheets edits, Gmail, TikTok, Instagram, etc.) via Recoupable's shared connections. Use whenever you're asked for Recoup data, a Recoupable platform resource, or to read/write something outside Recoup like a Google Doc URL or a spreadsheet. Triggers on phrases like "look up artist", "fetch from recoup", "artist data", "artist socials", "organizations", "artist report", "research", "create new artist", "create artist", "onboard artist", "add artist", "edit this Google Doc", "read this doc", "update the spreadsheet", "send an email", "post on TikTok", "save to Drive", or whenever the user pastes a docs.google.com / drive.google.com / sheets.google.com URL. Always load this before writing curl calls against recoup-api.vercel.app.
Recoup Skills
AI agent skills for the music industry — a record label in a box. One install gives your agent the whole Recoup platform: artist setup & API access, research, catalog deals, content, song analysis, and releases.
Install
Claude Code / agents marketplace
/plugin marketplace add recoupable/skills
/plugin install recoup-skills@recoup
npx (any harness)
npx skills add recoupable/skills
Manual
Clone the repo and load it as a plugin — the repo root is the plugin, with every skill under skills/:
git clone https://github.com/recoupable/skills.git
Skills
Every skill is named recoup-[domain]-[verb]-[noun], so the / list clusters by domain.
roster — your artists
| Skill | What it does |
|---|---|
| recoup-roster-add-artist | Onboard & enrich a new artist (the 8-call setup chain) |
| recoup-roster-list-artists | See who's on your roster |
| recoup-roster-onboard | Bootstrap an empty org's whole roster (bulk-onboard via parallel subagents) |
| recoup-roster-manage-artist | Work inside one artist's folder — context, brand, songs, releases |
research — industry intelligence
| Skill | What it does |
|---|---|
| recoup-research-artist-overview | Full research sweep on one artist |
| recoup-research-find-talent | A&R scouting for emerging/unsigned artists |
| recoup-research-playlist-targets | Catalog-wide playlist strategy & placement gaps |
| recoup-research-find-contacts | Find managers/A&R/press + draft outreach |
| recoup-research-weekly-brief | The recurring "what changed this week" update |
| recoup-research-the-web | Open-web search, deep research, entity enrichment |
song — audio analysis
| Skill | What it does |
|---|---|
| recoup-song-analyze-audio | Understand a song from its audio (BPM/key/genre, lyrics, mix) |
| recoup-song-find-hook | Find the most clip-worthy 5–15 seconds |
| recoup-song-placement-pitch | Playlist/editorial pitch + sync brief from the audio |
content — media assets
| Skill | What it does |
|---|---|
| recoup-content-write-caption | Captions in the artist's own voice |
| recoup-content-make-graphics | Cover art, thumbnails, carousels, promo/quote cards |
| recoup-content-make-video | Short-form video, lyric videos, visualizers, reformats |
| recoup-content-asset-pack | A whole 15–30-piece clip family for one song |
| recoup-content-reactive-post | Turn a real milestone/trend into a timely post |
release — release workflow
| Skill | What it does |
|---|---|
| recoup-release-plan-rollout | Plan & run a release end to end |
| recoup-release-track-drop | Confirm a drop & build a launch-day alert |
catalog — catalog deals
| Skill | What it does |
|---|---|
| recoup-catalog-review-deal | Underwrite a deal end to end (data room → IC memo) |
| recoup-catalog-estimate-value | Value a catalog from public data alone (no seller files) |
| recoup-nft-valuation | Measure an artist's onchain NFT earnings & fold them into a valuation |
platform — operate the system
| Skill | What it does |
|---|---|
| recoup-platform-connect-account | First-run setup: verify email, mint an API key |
| recoup-platform-track-onboarding | Score an account against the activation funnel; route to the next step |
| recoup-platform-build-os | Build the org's self-managing music-company OS (folders + brain + janitor + plugin), seeded from your live roster |
| recoup-platform-api-access | Call the Recoup API & external connectors directly |
| recoup-platform-capture-lesson | Capture a reusable lesson (compounding memory) |
internal — Recoup staff only (gated by the recoup-internal keyword)
OFF by default. These fire only when the request explicitly includes
recoup-internal. They operate Recoup's own engineering and go-to-market systems — never customer-facing work.
| Skill | What it does |
|---|---|
| recoup-internal-dev-issue-tracker | Write & maintain high-signal GitHub tracking issues |
| recoup-internal-dev-ship-issue | Deliver a tracked issue end-to-end (docs-first, TDD) |
| recoup-internal-eval-skill-benchmark | Benchmark a skill pack/plugin against the frontier |
| recoup-internal-sales | Daily sales sweep across Stripe/Privy/valuations/Attio/credits/tasks/chats → one ranked follow-up list |
| recoup-internal-funnel-valuation-pipeline | Work the Attio catalog-valuation sales funnel |
| recoup-internal-account-health-report | Account-health snapshot for any Recoup account |
| recoup-internal-marketing | The daily marketing run on our own accounts: workspace canon → socials scrape → topic pick → build → handoff |
| recoup-internal-social-ship-posts | Draft, publish & measure LinkedIn/X posts |
What else ships
Beyond the skills, the plugin bundles shared components at the repo root:
agents/— specialized subagents (deal QC, market scout, royalty audit, rights chain, valuation sensitivity, metadata reconciler, release readiness, research analyst)hooks/— completion-gate and environment-check hooksreferences/,templates/,fixtures/— shared docs, workspace scaffolds, and golden/demo dataRESOLVER.md— the routing table the agent uses to pick a skillscripts/— repo validators (portability, vendoring, manifests, resolver reachability + eval)
Creating a Skill
Every skill needs:
- A
SKILL.mdfile with YAML frontmatter (name+description) - A clear description that tells the agent when to use it
- Instructions the agent follows to complete the task
skills/
└── my-skill/
├── SKILL.md ← required
├── references/ ← optional — docs loaded on-demand
├── scripts/ ← optional — executable code
├── templates/ ← optional — scaffold files copied into a workspace
└── fixtures/ ← optional — sample / golden data
Add a route for the new skill in RESOLVER.md and a fixture in resolver-eval.jsonl — CI fails on unreachable skills. See contributing.md for guidelines.
About
Recoup is an AI-powered music platform. These skills power the agents that help artists and labels manage their careers.
- Website: recoupable.com
- Support: [email protected]
Loading...
Select a file to preview
Analyzing security...
Checking scan reports and verification data.
Bill of Materials
Everything this skill can do — files, network, commands, and more.