From 1386cfa45c9aab9f9c8c8caf3dbb539c14f823ea Mon Sep 17 00:00:00 2001 From: Cosmo Date: Tue, 7 Jul 2026 01:02:57 -0400 Subject: [PATCH] feat: register platform, content, and research plugins in marketplace - Add recoup-platform-plugin, recoup-content-plugin, recoup-research-plugin to Claude Code and Codex marketplace registries - Fix recoup-research-plugin Codex manifest (missing skills + interface fields) - Update README with full plugin catalog (4 plugins, 21 skills), install instructions for all 3 agent platforms - Track new plugin directories --- .agents/plugins/marketplace.json | 101 +++++++++++++++++----- .claude-plugin/marketplace.json | 78 ++++++++++++----- README.md | 143 +++++++++++++++++++++++-------- recoup-catalogs-plugin | 1 + recoup-content-plugin | 1 + recoup-platform-plugin | 1 + recoup-research-plugin | 1 + 7 files changed, 248 insertions(+), 78 deletions(-) create mode 160000 recoup-catalogs-plugin create mode 160000 recoup-content-plugin create mode 160000 recoup-platform-plugin create mode 160000 recoup-research-plugin diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json index c02c56a..11db259 100644 --- a/.agents/plugins/marketplace.json +++ b/.agents/plugins/marketplace.json @@ -1,46 +1,105 @@ { "name": "recoupable-plugins", "owner": { - "name": "Recoupable", + "name": "Recoup", "email": "agent@recoupable.com", "url": "https://recoupable.com" }, "plugins": [ { - "name": "music-catalog-diligence", - "source": { - "path": "./music-catalog-diligence" + "name": "recoup-platform-plugin", + "source": { "path": "./recoup-platform-plugin" }, + "version": "0.2.0", + "description": "Onboarding, health checks, and cross-cutting helpers for working with the Recoup platform from inside Codex.", + "author": { + "name": "Recoup", + "email": "support@recoupable.com", + "url": "https://recoupable.com" + }, + "homepage": "https://recoupable.com", + "repository": "https://github.com/recoupable/recoup-platform-plugin", + "license": "Apache-2.0", + "keywords": ["recoup", "recoup-platform", "music", "ai-agents", "agent-skills", "onboarding", "platform-tooling"], + "interface": { + "displayName": "Recoup Platform", + "shortDescription": "Onboarding and health checks for AI agents using the Recoup music platform", + "longDescription": "The Recoup platform plugin helps AI agents get started with Recoup's music business infrastructure. Includes guided onboarding (API validation, capability discovery, demo queries), health diagnostics, and cross-cutting helpers. Install this first, then add domain plugins (research, content, catalog diligence) based on your workflow.", + "developerName": "Recoup", + "category": "Music", + "capabilities": ["Read"], + "websiteURL": "https://recoupable.com", + "brandColor": "#345A5D" + } + }, + { + "name": "recoup-research-plugin", + "source": { "path": "./recoup-research-plugin" }, + "version": "0.1.0", + "description": "Music industry research: artist analytics, audience insights, playlist intelligence, competitive analysis, trend detection, and outreach — powered by Recoup's research API.", + "author": { + "name": "Recoup", + "email": "support@recoupable.com", + "url": "https://recoupable.com" + }, + "homepage": "https://recoupable.com", + "repository": "https://github.com/recoupable/recoup-research-plugin", + "license": "Apache-2.0", + "keywords": ["music", "research", "artist-analytics", "playlist-pitching", "audience-analysis", "competitive-analysis", "trend-detection", "chartmetric", "music-industry", "agent-skills"], + "interface": { + "displayName": "Recoup Research", + "shortDescription": "Music industry research — artist analytics, audience insights, playlist intelligence, and competitive analysis", + "longDescription": "Full-spectrum music industry research for AI agents. Run artist deep dives, analyze audience demographics, scout playlists for pitching opportunities, benchmark against competitors, detect emerging trends, and generate outreach for industry contacts. Powered by Recoup's research API with Chartmetric, Spotify, and social platform data.", + "developerName": "Recoup", + "category": "Music", + "capabilities": ["Read"], + "websiteURL": "https://recoupable.com", + "brandColor": "#345A5D" + } + }, + { + "name": "recoup-content-plugin", + "source": { "path": "./recoup-content-plugin" }, + "version": "0.3.0", + "description": "Generate, edit, and publish content for artists across Recoup's surfaces.", + "author": { + "name": "Recoup", + "email": "support@recoupable.com", + "url": "https://recoupable.com" }, + "homepage": "https://recoupable.com", + "repository": "https://github.com/recoupable/recoup-content-plugin", + "license": "Apache-2.0", + "keywords": ["recoup", "recoup-content", "music", "content-creation", "ai-agents", "agent-skills", "artist-marketing"], + "interface": { + "displayName": "Recoup Content", + "shortDescription": "Generate, edit, and publish artist content for Recoup", + "longDescription": "A content workflows plugin for Recoup. Bundles skills and commands that help AI agents draft, edit, and publish content for artists across Recoup's surfaces — short-form music videos, captions, images, and the supporting building blocks.", + "developerName": "Recoup", + "category": "Music", + "capabilities": ["Read", "Write"], + "websiteURL": "https://recoupable.com", + "brandColor": "#345A5D" + } + }, + { + "name": "music-catalog-diligence", + "source": { "path": "./music-catalog-diligence" }, "version": "0.1.0", "description": "Music catalog diligence with data-room ingestion, royalty normalization, rights checks, and valuation analysis.", "author": { - "name": "Recoupable", + "name": "Recoup", "email": "agent@recoupable.com", "url": "https://recoupable.com" }, "homepage": "https://recoupable.com", "repository": "https://github.com/recoupable/music-catalog-diligence", "license": "Apache-2.0", - "keywords": [ - "music", - "catalogs", - "diligence", - "royalties", - "music-rights", - "data-room", - "valuation", - "catalog-diligence", - "seller-prep", - "financing", - "chain-of-title", - "royalty-audit", - "agent-skills" - ], + "keywords": ["music", "catalogs", "diligence", "royalties", "music-rights", "data-room", "valuation", "catalog-diligence", "seller-prep", "financing", "chain-of-title", "royalty-audit", "agent-skills"], "interface": { "displayName": "Music Catalog Diligence", "shortDescription": "Music catalog diligence and valuation skills for AI agents", "longDescription": "Turn messy catalog data rooms into source-cited deal packages with normalized royalty data, rights exceptions, valuation workpapers, and buyer, seller, or lender-ready memos.", - "developerName": "Recoupable", + "developerName": "Recoup", "category": "Music", "capabilities": ["Read", "Write"], "websiteURL": "https://recoupable.com", diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 5dadf7d..7db3dd2 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,46 +1,78 @@ { "name": "recoupable-plugins", "owner": { - "name": "Recoupable", + "name": "Recoup", "email": "agent@recoupable.com", "url": "https://recoupable.com" }, "plugins": [ + { + "name": "recoup-platform-plugin", + "source": "./recoup-platform-plugin", + "description": "Claude Code plugin for the Recoup platform — onboarding, health checks, and cross-cutting helpers for working with Recoup's API and agent ecosystem.", + "version": "0.2.0", + "author": { + "name": "Recoup", + "email": "support@recoupable.com", + "url": "https://recoupable.com" + }, + "homepage": "https://recoupable.com", + "repository": "https://github.com/recoupable/recoup-platform-plugin", + "license": "Apache-2.0", + "keywords": ["recoup", "recoup-platform", "music", "ai-agents", "agent-skills", "onboarding", "platform-tooling"], + "category": "Music", + "tags": ["onboarding", "health-check", "platform"] + }, + { + "name": "recoup-research-plugin", + "source": "./recoup-research-plugin", + "description": "Music industry research: artist analytics, audience insights, playlist intelligence, competitive analysis, trend detection, and outreach — powered by Recoup's research API.", + "version": "0.1.0", + "author": { + "name": "Recoup", + "email": "support@recoupable.com", + "url": "https://recoupable.com" + }, + "homepage": "https://recoupable.com", + "repository": "https://github.com/recoupable/recoup-research-plugin", + "license": "Apache-2.0", + "keywords": ["music", "research", "artist-analytics", "playlist-pitching", "audience-analysis", "competitive-analysis", "trend-detection", "chartmetric", "music-industry", "agent-skills"], + "category": "Music", + "tags": ["research", "analytics", "audience", "playlists", "trends"] + }, + { + "name": "recoup-content-plugin", + "source": "./recoup-content-plugin", + "description": "Claude Code plugin for Recoup content workflows — generating, editing, and publishing content for artists across Recoup's surfaces.", + "version": "0.3.0", + "author": { + "name": "Recoup", + "email": "support@recoupable.com", + "url": "https://recoupable.com" + }, + "homepage": "https://recoupable.com", + "repository": "https://github.com/recoupable/recoup-content-plugin", + "license": "Apache-2.0", + "keywords": ["recoup", "recoup-content", "music", "content-creation", "ai-agents", "agent-skills", "artist-marketing"], + "category": "Music", + "tags": ["content", "video", "social", "publishing"] + }, { "name": "music-catalog-diligence", "source": "./music-catalog-diligence", "description": "Music catalog diligence with data-room ingestion, royalty normalization, rights checks, and valuation analysis.", "version": "0.1.0", "author": { - "name": "Recoupable", + "name": "Recoup", "email": "agent@recoupable.com", "url": "https://recoupable.com" }, "homepage": "https://recoupable.com", "repository": "https://github.com/recoupable/music-catalog-diligence", "license": "Apache-2.0", - "keywords": [ - "music", - "catalogs", - "diligence", - "royalties", - "music-rights", - "data-room", - "valuation", - "catalog-diligence", - "seller-prep", - "financing", - "chain-of-title", - "royalty-audit", - "agent-skills" - ], + "keywords": ["music", "catalogs", "diligence", "royalties", "music-rights", "data-room", "valuation", "catalog-diligence", "seller-prep", "financing", "chain-of-title", "royalty-audit", "agent-skills"], "category": "Music", - "tags": [ - "music-catalog-diligence", - "royalty-normalization", - "rights-diligence", - "valuation" - ] + "tags": ["music-catalog-diligence", "royalty-normalization", "rights-diligence", "valuation"] } ] } diff --git a/README.md b/README.md index 0f371af..e068a93 100644 --- a/README.md +++ b/README.md @@ -1,52 +1,127 @@ -# Recoupable Plugins +# Recoup Plugins -Registry repo for Recoupable agent plugins. - -This repo is a curated plugin marketplace for Claude Code and Codex. Each -plugin lives as its own Git submodule so it can be developed, versioned, and -distributed independently. +Official plugin marketplace for Recoup's AI agent platform. Each plugin gives AI agents (Claude Code, Codex, Cursor) direct access to Recoup's music business infrastructure. ## Plugins -| Plugin | Purpose | -| ------ | ------- | -| `music-catalog-diligence` | Music catalog diligence with data-room ingestion, royalty normalization, rights checks, and valuation analysis. | +Install **recoup-platform-plugin** first — it validates your setup and discovers capabilities. Then add domain plugins based on your workflow. + +| Plugin | Skills | What it does | +| ------ | ------ | ------------ | +| `recoup-platform-plugin` | 2 | **Start here.** Onboarding, health checks, and cross-cutting helpers for the Recoup API and agent ecosystem. | +| `recoup-research-plugin` | 7 | Artist analytics, audience insights, playlist intelligence, competitive analysis, trend detection, and outreach. | +| `recoup-content-plugin` | 3 | End-to-end content workflows — short-form music videos, captions, images, and publishing for artists. | +| `music-catalog-diligence` | 9 | Catalog diligence — data-room ingestion, royalty normalization, rights checks, valuation, and deal packaging. | + +**Total: 4 plugins, 21 skills.** + +## Install -## Install with Claude Code +### Claude Code -Add the marketplace, then install the plugin you need: +Add the marketplace, then install what you need: ```bash /plugin marketplace add recoupable/plugins + +# Install the platform plugin first +/plugin install recoup-platform-plugin@recoupable-plugins + +# Then add domain plugins +/plugin install recoup-research-plugin@recoupable-plugins +/plugin install recoup-content-plugin@recoupable-plugins /plugin install music-catalog-diligence@recoupable-plugins ``` -Claude Code reads the marketplace from -`.claude-plugin/marketplace.json`. Plugin entries use relative `source` paths -that resolve from this registry repo. +### Codex -## Install with Codex +```bash +codex plugin install https://github.com/recoupable/recoup-platform-plugin +codex plugin install https://github.com/recoupable/recoup-research-plugin +codex plugin install https://github.com/recoupable/recoup-content-plugin +codex plugin install https://github.com/recoupable/music-catalog-diligence +``` + +### Cursor + +1. Cursor → Settings → Plugins → **Add custom plugin**. +2. Paste the GitHub URL for each plugin. +3. Restart Cursor so manifests load. + +## Quick start + +After installing `recoup-platform-plugin`, set your API key and run the onboarding: + +```bash +export RECOUP_API_KEY="recoup_sk_..." # https://developers.recoupable.com/agents +``` -Codex reads the repo-scoped marketplace from -`.agents/plugins/marketplace.json`. Each listed plugin points to a folder that -contains a `.codex-plugin/plugin.json` manifest. +Then in a new chat: + +> **Get me started with Recoup** + +The agent validates your key, discovers available capabilities, runs a demo query, and recommends which domain plugins to install next. + +## Plugin details + +### recoup-platform-plugin (v0.2.0) + +The entry point. Two skills: +- `recoup-getting-started` — first-run onboarding, API validation, capability discovery, demo query +- `recoup-health-check` — diagnostics for API connectivity, auth, credit balance, plugin status + +### recoup-research-plugin (v0.1.0) + +Seven research skills: +- `recoup-artist-research` — deep-dive artist analytics +- `recoup-audience-analysis` — demographic and psychographic audience insights +- `recoup-competitive-analysis` — benchmark against competitors +- `recoup-playlist-intelligence` — scout and analyze playlists for pitching +- `recoup-trend-detection` — emerging trends in music data +- `recoup-people-outreach` — industry contact outreach generation +- `recoup-web-intelligence` — web-based research and intelligence gathering + +### recoup-content-plugin (v0.3.0) + +Three content skills: +- `recoup-content-create` — front-door command: artist name → finished 9:16 social-ready clip +- `short-video` — end-to-end playbook for producing short-form music videos +- `content-creation` — atomic primitives for images, videos (6 modes), captions, transcription, editing + +### music-catalog-diligence (v0.1.0) + +Nine diligence skills: +- `diligence-kickoff` — start a new catalog diligence project +- `catalog-ingest` — ingest and normalize data room files +- `catalog-analysis` — analyze catalog composition and performance +- `royalty-audit` — audit royalty statements and flag anomalies +- `rights-diligence` — chain-of-title and rights verification +- `financing-underwrite` — build underwriting models for catalog financing +- `ic-memo-package` — generate investment committee memo packages +- `seller-prep` — prepare seller-side diligence materials +- `post-close-admin` — post-acquisition administrative workflows + +## Structure + +```text +plugins/ +├── .claude-plugin/marketplace.json # Claude Code marketplace registry +├── .agents/plugins/marketplace.json # Codex marketplace registry +├── recoup-platform-plugin/ # Platform onboarding + health +├── recoup-research-plugin/ # Research & analytics +├── recoup-content-plugin/ # Content creation & publishing +├── music-catalog-diligence/ # Catalog diligence (submodule) +├── AGENTS.md # Agent guidance +├── CLAUDE.md # Claude Code guidance +└── README.md +``` -The current Codex surface for `music-catalog-diligence` packages the bundled -`skills/` directory. Claude-specific `commands/` and `agents/` remain available -through Claude Code, but they are not advertised as Codex features until Codex -supports that packaging path. +## Support -## Release checklist +- Docs: [developers.recoupable.com](https://developers.recoupable.com) +- Email: support@recoupable.com +- Website: [recoupable.com](https://recoupable.com) -Before adding or updating a plugin in this registry, verify these requirements: +## License -- Add or update `.claude-plugin/plugin.json`. -- Add or update `.codex-plugin/plugin.json` when the plugin supports Codex. -- Keep all manifest paths relative to the plugin root. -- Use semantic versions and bump the version for release updates. -- Include a `README.md`, `LICENSE`, and support contact. -- Keep secrets out of plugin content and reference environment variables - instead. -- Document required external tools and make scripts work across macOS and Linux - when possible. -- Run plugin-specific tests, fixture checks, and JSON validation before release. +[Apache-2.0](./LICENSE) diff --git a/recoup-catalogs-plugin b/recoup-catalogs-plugin new file mode 160000 index 0000000..db83138 --- /dev/null +++ b/recoup-catalogs-plugin @@ -0,0 +1 @@ +Subproject commit db8313878634ea3702878129c823b1db6fdaf874 diff --git a/recoup-content-plugin b/recoup-content-plugin new file mode 160000 index 0000000..0007759 --- /dev/null +++ b/recoup-content-plugin @@ -0,0 +1 @@ +Subproject commit 00077595812cc7840837102c1c58626c0f4f40c6 diff --git a/recoup-platform-plugin b/recoup-platform-plugin new file mode 160000 index 0000000..66c344d --- /dev/null +++ b/recoup-platform-plugin @@ -0,0 +1 @@ +Subproject commit 66c344db68bd475a62f39f0517e0f7779cce7148 diff --git a/recoup-research-plugin b/recoup-research-plugin new file mode 160000 index 0000000..817b061 --- /dev/null +++ b/recoup-research-plugin @@ -0,0 +1 @@ +Subproject commit 817b06145304374e88541606144d69b9327c93e4