-
Notifications
You must be signed in to change notification settings - Fork 0
feat: Register all 4 plugins in marketplace #12
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| 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"] | ||
| } | ||
| ] | ||
| } |
| 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 | ||||||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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
doneRepository: recoupable/marketplace Length of output: 11478 Align the marketplace slug
♻️ Proposed fix-/plugin marketplace add recoupable/plugins
+/plugin marketplace add recoupable-plugins📝 Committable suggestion
Suggested change
🤖 Prompt for AI Agents |
||||||
|
|
||||||
| # 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 | ||||||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. P3: Structure directory tree is misleading — Prompt for AI agents |
||||||
| ├── .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) | ||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
P2: The
recoup-catalogs-plugindirectory 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