From recoup-deals
Use when analyzing or valuing a music catalog for acquisition, financing, sale, or investment deal review, or when refreshing the analysis after editing ingest output or assumptions. Triggers include "catalog valuation", "music catalog analysis", "project catalog value", "what is this catalog worth", "NPS multiple", "NLS multiple", "quality of earnings", "royalty cash flows", "catalog acquisition", "recoupment cliff", "PRO bonus", "normalize royalties", "refresh the analysis", "rerun the valuation", "update the workpapers", or "build an investment memo" for publishing or master rights.
How this skill is triggered — by the user, by Claude, or both
Slash command
/recoup-deals:recoup-deal-analysisThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Analyze normalized music catalog cash flows and project value. Do not apply a
evals/evals.jsonreferences/deal-workspace.mdreferences/financing-underwrite.mdreferences/output-templates.mdreferences/post-close-admin.mdreferences/pro-performance-income.mdreferences/red-flags.mdreferences/rights-review.mdreferences/royalty-audit.mdreferences/seller-prep.mdreferences/valuation-framework.mdscripts/_helpers.pyscripts/calculate-concentration.pyscripts/calculate-nps-nls-bridge.pyscripts/run-deal-checks.pyscripts/validate-dashboard.pyscripts/validate-deal-workspace.pyscripts/validate-evidence-ledger.pyscripts/validate-findings-evidence.pyscripts/validate-normalized-ledger.pyAnalyze normalized music catalog cash flows and project value. Do not apply a multiple to headline royalties until you understand what income is sustainable, what rights are supported, and what risks change the buyer's actual cash flow.
Start here based on the user request:
NPS).NLS), recoupment, reserves,
artist royalties, producer points, and distribution fees.If inputs are too incomplete, say what cannot be valued yet and list the minimum files needed.
Run deterministic scripts from scripts/ when the required files exist:
calculate-concentration.py for song, platform, territory, and source risk.calculate-nps-nls-bridge.py for reported-to-normalized cash-flow bridges.validate-evidence-ledger.py before relying on memo citations.Always show a bridge from reported royalties to underwritable earnings:
Reported LTM NPS/NLS
- one-time sync and direct-license spikes
- viral, playlist, death-bump, or campaign spikes
- settlement, audit recovery, and accounting catch-up income
- non-repeat PRO bonus or premium income
+/- current run-rate trend adjustment
+/- admin, collection, reserve, recoupment, or contract adjustment
+/- undercollection or missing-registration adjustment
= Normalized run-rate NPS/NLS
Use real source amounts when available. If you must illustrate, label the number as illustrative and do not mix it into the final valuation.
NPS x multiple can be wrong. Multiples apply to sustainable
underwritable earnings, not whatever happened in the last twelve months.Use these outputs for a full analysis:
Templates and memo structure are in
references/output-templates.md.
When working inside a deal workspace (not a one-off valuation question):
python3 scripts/run-deal-checks.py deals/{deal-id} first. Cure
validator failures before analysis.workpapers/nps-bridge.json, workpapers/nls-bridge.json,
and workpapers/valuation-summary.json (with normalized and scenarios
keys — see recoup-deal-start Phase 4 for the schema).python3 scripts/calculate-concentration.py and
python3 scripts/calculate-nps-nls-bridge.py when normalized inputs exist.python3 scripts/validate-dashboard.py deals/{deal-id}.Label quick estimates as preliminary. Do not finalize a valuation while material
blockers (split sheets, recoupment schedules, sample clearances, chain-of-title
gaps) remain open in findings/findings.json.
✅ Analysis layer in place.
Headline:
Normalized NPS run-rate $X.
Normalized NLS NPV / run-rate $Y.
Preliminary value bracket: $LOW – $HIGH.
N material blockers · K high-severity items.
Open: deals/{deal-id}/DASHBOARD.html
Next:
recoup-deal-dashboard — refresh DASHBOARD.html + run the pre-share QC gate
recoup-deal-report — assemble the IC memo and export a shareable PDF
This skill is the single diligence surface for the plugin. The valuation workflow above is the spine; pull in the matching deep-dive when a deal's shape calls for it. Each reference is a self-contained playbook.
| When the deal involves… | Read |
|---|---|
| Splits, assignments, samples, reversions, chain of title | references/rights-review.md |
| Gross-to-net, duplicate imports, retro adjustments, suspicious spikes | references/royalty-audit.md |
| A lender / advance / debt sizing against catalog cash flow | references/financing-underwrite.md |
| Prepping a seller's catalog before going to market | references/seller-prep.md |
| Administering a catalog after the deal closes | references/post-close-admin.md |
For the buy-side material deal, run the rights review and royalty audit
deep-dives together with the valuation spine — those are the three
specialist lenses dispatched in parallel by recoup-deal-start Phase 3.
references/valuation-framework.md.references/pro-performance-income.md.references/red-flags.md.references/output-templates.md.references/deal-workspace.md.npx claudepluginhub recoupable/skillsProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Searches MemPalace before answering questions about past work, people, projects, or prior decisions. Returns verbatim stored content instead of guessing from model memory.