Recoup

Manage music releases using RELEASE.md documents stored in releases/{release-slug}/ within an artist workspace. Triggers when the user mentions an artist's album, EP, single, or project — or asks about release planning, DSP pitches, metadata, marketing, press materials, physical production, or tour coordination. First infer which artist and release the user means, then find or create the RELEASE.md. Use this skill to create, update, or pull data from release documents, and to generate deliverables like DSP pitches, press one-sheets, and production specs.

Set up the initial file system for a new sandbox. Fetches the account's organizations and artists via the Recoup CLI and scaffolds the folder structure. Use when a sandbox has just been created and has no existing file system. Before running, check if the sandbox already has an orgs/ directory — if it does, this skill is not needed.

How to work in artist directories. Use when adding or updating artist context (identity, brand, voice, audience), adding songs, organizing files inside an artist directory, or figuring out where something belongs. Also use when the user mentions an artist by name and the task involves their files, context, or content — even if they don't say "artist directory." This includes tasks like researching an artist, creating content for an artist, updating an artist's brand, or adding a face guide.

Turn one song into placement materials from its audio — a playlist/editorial pitch and a music-supervisor sync brief, grounded in the song's actual sound. Use for "playlist pitch", "pitch to Spotify", "sync brief", or "where could this be placed". Requires a public audio URL. For catalog-wide playlist strategy (no audio) use recoup-research-playlist-targets.

Find the most clip-worthy 5–15 seconds of a song to lead short-form content with — the moment where energy, a section change, and a quotable line coincide. Use for "find the hook", "best 15 seconds to clip", "what to clip", or "where's the drop". Requires a public audio URL. Hand the timestamps to recoup-content-make-video to build the clip.

Understand one song from its audio using Recoup's audio model (Music Flamingo) — full report, catalog metadata (BPM/key/genre/mood), a sectioned lyric sheet, or a mix critique. Use for "analyze this song", "what key/BPM/genre is this", "tag this track", "transcribe the lyrics", or "critique the mix". Requires a public audio URL. To find the clip-worthy moment use recoup-song-find-hook; for placement materials use recoup-song-placement-pitch.

Create an original song through the Recoup API with user approval at each stage — idea, genre, lyrics and prompt, then generation. Use for making a new song or a song for a video, including requests to choose a MiniMax Music 3 genre. Builds on recoup-minimax-music-3 production notes. Stops at the audio; does not make or publish a video.

Bootstrap an empty org's roster — when the account has no artists yet, gather the label's roster (names or a pasted list) and onboard them all by fanning recoup-roster-add-artist out across parallel subagents (each runs the full create → enrich chain), optionally scouting talent first. Use for "set up our roster", "we have no artists yet", "onboard our whole roster", "import these artists", or when recoup-platform-build-os / recoup-platform-connect-account finds an empty roster. For a single artist use recoup-roster-add-artist; to see the roster use recoup-roster-list-artists.

Work inside one artist's folder — read and update their context, brand, songs, and releases. Use for "organize [artist]'s files", "update [artist]'s brand/context", "what's in [artist]'s workspace", or any task about a named artist's files. To list your whole roster use recoup-roster-list-artists; for research/metrics on an artist use recoup-research-artist-overview.

See who's on your roster — answers "what artists do I have" by walking the workspace and falling back to your live account when the filesystem is empty. Use for "what artists do I have", "list my roster", "who's on my roster", or "what's in this sandbox". To add a new artist use recoup-roster-add-artist; to work inside one artist's files use recoup-roster-manage-artist.

Onboard a brand-new artist to your roster and enrich them — the 8-call chain (create → Spotify match → research → catalog → socials → knowledge base) that sets up the artist and their workspace folder. Use for "create/add/onboard an artist", "set up [artist]", "we just signed [artist]", or "new signing". To see your roster use recoup-roster-list-artists; to work inside an existing artist's files use recoup-roster-manage-artist.

The recurring "what changed this week" update for an artist — streaming/social deltas vs the last run, milestones, and a spike/drop check. Use for "weekly brief", "what's new this week", "what changed for [artist]", or "are streams spiking or dropping". Recurring and dated; diffs against your own prior file. For a one-time full sweep use recoup-research-artist-overview.

Research anything on the open web — quick ranked search, deep cited narrative, read specific URLs, and enrich any entity (label, venue, brand, person) into structured facts. Use for "search the web", "deep research [topic]", "what does this URL say", "enrich [company/label/person]", or as the fallback when structured artist data is thin. Not artist-only. For metrics on a known artist use recoup-research-artist-overview.

Find which playlists an artist or whole catalog should target and where the placement gaps are — catalog-wide playlist strategy from research data. Use for "which playlists should we target", "placement gaps", "editorial vs algorithmic", or "which catalog tracks to push". This is desk strategy from data; to pitch ONE song from its audio use recoup-song-placement-pitch.

Find emerging or unsigned artists you don't already track — A&R scouting that fans out from an anchor artist and sizes candidates, plus "why did this song go viral". Use for "find emerging artists", "A&R scouting", "who should we sign", "scout new talent in [genre]", or "why did [song] go viral". For research on an artist you already have, use recoup-research-artist-overview.

