Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
101 changes: 80 additions & 21 deletions .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,46 +1,105 @@
{

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: The recoup-catalogs-plugin directory exists at the repository root but is not registered in either the Codex or Claude Code marketplace. Agents won't discover or be able to install it through the marketplace registries. Either register it in both marketplace JSON files (consistent with the other four plugins), or remove the directory if it is stale or not yet ready for publication.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At .agents/plugins/marketplace.json, line 11:

<comment>The `recoup-catalogs-plugin` directory exists at the repository root but is not registered in either the Codex or Claude Code marketplace. Agents won't discover or be able to install it through the marketplace registries. Either register it in both marketplace JSON files (consistent with the other four plugins), or remove the directory if it is stale or not yet ready for publication.</comment>

<file context>
@@ -1,46 +1,105 @@
-      "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.",
</file context>

"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",
Expand Down
78 changes: 55 additions & 23 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -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"]
}
]
}
143 changes: 109 additions & 34 deletions README.md
Original file line number Diff line number Diff line change
@@ -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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf 'Files:\n'
git ls-files | rg '(^README\.md$|marketplace\.json$|plugin)' || true

printf '\nRelevant README lines:\n'
cat -n README.md | sed -n '18,32p'

printf '\nMarketplace manifests:\n'
for f in .claude-plugin/marketplace.json .agents/plugins/marketplace.json; do
  if [ -f "$f" ]; then
    echo "--- $f"
    cat -n "$f"
  fi
done

Repository: recoupable/marketplace

Length of output: 11478


Align the marketplace slug

/plugin marketplace add recoupable/plugins does not match the marketplace name published in both manifests (recoupable-plugins), so this install step points at the wrong identifier. Update the README to use the actual slug.

♻️ Proposed fix
-/plugin marketplace add recoupable/plugins
+/plugin marketplace add recoupable-plugins
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
/plugin marketplace add recoupable/plugins
/plugin marketplace add recoupable-plugins
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` at line 25, The README install command uses the wrong marketplace
slug, so update the marketplace add instruction to match the published
identifier used by the manifests. Locate the `/plugin marketplace add` entry in
README and replace the current slug with the actual marketplace name, consistent
with the recoupable-plugins manifests.


# 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

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: Structure directory tree is misleading — plugins/ wrapper dir doesn't exist and all items shown are at the repo root. The tree should either drop the plugins/ heading or restructure to show actual nesting (e.g. .claude-plugin/marketplace.json is two levels deep under the hidden .claude-plugin/ dir, not a direct child). New contributors will misread the repo layout.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At README.md, line 108:

<comment>Structure directory tree is misleading — `plugins/` wrapper dir doesn't exist and all items shown are at the repo root. The tree should either drop the `plugins/` heading or restructure to show actual nesting (e.g. `.claude-plugin/marketplace.json` is two levels deep under the hidden `.claude-plugin/` dir, not a direct child). New contributors will misread the repo layout.</comment>

<file context>
@@ -1,52 +1,127 @@
+
+```text
+plugins/
+├── .claude-plugin/marketplace.json     # Claude Code marketplace registry
+├── .agents/plugins/marketplace.json    # Codex marketplace registry
+├── recoup-platform-plugin/             # Platform onboarding + health
</file context>

├── .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)
1 change: 1 addition & 0 deletions recoup-catalogs-plugin
Submodule recoup-catalogs-plugin added at db8313
1 change: 1 addition & 0 deletions recoup-content-plugin
Submodule recoup-content-plugin added at 000775
1 change: 1 addition & 0 deletions recoup-platform-plugin
Submodule recoup-platform-plugin added at 66c344
1 change: 1 addition & 0 deletions recoup-research-plugin
Submodule recoup-research-plugin added at 817b06