Find music-industry people — managers, A&R, press, label and booking contacts — and draft outreach you can send. Use for "find the manager for [artist]", "who's the A&R at [label]", "find press contacts", or "draft outreach to [person]". Drafts only; never sends. To research an artist's metrics and audience use recoup-research-artist-overview.

Full research sweep on one of your artists — profile, streaming metrics, audience demographics/geography, competitive position, and which songs are popping on TikTok. Use for "research [artist]", "tell me about [artist]", "how are they doing", "where are the fans", "compare [a] vs [b]", "find collaborators", "when to release", or "which of their songs are blowing up on TikTok". Modes: overview, audience, competition, tiktok. For finding NEW artists use recoup-research-find-talent; for a recurring update use recoup-research-weekly-brief.

Confirm a release actually dropped and build a launch-day alert — checks whether the single/album went live and surfaces the first-day signals. Use for "did [artist]'s single drop", "launch alert", or "watch for the drop". Idempotent and dated; saves to the release workspace. For ongoing weekly streaming-spike watching use recoup-research-weekly-brief.

Plan and run a music release end to end — scaffold the workspace, write the creative brief, build the dated rollout schedule, produce the master RELEASE.md + DSP pitch + one-sheet, target playlists, and arm monitoring. Use for "start/plan a release", "take [title] start to finish", "creative brief", "rollout schedule", or "RELEASE.md / DSP pitch / one-sheet". Modes: plan (default, full workflow), brief, campaign, doc. Everything lands in releases/{artist}/{release}/. To confirm the drop afterward use recoup-release-track-drop.

Check how far a Recoup account has gotten in onboarding and drive it to the next step. Measures the account against the eight activation checkpoints (artist added, socials connected, first chat, valuation run, catalog claimed, first scheduled task, paying) using the caller's own API key, then routes to the skill that completes the next step. Use for "where am I in my Recoup setup", "what should I do next", "did I finish onboarding", "onboarding status", "activation checklist", "how set up is my account", or after recoup-platform-connect-account finishes first-run setup. Read-only; never performs the steps itself — it routes.

Send an email via the Recoup API the reliable way — a Node helper that serializes the body correctly and fails loudly instead of sending an empty email. Use whenever a task needs to email a report/summary/notification to the account owner or a recipient. ALWAYS use this script to send email; never hand-build `curl … -d "{…}"` with inline `jq`/shell interpolation (that silently produces empty "Message from Recoup" footer-only emails). Pairs with recoup-platform-api-access (which it sends through).

Connect your real Recoup account so the rest of the box can act for you — first-run email/PIN verification that mints an API key tied to your account, persists it locally, and seeds memory. Use for "set up Recoup", "connect my account", "connect Claude to Recoup", "I just joined", or "log in". One-time/occasional. Scaffold folders / build your OS next with recoup-platform-build-os; for ongoing calls use recoup-platform-api-access.

Capture a solved problem or reusable lesson so the next run is cheaper — the box's compounding memory. Use when the user says "that worked", "remember this", "capture this learning", "save this so we don't redo it", "write this down for next time", or after a non-trivial fix/decision in any Recoup work. Writes one deduplicated learning into the workspace's learnings/ store and makes sure future agents can find it.

Scaffold and run a label's self-managing "music-company OS" inside its own git repo — the full label-intelligence workspace (folders, a self-managing CLAUDE.md mirrored to AGENTS.md, a read-only doctor + never-stale janitor, compound-learning and self-improvement loops, an in-place plugin) seeded with Recoup's conventions (top-level artists/{slug}/RECOUP.md identity files, releases/{slug}/RELEASE.md) and backed by the Recoup API as system of record. Use for "set up our label OS", "build the org workspace", "turn this repo into our label brain", or onboarding a new org/label repo. Pulls the real roster from the live account (auth via recoup-platform-connect-account), onboards artists API-first via recoup-roster-add-artist, and calls the other recoup-* skills (research/content/release/song/catalog) instead of reinventing them. The single workspace/OS builder — also covers the lightweight "just mirror my roster into folders" case.

Call the Recoup API and external connectors directly — fetch any platform resource (artists, socials, organizations, research, documents) and run connector actions (Google Docs/Sheets/Drive edits, Gmail, TikTok, Instagram). Use whenever you need raw Recoup data, a platform resource, to write curl against api.recoupable.dev, or to read/write something outside Recoup like a Google Doc URL or a spreadsheet. The plumbing every other skill rides on. To onboard or operate on an artist use the recoup-roster-* skills; for first-run connection use recoup-platform-connect-account.

Measure an artist's onchain NFT earnings from public chain data and fold them into a catalog valuation without inflating it. Use for "what did this artist earn from NFTs", "value an NFT artist's catalog", "include NFT sales in the valuation", "measure Zora/Foundation/Sound sales", or any catalog valuation where the artist sold music NFTs. Streaming-only valuations understate web3-native artists — often by an order of magnitude.

Make a narrative music video using the Small Room workflow — approved song, story bible, scene audit, character audition, props, location plates, shot list, reviewed stills and end frames, motion, and verified edit. Use for "make a music video", "turn this song into a film", or "follow the Small Room workflow". Reuse approved audio; stops at the asset unless publishing is requested.

Generate an original song with MiniMax Music 3 on fal, for a film, an ad, a demo or a release. Covers the two inputs the model takes (a structured Caption and tagged Lyrics), how to write lyrics that survive generation, the exact fal call and its cost, and the checks to run on the returned audio before anything is built on top of it. Use when asked to "make a song", "generate a track", "write the song for this video", "score this", or when a music video needs a song that does not exist yet. For an artist's already-released song use recoup-internal-marketing's music-video.md instead; for analysing an existing recording use recoup-song-analyze-audio.

INTERNAL — Recoup staff tooling, gated by the recoup-internal keyword. Invoke ONLY when the request explicitly includes "recoup-internal" (e.g. "recoup-internal run the weekly usage review"). Never use for customer-facing or artist requests. Produce a fleet-wide, period-scoped business review of the Recoup platform: who logged in and visited the web UI, what changed in Stripe (signups, trials, billings, cancellations, paid roster), who consumed credits and on what, AI Gateway spend reconciled against the credits ledger, and which customers hold the most valuable catalogs. Use when asked for a "weekly usage review", "week in review", "what happened while I was gone", "who used the product this week", "business pulse", or a vacation catch-up. For a single account's deep dive use recoup-internal-account-health-report instead.

INTERNAL — Recoup staff tooling, gated by the recoup-internal keyword. Invoke ONLY when the request explicitly includes "recoup-internal" (e.g. "recoup-internal make a FaceTime ad"). Never use for customer-facing or artist requests. Produce a FaceTime-call-style ad — two people on a screen-recorded video call — where every talking-head clip is generated by Grok Imagine 1.5 on fal.ai speaking scripted dialogue verbatim, with native voice and lipsync (no TTS, no lipsync model). Use when the user wants a FaceTime call ad, a two-person conversation video, a Grok Imagine video, or an AI-talking-artist clip. Covers take structure around the 15s cap, the prompt grammar for word-perfect dialogue, the real-person likeness pipeline and consent gate, QC, assembly, and handoffs to hyperframes (chrome/render) and recoup-internal-social-ship-posts (publish/measure).

INTERNAL — Recoup staff tooling, gated by the recoup-internal keyword. Invoke ONLY when the request explicitly includes "recoup-internal" (e.g. "recoup-internal apply to this Upwork job"). Never use for customer-facing or artist requests. Find, win and close Upwork contract work end to end: run the daily pipeline, triage a client before writing anything, verify every claim against the actual repositories, draft the cover letter and screening answers, pick the right work-sample pack, set the rate, then follow up, handle the reply, run the call and convert a trial into ongoing work. Use when asked to "apply to this Upwork job", "write an Upwork proposal", "should I bid on this", "triage this client", "is this job worth connects", "find Upwork jobs worth applying to", "run the Upwork pipeline", "a client replied", "prep for the client call", "follow up on my proposals", "why is nothing converting", or when an Upwork job posting is pasted in. Requires a local workspace directory and read access to the repositories behind any claim being made.

INTERNAL — Recoup staff tooling. Never use for customer-facing or artist requests. Audit the health of scheduled-task emails over a time window: what the customer-prompt-task runs actually delivered, how many empty/malformed sends the API guard blocked, per-account/per-recipient breakdown, and whether agents used the reliable helper vs hand-rolled curl. Use when asked "how did the tasks run last night", "what emails went out from tasks", "are we still sending empty emails", "task email health", "did the empty-email fix hold". Produces a per-run table (one row per Trigger.dev `customer-prompt-task` run: run_id, recipient, prompt, email subject, body kb) plus a headline, a per-run **tool-call trace**, and a **`has_hallucinated_data`** / `expected_data_source` content check. Reads the Trigger.dev run list + `email_send_log` and `chats`/`chat_messages` (Supabase).

INTERNAL — Recoup staff tooling, gated by the recoup-internal keyword. Invoke ONLY when the request explicitly includes "recoup-internal" (e.g. "recoup-internal draft a launch post"). Never use for customer-facing or artist requests. Write and ship data-grounded LinkedIn and X (Twitter) posts for product announcements and artist highlights, and track how they perform. Use when the user wants to draft a LinkedIn or X post, announce a feature or launch, highlight an artist or a result, plan a content calendar, decide on a CTA, or asks "how did my last post do," "what should I post," "write a post about X," or "turn this into a post/thread." This is the post copy + publishing + measurement workflow; producing a demo video is a separate asset-production step.

INTERNAL Recoup staff sales workflow; invoke only for requests explicitly naming recoup-internal. Run the daily sales sweep across Stripe, Privy, valuations, both Attio funnels, credits, tasks, chats, and email history. Research and prioritize customers and cold prospects, maintain CRM follow-ups, and prepare outreach and meeting materials. Every email requires the user's explicit approval of the exact reviewed draft before sending. Use for sales sweeps, pipeline follow-up, cold outreach and podcast guest invites and nudges, new-lead research, and qualified-call prep. Requires Recoup API, Attio, Stripe, Privy and Supabase access; Exa for cold research. Never use for customer-facing or artist requests.

INTERNAL — Recoup staff tooling, gated by the recoup-internal keyword. Invoke ONLY when the request explicitly includes "recoup-internal" (e.g. "recoup-internal do today's marketing"). Never use for customer-facing or artist requests. The daily marketing run for one of our own social accounts, in order: read the account workspace (narrative canon, hook doctrine, video styles, post ledger), scrape the account's own socials to learn what is working and what flopped, pick today's topic (continue an arc, pull a logged idea, or draft a new one), then build the asset and hand off. Use when the user says "do today's marketing", "today's content run", "make today's video", "our hooks are weak", or asks what to post today for one of OUR OWN accounts. Runs the whole day end to end. Its stated goal: convert a free content viewer into a paying Recoup subscriber — and know which post did it; so the run opens on the funnel numbers and refuses to ship into a destination that cannot convert. **Not for a single post's copy** — drafting/publishing/measuring one LinkedIn or X post is recoup-internal-social-ship-posts, which this skill calls at step 5. Orchestrates: routes video production to the format skills and publish/measure to recoup-internal-social-ship-posts.

INTERNAL — Recoup staff tooling, gated by the recoup-internal keyword. Invoke ONLY when the request explicitly includes "recoup-internal" (e.g. "recoup-internal work the valuation funnel"). Never use for customer-facing or artist requests. Work the Recoup "Valuation Leads" sales funnel in Attio — take an inbound catalog-valuation lead and progress it from "valuation ran" to "signed up for Pro." Researches who the lead is and their relationship to the artist they valued, qualifies the catalog against revenue goals, enriches and advances the Attio CRM record, and drafts the first outreach email plus a clean one-page valuation PDF. Use when asked to "work the valuation funnel", "qualify this lead", "who ran this valuation", "is this catalog worth our time", "update the Attio pipeline", "advance this lead", "draft outreach for this valuation", or "turn valuation leads into Pro signups". Requires an Attio API key and a Recoup API key.

INTERNAL — Recoup staff tooling, gated by the recoup-internal keyword. Invoke ONLY when the request explicitly includes "recoup-internal" (e.g. "recoup-internal benchmark this skill pack"). Never use for customer-facing or artist requests. Benchmark ANY plugin, skill pack, or skills folder against the current frontier of skill/plugin design (gstack, gbrain, compound-engineering, PM OS). Use whenever someone wants to grade, audit, review, or compare a skills directory or plugin and asks things like "is this skill pack good?", "how does our plugin compare to the frontier?", "are these skills fat enough?", "should these skills be combined or split?", "what should we steal from gstack?", "benchmark this plugin", "rate my skills folder", or "audit this skill bundle". Works on any domain (engineering, music, finance, bio — anything) and any harness layout. It measures the pack deterministically (skill count, SKILL.md body sizes, tests/evals/resolver/hooks/learnings signals, catalog token budget, description-overlap risks), grades it on a 15-dimension scorecard, then produces a fat-enough / combine / split / parameterize diagnosis and a prioritized list of frontier moves to steal — each with its boundary. Do NOT use this to author a single new skill (use a skill-creator) or to run a pack's own tests.

INTERNAL — Recoup staff tooling. Never use for customer-facing or artist requests. Deliver a tracked GitHub issue end-to-end in the Recoup house style — documentation-driven (OpenAPI/contract first), then test-driven (red→green) implementation that matches the docs, verified against the live preview deployment, with results posted to the PR. Use when the user says "implement this issue", "build out issue

INTERNAL — Recoup staff tooling. Never use for customer-facing or artist requests. Write and maintain high-signal GitHub issues — especially long-lived tracking issues that coordinate multi-PR, multi-repo efforts — in the Recoup house style. Use when the user says "write an issue", "create a tracking issue", "open an issue for this work", "update the issue", "check off / close out an item", "log what shipped on the issue", "maintain the issue", or when capturing a plan, cutover, migration, or cleanup that spans more than one PR. Covers structure, the Open→Done lifecycle, evidence/linking rules, and acceptance criteria.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Capture a testimonial and logo rights. Use at a milestone, 30–60 days into an engagement, after a value review, or "ask for a testimonial".

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Apply the current Recoup identity across graphics, video, slides, proposals and interfaces. Resolves brand selection, packaged fonts and exact logos, cross-media composition, and visual checks; explicit client brands can override house identity.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Reconcile and health-check the whole workspace. Use on "audit the system", "is everything up to date", or periodically.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. The writing style for a quick update or recap to an external stakeholder (client sponsor, champion, exec, partner) after a session, milestone, or to flag a blocker plus an ask. Use on "draft an update to {name}", "recap the session for the client", "send {sponsor} a quick note", "status update", "check in with {stakeholder}". Runs on top of recoup-internal-consulting-outbound-email (the process) and recoup-internal-consulting-copy-writer (the voice), shaping them into a fast, scannable update built on simplicity, clarity, and play. Not for internal post-session notes (those are unfiltered, the owner's POV) and not the formal bi-weekly progress report (heavier) — this is the light note between them.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Generate a Statement of Work under the existing MSA. Use on "draft the SOW", "scope this engagement", after a deal is won, or when adding a new workstream/expansion.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Validate and package changes in the explicitly selected plugin repository, then publish only when authorized. Use for packaging, releasing, or refreshing skills.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Mine the external AI & Agents research wiki for content. Use on "harvest research", "content ideas from research", "mine the research wiki", on the Friday cadence, or whenever the configured research wiki has new material. Turns its cited analysis into atomic signals (signals/) that show the practice's agent/skill expertise — read-only; never copies wiki pages in.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Build a Quarterly Value Review for a client — the connective tissue between delivery, renewals, and proof. Use quarterly per client, "build the QBR for {client}", "value review". Good scheduled-task candidate.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Revive cold/dormant prospects from historical meeting data. Use on "who's gone cold", "resurrect dead deals", "mine my old prospects", quarterly pipeline reviews, or when pipeline is thin. Turns past conversations into ranked, grounded re-engagement.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Draft a situational-assessment proposal from a discovery transcript or discovery analysis. Use when a qualified deal needs a proposal, or the user says "draft a proposal", "write the SOW", "put together options". Applies the 3-option, 5-10x pricing framework. Send within 48h.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Render approved proposal copy and commercial terms as a branded two-page HTML/PDF document. Use after proposal drafting and pricing, when the user needs the final visual artifact.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Draft a recurring client progress report from primary evidence, review it for the sponsor, and prepare the authorized delivery format. Use for biweekly or monthly engagement reports; use recoup-internal-consulting-stakeholder-update for a short session recap.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Turn verified user-facing releases and merged PRs into cited product-update signals and draft article, LinkedIn, and email bundles. Use for announcing shipped product work; never infer deployment or adoption from a merge alone.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Build three-tier pricing for a deal. Use when scoping investment — "build pricing", "what should I charge", "put together options", or during proposal drafting. Applies the 5-10x anchor and a payment structure.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Sharpen positioning and messaging. Use on "refine my positioning", "is my pitch clear", or when entering a new niche.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. The process every personalized outbound email runs through before it is staged — gather full context on the person, decide who it is really for and what the objective is (set by temperature), simulate the reader, and pass the pre-send gate. Use when drafting or reviewing any 1:1 nudge, follow-up, broadcast, or stakeholder note. Voice and craft live in recoup-internal-consulting-copy-writer; the context gather lives in recoup-internal-consulting-lead-context.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Turn a raw objection into a tailored response. Use when a prospect pushes back — "they said it's too expensive", "they want to think about it", "how do I respond to this objection".

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Phase 2 of the nightly pipeline — the workspace reconciler. Runs after the ingestion sweep, reads the digest's "Needs you" queue, and does the higher-judgment MUTATIONS capture deliberately skips: create prospect dashboards (lead-intake), reconcile Attio↔folder drift, move deals across funnel stages (evidence-gated), refresh stale dashboards, regenerate indexes, archive dead files. Use on "run the janitor", "reconcile the workspace", "clear the digest queue", or as the nightly post-capture ritual. Mutating + evidence-gated — never the capture step.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. The autonomous nightly sweep. Runs unattended (cloud routine or local cron) to ingest the day's new meetings, emails, and LinkedIn engagement, run the full auto-manage loop on each new item, update dashboards/board/CRM, commit, and leave a morning digest. Use on "run the nightly sweep", "ingest today", "catch the OS up", or as the scheduled nightly ritual. Full autopilot, inside the three standing safety rails.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Phase 3 of the nightly pipeline — the demand engine's insight lane (Engine A, article-first). After capture + janitor, pick a signal from the day's reservoir and produce a copy-edited pillar ARTICLE plus a LinkedIn post and a broadcast email derived from it, and an on-brand image set — staged as one role-named idea bundle (article.md + linkedin.md + email.md + images/ + meta.yml) for review, never published. Every text format goes through recoup-internal-consulting-copy-reviewer (the reader's eyes) then recoup-internal-consulting-copy-editor; recoup-internal-consulting-article-illustrator makes the hero + inline diagrams. Article-first: one pillar -> many formats. Use on "run the nightly content", "draft today's article", or as the nightly content ritual.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Refresh the practice metrics and dashboard. Use monthly, after a deal changes state, or "update the dashboard/metrics". Good scheduled-task candidate.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Capture niche intelligence and buying signals. Use on "research this market/niche", "what are the buying signals here", or when evaluating a new vertical.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Prepare, publish, or schedule a LinkedIn post using the selected workspace publishing account and verified provider state. Use for LinkedIn publishing and scheduling requests.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Structure a high-performing LinkedIn post — pick the archetype and founder format (build log, documented failure, value post, receipt, contrast hook, milestone chapter), write a scroll-stopping hook, shape the body, format for mobile, choose the in-post CTA, and decide whether to pair an infographic. Use on "write a LinkedIn post", "make this post perform/go viral", "what hook should I use", "structure this for LinkedIn", "turn this insight into a LinkedIn post", "write a build log / failure / receipt / milestone post", or right after recoup-internal-consulting-content-drafter. This is the post-STRUCTURE layer; recoup-internal-consulting-copy-writer still governs voice/anti-slop, recoup-internal-consulting-linkedin-publisher ships it.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Write or critique the first line of a LinkedIn post (the hook) using patterns reverse-engineered from real top-performing posts. Use on "write hooks for this", "give me 10 hooks", "fix this hook", "why won't this hook land", "what's a scroll-stopping opener", or whenever drafting/critiquing a post's line 1. This is the dedicated hook engine; recoup-internal-consulting-linkedin-post-architect handles whole-post structure and defers here for the hook; recoup-internal-consulting-copy-writer governs voice/anti-slop.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Architect or audit a LinkedIn profile-as-funnel — turn the profile into a landing page, build the offer ladder (free top → qualifying application bottom), and wire posts into it. Use on "audit my LinkedIn funnel/profile", "turn my profile into a funnel", "fix my LinkedIn profile", "build my offer ladder", "set up a waitlist/application", "where are the gaps in my funnel". Audit mode scores the current setup and lists fixes; build mode gives templates for each piece.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Build a daily LinkedIn comment-target queue — whose posts the owner should comment on to warm ICP prospects, with draft angles in his voice. Use on "who should I comment on", "build my engagement queue", "LinkedIn commenting plan", "warm up prospects on LinkedIn". The agent ranks targets; the owner writes + posts the comments himself (never auto-comment).

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Turn LinkedIn engagement into leads. Use on "who engaged with my post", "pull LinkedIn leads", "find warm leads from LinkedIn", or after a post gets traction. Pulls reactors/commenters via Apify and cross-references Attio to surface engaged-but-not-in-CRM outreach candidates.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Score a lead's relationship temperature (0-10) and posture from their full communications graph, so follow-ups match where the relationship actually stands. Use before drafting any re-engagement or outreach to a known lead, on "what's their temperature", "score this lead", or in the Friday warm-leads sweep.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Triage a brand-new inbound lead. Use when a new prospect appears — a fresh inquiry email, a first-call transcript, "new lead", "qualify this prospect", "should I take this deal". Verifies the lead against primary sources, creates the pipeline folder, qualifies the buyer, and opens a CRM record.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Assemble a grounded context dossier on a lead BEFORE any outreach or personalization, so drafts are accurate and the agent never punts "I need your input" on something it could look up itself. Run before recoup-internal-consulting-email-atomizer, recoup-internal-consulting-followup-sequencer, or any 1:1 outreach, especially for content-sourced leads (LinkedIn engagers).

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Log new frameworks, methodologies, or OSS tools to the IP register. Use when you build something reusable, "update the IP register", or before signing a new deal.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Produce an invoice per the selected payment structure. Use on "send an invoice", "bill the client", at a milestone, or on a retainer cycle.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. The anti-staleness engine for external integrations. Use on the Friday cadence, on "sync the integrations", "is the CRM in sync", "refresh granola/attio/linkedin/gmail/slack", or whenever the repo might have drifted from Attio/Granola/LinkedIn/Gmail/Slack. Reconciles live sources against the repo and reports what changed and what's stale.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Stand up a new external-tool integration in one move. Use on "add an integration for X", "connect <tool>", "I have an API key for X", or whenever a new data source/channel should flow into the OS. Scaffolds integrations/<tool>/ in the house pattern.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Connect a new external data source or channel to the selected business workspace, define ownership and scope, and verify one authorized read through the workflow.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Turn the inbox into a prioritized "what you owe people" digest across active deals. Use on "what emails need a reply", "triage my inbox", "what am I behind on", or as a daily/weekly ritual. Reads Gmail, classifies by who owes the next step, and ties each thread to its deal.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. > The house skill for making any VIDEO — create, edit, animate, or render a video, animation, or motion graphic: a promo, explainer, captioned clip, reel, lyric video, title card, lower-third, logo sting, PR/changelog video, or any moving composition. Built on HeyGen's HyperFrames (renders video from HTML). This one skill folds the whole toolkit: it routes intent to the right workflow MODE (modes/) and leans on the engine knowledge packs (engine/). Defers all look-and-feel to recoup-internal-consulting-tasteful-design and pulls brand tokens from DESIGN.md (via that skill) — so output matches our system and taste by default. Use for anything that MOVES or renders to MP4/WebM. For a STILL image (PNG social post, carousel, thumbnail, OG card) use recoup-internal-consulting-graphics instead.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Generate AI media for content by driving the Higgsfield CLI — photoreal or cinematic IMAGES, AI VIDEO / b-roll, branded PRODUCT shots, a face-consistent AI CHARACTER/avatar ("Soul"), and AI VOICEOVERS. Use on "generate an image/photo/video with Higgsfield", "make a photorealistic / cinematic / AI-generated visual", "AI b-roll", "product photoshoot", "make an AI avatar / a recurring character", "AI voiceover", or whenever content needs *generated pixels* that can't be drawn in HTML/CSS. NOT for typographic/designed stills (quote cards, frameworks, stat cards, carousels, thumbnails, OG images) → use recoup-internal-consulting-graphics; NOT for HTML-rendered/deterministic video (explainers, captions, motion-type, slideshows) → use recoup-internal-consulting-hyperframes-video. Bills credits (paid) — always preview cost first.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Generate on-brand social media graphics for any platform and format — feed posts, carousels, stories/reels covers, banners and headers, profile pictures, YouTube thumbnails, Pinterest pins, Open Graph link cards, and ad creative. Renders HTML to PNG via Playwright at correct platform dimensions with safe zones. Use when asked to create a social post, carousel, slide deck for social, story/reel, cover/banner, profile picture, thumbnail, pin, OG image, or to resize/adapt one design across multiple platforms and aspect ratios (1:1, 4:5, 9:16, 16:9, 1.91:1, 2:3, banners, pfps). Visual styles live as templates in references/; output-craft playbooks (thumbnail, carousel, …) live in references/recipes/; dimensions and safe zones in references/dimensions.md. Static images only — for video, motion graphics, or anything animated, use recoup-internal-consulting-hyperframes-video.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Produce a finished, post-ready branded VISUAL by compositing a Higgsfield-generated background (photoreal / cinematic / illustrative imagery) with an on-brand HTML text overlay. This is "the power move." Use on "make a post image / hero image / banner / OG card with a real/cinematic/AI background and a headline", "put a headline on a generated image", "branded visual over a photo/AI background", or whenever a social asset needs BOTH generative imagery AND clean, on-brand type. Orchestrates recoup-internal-consulting-higgsfield (the background) + recoup-internal-consulting-graphics (the overlay) and defers aesthetics to recoup-internal-consulting-tasteful-design. NOT for a pure typographic graphic on a solid/gradient field (no generated photo) → recoup-internal-consulting-graphics; NOT for raw generation with no text overlay → recoup-internal-consulting-higgsfield.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. The weekly content + system review ritual. Use on "run the Friday review", weekly cadence, or "what should I write this week". Good candidate to wire as a scheduled task.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Generate the timed follow-up cadence for a deal, personalized to the client's stated stakes. Use after a call or proposal, on "draft follow-ups", "they went quiet", "what do I send next".

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Capture a recurring answer as a canonical FAQ. Use when a question gets answered a second time, or "add this to the knowledge base/FAQ".

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Identify land-and-expand opportunities within a client. Use during/after delivery, at QBR time, or "where can we grow this account".

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Fan one source insight into several scheduled, segment-routed email touches (trend-jack, proof, insight, build-in-public, 1:1 nudge) staged as drafts, never one-offs. Use after a call/extraction, on "turn this into emails", "atomize for email", "what should I send the list", or when a notable industry event lands. Powers the top-of-funnel email engine.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Analyze a sales/discovery call transcript to surface stakes, pain points, success metrics, objections, gaps, and buyer qualification. Use after a discovery call, when triaging a new lead transcript, or when the user says "analyze this call", "qualify this buyer", "what's at stake here". Feeds the situational-assessment proposal.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Advance a deal cleanly when its state changes. Use on "move X to proposal", "we won/lost the deal", "X signed", or any pipeline stage change. Keeps folders, the board, and the CRM in sync.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Apply when writing any text for or as the user: social posts, emails, newsletters, landing pages, ads, blog posts, video scripts, sales copy, messages, or any published content. Enforces clean human-sounding prose, bans AI-slop patterns, and applies format-specific rules. NOT for internal notes, code comments, or agent-to-agent communication.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Reader-reaction review of a finished draft, run through a fresh-context subagent that ROLE-PLAYS the owner's ICP customer (a founder / CEO / C-suite exec of a $5M-$500M creative, music, entertainment, CPG, or marketing company, sometimes a larger construction firm). Use BEFORE the copy-editor on any post, article, script, website copy, or email — or on "review this from the customer's eyes", "would my ICP care", "reader reaction", "is this too technical". Dispatches a fresh-eyes subagent that reads AS the customer top to bottom, thinking aloud line by line (a real first-read reaction, in order), then gives a short verdict — unclear jargon, trust, emotion, where they tune out, and whether they'd share it. The main agent then rewrites from that read. NOT the craft/slop pass — that is recoup-internal-consulting-copy-editor, which runs after.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Editorial copy-edit pass on a finished draft, run through a fresh-context subagent reviewer. Use on "copy-edit this", "edit this article", "do an editor pass", "give it a hard edit", "review my draft", "check this for slop", or as the last gate before publishing any long-form article, pillar, post, or email. Dispatches a fresh-eyes subagent that returns structured editor's notes (AI slop, non-conversational phrasing, confusing rhetoric, simpler-rewrite and narrative/storyline opportunities, and anything an editorial-outlet editor would flag); the main agent then triages and implements the accepted edits, then re-checks against the house standard.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Squeeze every published winner — repost proven posts with a fresh hook, re-share your own winners with added context, and fan one outlier post into multiple new formats. Use on "what should I repost", "recycle my winners", "this post popped, what now", "turn this outlier into more posts", "wring the towel", after an engagement pull shows a post outperforming baseline, or on the Friday review's recycle step. Reads published bundles + engagement data; stages new drafts; never auto-posts.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Produce test variants of an idea to find what resonates before investing. Use on "ideas for X", "test this angle", "give me hooks for this".

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Extract reusable content, insights, and knowledge-base entries from a call transcript or meeting note. Use whenever a new transcript lands in content/01-raw/ or a client's meetings/ folder, after any client/sales call, or when the user says "extract content", "mine this call", "turn this into posts/insights". Powers the content flywheel ("never answer the same question twice").

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Turn an idea or insight into a publish-ready draft. Use on "draft a post/blog about X", "write this up", or when promoting a signal from signals/.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Distribute one finished pillar article across every channel the same way — republish the same copy to the owned blog + LinkedIn newsletter + X (as an article, never a thread), ship the always-on companions (a LinkedIn promo post + an email to the list), point every link at the owned canonical URL, then find the live post and monitor its engagement into leads. Use after an article is written or published, on "distribute this", "post it everywhere", "atomize this article", "where else should this go", or when promoting a piece in content/04-published/.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Log a single comms event on a deal/client (you sent, they replied, it was opened, you got a message) and reconcile state. Use on "I sent that", "he replied", "they opened it", "got a reply from {name}", "just emailed {name}", or a screenshot of a sent/received message. Faithfully records the as-sent/as-received text + the engagement signal (open != reply), then updates the deal AGENTS.md, _board.md, any active followups sequence, and whose ball it is. NOT recoup-internal-consulting-call-processor (the heavy "new material -> extract + mine" loop for transcripts/notes/results) and NOT recoup-internal-consulting-inbox-triage (the radar for what needs a reply across deals) -- this is the light "log one touch and reconcile" move.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Rebuild a client/deal folder from scratch using historical data. Use when a Won client or active deal has no folder (or a stale one), on "reconstruct <client>", "we have history with X but no folder", or after Attio shows a deal the filesystem is missing. Grounds the dashboard in Granola + Attio.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Stand up a won client in one move. Use on deal won, "onboard {client}", "kick off the engagement", or right after a deal moves to closed-won.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Convert delivered work into a case study. Use at engagement milestones/completion, "write a case study", or when a win lands.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. The auto-manage orchestrator. Use whenever new client/deal material lands — a transcript, meeting note, email, or result — or when the user says "process this call", "ingest this", "handle this transcript". Runs the full keep-the-system-current loop end to end.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Create bold article thumbnails with contrasting text and illustration, plus simple white-background inline figures, including flow, comparison, cycle, stack, hub and framework diagrams. Uses Higgsfield artwork with editable DM Sans text and approved Recoup colors.

INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Build or refresh the "Reality" section for a client or lead by traversing every comms channel holistically, then synthesizing — explicitly flagging missing data. Use before any big account move, on "what's really going on with X", "refresh the reality for X", when a dashboard looks stale or assumed, or before drafting outreach to a customer/lead.

INTERNAL — Recoup staff tooling, gated by the recoup-internal keyword. Invoke ONLY when the request explicitly includes "recoup-internal" (e.g. "recoup-internal account health for this account"). Never use for customer-facing or artist requests. Produce an account-status / account-health snapshot for a Recoup account from an email, account ID, or artist name. Resolves the account, pulls its artists, socials, chats, scheduled tasks, sandboxes, credits and subscription, then generates an ACCOUNT.md, a per-artist ARTIST.md tree, and a polished status PDF. Use when asked to "check this account", "account status", "account health", "how are they using the product", "what artists / chats does this account have", "evaluate this user/profile", or to find the sign-in email behind an artist. Requires a Recoup API token (an admin token can inspect any account; an owner token only its own).

Write social captions in an artist's own voice — diarized from their context and past posts, checked against an anti-slop fingerprint. Use for "write a caption for [artist]", "post copy", or "what should they post". Stops at the text; never posts. To make the visual it goes with, use recoup-content-make-graphics or recoup-content-make-video.

Turn a real milestone or trend into a timely post — finds the real moment (a chart entry, a streaming milestone, a fresh trend), picks an angle in the artist's voice, then routes to the right format. Use for "they just hit 1M, make something", "react to this trend", or "make something timely". Real moments only; never invents a milestone. The underlying data comes from recoup-research-artist-overview.

Make finished short-form video for an artist — a 9:16 TikTok/Reel/Short of the artist + song, a lyric video, a no-text visualizer/Spotify Canvas, or per-platform reformats of existing footage. Use for "make a TikTok/Reel/Short", "lyric video", "visualizer/Canvas", or "reformat this for TikTok". Modes: short, lyric, visualizer, reformat. Verifies the render before claiming done; stops at the asset. For the clip-worthy moment first, use recoup-song-find-hook.

Make still-image assets for an artist — cover art, thumbnails, carousels, promo/announcement graphics, and quote/lyric cards. Use for "make cover art", "a thumbnail", "a carousel", "a promo graphic", or "a quote card". Picks the format from the ask, generates to spec, and verifies the render before claiming done. Stops at the asset; never posts.

Generate a whole batch of content assets for one song — a cohesive 15–30-piece clip family (videos, quote cards, a carousel, a visualizer, captions) themed to the audience. Use for "content pack", "30 posts for the launch", or "a bunch of content for [song]". Estimates and confirms cost before spending. Stops at the assets; never posts.

Review and underwrite a music catalog deal end to end — ingest a messy royalty data room, value it (NPS/NLS, concentration, scenarios), build the executive dashboard, and write the IC memo. Use for "review/underwrite this catalog", "clean these royalty statements", "catalog valuation", "build the deal dashboard", or "write the IC memo". Modes: review (default), ingest, value, dashboard, report. Needs seller files; source/ is immutable and completion is gated. For a quick value from public data only, use recoup-catalog-estimate-value.

Estimate a catalog, album, or song's value from public streaming data alone — no seller files or data room required. Use for "what's this catalog worth from public data", "ballpark this catalog", or "estimate the value of [album/song]". Wider error bars than a seller-file valuation; states its assumptions. For full diligence on a real data room use recoup-catalog-review-deal.