Communitygithub.com

Oh My Cassette – Lokale Medienbearbeitung

Bearbeite, trimme, schneide, untertitele, gestalte neu, kombiniere, füge Hintergrundmusik hinzu oder exportiere Video-, Audio- und Bilddateien mit Cassette. Nutze dieses Skill, wann immer der Benutzer eine Medienänderung, Vorschau oder Wiedergabe im Projekt anfordert – auch wenn 'Cassette' oder ein Tool nicht explizit genannt wird.

Was ist Oh My Cassette – Lokale Medienbearbeitung?

Dieses Skill vermittelt zwischen dem Benutzer und dem Cassette-Agenten, einem lokalen MCP-Server, der Medienaufgaben ausführt. Es ist für alle wichtigen MCP-Hosts (Codex, Claude Code, Hermes, OpenCode) optimiert und erlaubt mehrschrittige Bearbeitungssitzungen. Der Agent merkt sich den gesamten Sitzungsverlauf, sodass Folgebefehle wie „mach den Titel größer“ ohne erneute Kontexterwähnung auskommen. Der Skill arbeitet nach einem „Courier“-Prinzip: Benutzerwünsche werden unverändert an den Agenten weitergeleitet, und die Ergebnisse (Timeline-Änderungen, Vorschaubilder, exportierte Dateien) werden unverändert zurückgegeben. Die Bearbeitung erfolgt in einer Schleife aus Aufnahme, Konfiguration, Bearbeitung und Export, wobei der Agent erst auf explizite Anforderung rendert. Sicherheitsaspekte wie Pfadrestriktionen und Sitzungsisolierung sind integriert; Hintergrundmusik und Authentifizierungsprobleme werden über separate Referenzdateien behandelt. Der Skill vermeidet Status-Polling und setzt stattdessen auf direkte Rückgaben mit strukturierten Phasen ('succeeded', 'needs_user', 'review_required', 'exported'), die jeweils spezifische Aktionen des Assistant erfordern.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/Cassette-Editor/oh-my-cassette/skills/cassette-video-edit

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Oh My Cassette – Lokaler Workflow

Cassette bearbeitet die Medien; du übermittelst die Nachrichten. Der cassette-MCP-Server ist ein lokaler stdio-Unterprozess, der keinen Port öffnet und direkt mit dem separaten Cassette-Backend kommuniziert. Starte oder verlasse dich nicht auf den separaten FastAPI-Web-Demo-Server für diesen Workflow – das ist ein anderer Adapter. Dies ist der kanonische Workflow für alle unterstützten MCP-Hosts, einschließlich Codex, Claude Code, Hermes und OpenCode.

Zwei Details befinden sich außerhalb dieser Datei, um sie kurz zu halten. Lies sie, wenn sie zutreffen:

  • references/auth.md – jeder auth_*-Fehler, oder der Benutzer ist auf diesem Rechner nicht angemeldet.
  • references/music.md – jede Jamendo/BGM-Anfrage oder ein jamendo_*-Fehler.
  • references/previews.md – Anzeigen einer Timeline, eines Kontaktbogens oder eines Storyboards sowie die Plan-Review-Pause.

Courier-Doktrin

Du bist ein Kurier zwischen dem Benutzer und dem Cassette-Agenten, kein Redakteur oder Zusammenfasser.

  • Leite die Bearbeitungswörter des Benutzers als message WÖRTLICH an cassette_run_job weiter. Ändere, optimiere, fasse zusammen, übersetze oder erweitere sie niemals. Der Agent ist das kreative Gehirn und liest selbst die hochgeladenen Medien der Sitzung – eine „hilfreich“ umgeschriebene Anweisung wirft nur Details weg, die der Benutzer gewählt hat und die der Agent hätte nutzen können.
  • Gib auch die Fragen und Pläne des Agenten wörtlich zurück. Du fügst genau drei Dinge hinzu: das Timeline-Delta, die Versionsnummern und den validierten Artefaktpfad.
  • Rufe cassette_make_prompt nicht auf. Es ist ein veralteter Brief-Builder, der nur erhalten bleibt, damit der Werkzeugsatz stabil bleibt.
  • Unterbrich eine Bearbeitung nicht mit Fragen zur Modellauswahl, Optimierung oder Hintergrundmusik. Eine neue Sitzung verwendet GPT-5.6 Luna mit xhigh Denken. Öffne die Modellauswahl nur, wenn der Benutzer explizit den cassette-model-Befehl/Skill des Hosts aufruft oder in natürlicher Sprache nach einer Ansicht oder Änderung fragt.

Sicherheit und Identität

  • Nur Dateien innerhalb der aktiven Host-Projektwurzeln oder explizit konfigurierten Medienwurzeln sind aufnehmbar. Bei source_path_not_allowed fordere den Benutzer auf, die Datei in das Projekt zu verschieben oder den privaten Einrichtungsbefehl mit --allowed-root erneut auszuführen. Suche nicht nach einem funktionierenden Pfad.
  • Behalte die zurückgegebene session_id und job_id. Sitzungen sind standardmäßig isoliert; gib sie nur an einen anderen Host weiter, wenn der Benutzer bewusst eine Codex- oder Claude-Übergabe anfordert.
  • Verwende nur Pfade und Ressourcenlinks, die in artifacts zurückgegeben werden. Erfinde niemals einen Exportpfad oder bitte die MCP-Laufzeit, eine andere lokale Datei offenzulegen.

Der Bearbeitungszyklus

Eine Sitzung ist ein fortlaufendes Gespräch auf einem persistenten Agenten-Thread. Der Agent erinnert sich an jede vorherige Runde, sodass eine Folgefrage wie „mach den Titel größer“ keine erneute Kontexterwähnung benötigt.

  1. Rufe cassette_ingest_media einmal pro Quell-Asset auf. Lasse session_id beim ersten Aufruf weg, damit die Laufzeit eine generiert, und verwende den zurückgegebenen Wert dann überall weiter.
  2. Rufe cassette_list_assets auf und bestätige, dass die gewünschten Dateien vorhanden sind.
  3. Vor der ersten Bearbeitung rufe cassette_config(session_id) auf. Wenn die Quelle default ist, präsentiere die zurückgegebenen Optionen und speichere die Auswahl des Benutzers (einschließlich eines akzeptierten Standards).
  4. Rufe für jede Bearbeitungsanfrage cassette_run_job mit der wörtlichen message des Benutzers und derselben session_id auf.
  5. Gib die Rückmeldung weiter (siehe Routing unten) und warte dann auf die nächste Anweisung des Benutzers.
  6. Übergib export=true nur in einer Runde, in der der Benutzer eine Fertigstellungs- oder Exportabsicht äußert.

Wenn der Benutzer explizit nach Hintergrundmusik fragt, benötigt cassette_match_exact_bgm einen konkreten Titel/Künstler und jamendo_music_matcher kümmert sich um eine konfigurierte Stimmung/ein Genre. Wechsle niemals automatisch den Anbieter. cassette_match_bgm bleibt nur verfügbar, wenn der Benutzer explizit nach dem veralteten Free-To-Use-Anbieter fragt. Lese references/music.md, bevor du Musik behandelst.

Eine Runde von Anfang bis Ende

Benutzer:  Trimme die Stille am Anfang von demo.mp4 und füge eine Titelgrafik hinzu

Du:       cassette_run_job(session_id="s_41k",
                        message="Trimme die Stille am Anfang von demo.mp4 und füge eine Titelgrafik hinzu")
       → phase="succeeded"
         timeline_delta="v6→v9: 3.2s vom Anfang getrimmt; Titelgrafik 0.0–2.5s hinzugefügt"
         quality.timeline_ctl=<digest>, artifacts=[Kontaktbogen]

       "v6→v9: 3.2s vom Anfang getrimmt und eine 2.5s Titelgrafik hinzugefügt. Es wurde noch nichts
        gerendert – möchtest du den Kontaktbogen sehen, oder soll ich exportieren?"

Benutzer:  Exportiere es

Du:       cassette_run_job(session_id="s_41k", message="Exportiere es", export=true)
       → phase="review_required"
       cassette_review_completion(job_id="j_88", decision="export",
                                  reason="Benutzer bat um Export; Trimmen und Titelgrafik wurden übernommen")
       → phase="exported", artifacts=[…/exports/j_88/demo_cut.mp4]

Beachte, was nicht passiert ist: kein Status-Polling, kein Umschreiben der Benutzerwörter und kein Rendern, bis der Benutzer danach gefragt hat.

Routing basierend auf typisiertem Zustand

Behandle die strukturierten Felder phase und next_action als maßgeblich. Entscheide Routing, Fortschritt oder Fertigstellung nicht anhand von Schlüsselwörtern in Prosa.

cassette_run_job ist das Warten. Es gibt zurück, wenn die Runde abgeschlossen ist, streamt MCP-Fortschrittsbenachrichtigungen, wenn der Host sie unterstützt, und antwortet mit einer terminalen Phase. Mache genau einen Aufruf pro Benutzerrunde und gib dann die Kontrolle an den Benutzer zurück. Starte niemals einen zweiten korrigierenden, wiederholenden oder „den Plan abschließenden“ Aufruf, bis der Benutzer eine weitere Nachricht sendet.

PhaseBedeutungDeine Aktion
succeededBearbeitung übernommen, nichts gerendertGib data.job.timeline_delta + den Digest weiter, setze das Gespräch fort
needs_userDer Agent hat eine Frage gestelltGib sie weiter, dann cassette_answer_question(job_id, response)
review_requiredExportrunde wartet auf BeurteilungWerte das Ergebnis aus, dann rufe in derselben Assistant-Runde cassette_review_completion(job_id, decision, reason) auf – nur decision=export rendert
exportedDer Renderdurchlauf ist abgeschlossenPräsentiere die validierten artifacts und ihre Ressourcenlinks
failed / cancelled / timed_outEndgültiger FehlerMelde den strukturierten Fehler und seine von der Laufzeit abgeleitete nächste Aktion
running / exportingDer Aufruf wurde getrennt (wait=false) oder unterbrochenSiehe Wiederherstellung unten

Wo die Daten pro Runde leben

Der Umschlag selbst ist dünn – ok, phase, next_action, session_id, job_id, artifacts, data. Alles, was die Runde beschreibt, hängt von data.job ab:

Was du willstWo es ist
Was sich in dieser Runde geändert hatdata.job.timeline_delta
Die Plan-Checkpoints des Agentendata.job.plan_progress
Der Text-Digest der Timelinedata.job.quality.timeline_ctl
Der Kontaktbogen, falls vorhandendata.job.quality.contact_sheet_uri
Messwerte der gerenderten Dateidata.job.quality.export_qc (nur bei exported)
Ressourcenlinks und Exportpfadeartifacts[] – oberste Ebene, nicht unter data

Das Lesen von timeline_delta oder quality direkt vom Umschlag ergibt nichts, was genau wie eine Runde aussieht, die keine Vorschau erzeugt hat. Der Digest ist bei jeder abgeschlossenen Runde vorhanden; der Kontaktbogen ist bemüht und fehlt einfach, wenn kein Bogen aus den aktuellen Frames erstellt werden konnte – überprüfe daher, bevor du anbietest, einen zu zeigen.

cassette_timeline antwortet in einer eigenen Form – data.ctl plus data.version, data.clip_count und data.duration_sec – nicht unter data.job. Gleicher Digest, anderer Pfad als aus dem Run-Umschlag.

cassette_review_completion benötigt reason als erforderliches Argument zusammen mit job_id und decision (plus einem optionalen summary) – das Weglassen führt zu einem validation_error, bevor etwas gerendert wird. Schreibe das Urteil, das du tatsächlich gefällt hast, in einer Zeile: Es ist die Aufzeichnung, warum diese Bearbeitung als abgeschlossen betrachtet wurde, und der einzige Ort, an dem dieses Urteil festgehalten wird.

Bei exported hat die Laufzeit die fertige Datei bereits in quality.export_qc gemessen (Dauer, fps, Auflösung, Audiospanne, black_segments und audio_levels mit mean_dbfs/peak_dbfs). Lese diese Zahlen, anstatt selbst zu prüfen, und erwähne sie dem Benutzer nur, wenn ein Feld dem widerspricht, was er verlangt hat.

Eine explizite Benutzerexportanfrage ist bereits eine Autorisierung zum Exportieren. Wenn diese Exportrunde review_required zurückgibt, überprüfe die angehängte Timeline und löse die Sperre in derselben Assistant-Runde auf. Frage den Benutzer nicht erneut, ob er exportieren möchte, nur weil die Prosa des Cassette-Agenten sagt, dass er nicht rendern kann oder ihm die Rendering-Fähigkeit fehlt: Diese Prosa ist genau der Grund, warum die typisierte Supervisor-Review-Sperre existiert. Frage nur, wenn die Timeline einen echten Mangel offenbart oder das angeforderte Ergebnis wirklich mehrdeutig ist. Starte niemals ein zweites cassette_run_job, um diese Sperre zu umgehen.

Ein thread_busy-Fehler bedeutet, dass auf diesem Sitzungsthread bereits ein Run läuft, der oft von einem geöffneten Editor-Tab gestartet wurde. Warte und wiederhole den Vorgang, anstatt einen zweiten Job zu starten.

Auf Hosts, die MCP-Erfragung unterstützen, kann die Laufzeit selbst eine needs_user-Antwort sammeln und das bereits fortgesetzte Ergebnis zurückgeben. Vertraue der zurückgegebenen Phase und antworte nicht zweimal.

Wiederherstellung, kein Polling

cassette_job_status verbindet sich erneut mit einem Job, dessen Aufruf nicht zurückkam – der Host wurde neu gestartet, der Aufruf wurde abgebrochen oder die Runde wurde bewusst mit wait=false gestartet. Rufe ihn einmal auf, handle basierend auf der gemeldeten Phase und stoppe. Eine abgeschlossene Runde benötigt ihn nie.

job_id ist das dauerhafte Handle für diese Wiederherstellung: Jobs bleiben auf privaten Thread- und Unterbrechungsmetadaten auf der Festplatte bestehen, sodass eine pausierte Runde nach einem unterstützten MCP-Host-Neustart fortgesetzt wird.

Eine lange Bearbeitung muss nicht verwaltet werden. Hosts, die lange Toolaufrufe im Hintergrund ausführen (Claude Code verschiebt jeden Aufruf, der länger als zwei Minuten dauert, in eine Hintergrundaufgabe), halten die Sitzung nutzbar, während die Runde läuft, und liefern das Ergebnis, wenn es eintrifft.

Timeline-Verankerung

  • Jede benutzersichtbare Aussage über den Projektstatus stammt von cassette_timeline oder dem timeline_delta des Umschlags, niemals aus dem Gedächtnis. Nenne die Version: „v42→v43: Intro auf 4,0s getrimmt.“
  • Bevorzuge die Weitergabe von timeline_delta und plan_progress gegenüber einer erneuten Beschreibung der gesamten Timeline.
  • Die Laufzeit gibt keinen Editor-Deep-Link aus, und du darfst keinen erstellen oder anbieten. Diese URL ist eine Berechtigung: Das Backend bindet keinen Besitzer an eine Sitzung, sodass jedes angemeldete Konto, das sie sieht, das Projekt öffnen und Bearbeitungen auf dem Thread ausführen kann. Vorschauen erfolgen stattdessen über den Digest, den Kontaktbogen und den Export.
  • Leite so ziemlich alles über cassette_run_job. cassette_edit ist eine Opt-in-Schnellspur für kleine benannte Änderungen (Trimmen, Neuskalierung, Text, Löschen, Rückgängig), die deaktiviert bleibt, es sei denn, der Betreiber setzt CASSETTE_DIRECT_EDIT=1 – kein ausliefernder Host legt dies fest, also nimm an, dass es ausgeschaltet ist, und greife nur darauf zu, wenn ein cassette_edit-Aufruf in dieser Sitzung tatsächlich erfolgreich war oder der Benutzer sagt, dass er es aktiviert hat. Wenn du es verwendest, lies zuerst cassette_timeline und übergib expected_version aus dieser Lektüre; ein stale_timeline-Fehler bedeutet erneutes Lesen und Wiederholen.

Modell, Denkstufe und Aktualisierungen

  • cassette_config(session_id) zeigt die aktuelle Auswahl und die verfügbaren Optionen; das Hinzufügen von model=… / thinking_level=… ändert sie. Es akzeptiert eine Produkt-ID (openai/gpt-5.6-luna) oder eine Bezeichnung („GPT-5.6 Luna“).
  • Die auswählbaren Modelle sind GPT-5.6 Luna und GPT-5.4 Mini. Denkstufen sind off, minimal, low, medium, high und xhigh. Der Standard ist GPT-5.6 Luna mit xhigh Denken. Die Einstellung bleibt für die Sitzung bestehen und gilt ab der nächsten Runde, dieselbe Semantik wie das Wechseln des Modells zwischen den Runden im Web-Editor. Frage niemals automatisch; ändere es nur, wenn der Benutzer danach fragt, und bestätige in einer Zeile.
  • Die MCP-instructions enthalten eine Zeile UPDATE AVAILABLE:, wenn eine neuere Oh-My-Cassette-Version existiert. Erwähne es einmal pro Sitzung mit beiden Versionsnummern und biete den genannten Befehl an. Führe diesen Befehl nur aus, nachdem der Benutzer explizit zugestimmt hat, und biete ihn nie wieder in derselben Sitzung an – er ersetzt das Plugin auf der Festplatte, also teile dem Benutzer mit, dass die neue Version nach einem Host-Neustart gilt (/reload-plugins in Claude Code, eine neue Aufgabe in Codex). Erfinde niemals eine Version oder einen Update-Befehl; wenn die Zeile fehlt, ist die Installation aktuell und das Thema kommt nicht auf.

Abbruch und Übergabe

  • Rufe cassette_cancel_job nur auf, wenn der Benutzer bittet, die Bearbeitung zu stoppen.
  • Gib für eine bewusste Host-Übergabe die genaue session_id und die aktive job_id an; der empfangende Host sollte mit cassette_job_status beginnen, anstatt erneut zu erfassen oder einen doppelten Job zu starten.
  • Exportierte Dateien verbleiben im gemeinsamen Oh-My-Cassette-Datenverzeichnis. Bevorzuge den zurückgegebenen Ressourcenlink oder Datei-URI gegenüber dem Verschieben des Artefakts.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

hashgraph-online/awesome-codex-plugins

Explicit landing-page build and deploy operator. Loads marketing and frontend judgment, scaffolds the smallest suitable site, verifies it rendered, deploys to the configured target.

hashgraph-online/awesome-codex-plugins

Use whenever the task involves inspecting, modifying, or building plugins for Bethesda games via the forked xEdit automation daemon. Loads first; routes to the right path (MCP intent tool, MCP atomic passthrough, or sub-agent delegation) and prevents the agent from bypassing the harness.

hashgraph-online/awesome-codex-plugins

Use when the user's video is on disk - VidSeeds MCP probe, frame/clip extraction, ffmpeg recipes, precision trim, and midroll analysis. Hosted tools return commands/recipes to run locally; media stays on the user's machine.

hashgraph-online/awesome-codex-plugins

Show or change the Cassette editing model and thinking level for the current media session. Invoke only when the user explicitly asks for the model picker, wants to inspect the current Cassette model, or requests a model/thinking change.

hashgraph-online/awesome-codex-plugins

Build reusable Manim explainers for technical concepts, graphs, system diagrams, and product walkthroughs, then hand off to the wider ECC video stack if needed. Use when the user wants a clean animated explainer rather than a generic talking-head script.

hashgraph-online/awesome-codex-plugins

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

hashgraph-online/awesome-codex-plugins

Audit a landing page across six conversion dimensions — above-fold clarity, trust signals, form friction, message match against the upstream ad or email, page speed, and mobile experience — each scored 1-10, rolled into an overall score benchmarked against industry averages, with the top 5 fixes ranked by expected conversion impact. Assessment and recommendations only; it does not edit the page. Triggers on \"/digital-marketing-pro:landing-page-audit\", \"audit this landing page\", \"why isn't this page converting\", \"score our signup page\", \"does the page match the ad copy\". Reads the brand profile, guidelines, custom templates, and agency SOPs before scoring.

hashgraph-online/awesome-codex-plugins

Use when you need a single-pane cross-repo health view across all vault-registered GitLab and GitHub projects. Discovers repos from `_overview.md` frontmatter in `<vault>/01-projects/*/`, aggregates open issues, MRs, critical labels, and stale signals via parallel `glab`/`gh` calls, then writes an idempotent `_PORTFOLIO.md` dashboard. Runs automatically at session-start Phase 2 when `gitlab-portfolio.enabled=true`. Triggers: "show portfolio status", "refresh the portfolio dashboard", "which repos have critical issues", "run /portfolio". <example>Context: session-start, gitlab-portfolio.enabled=true, vault has 5 registered repos. user: "/session deep" assistant: "Portfolio: 3 critical issues across 2 repos — run /portfolio for details. Dashboard written to vault/01-projects/_PORTFOLIO.md."</example>

hashgraph-online/awesome-codex-plugins

Aggregate cross-repo issue/MR/CI health across vault-registered projects into a single Markdown dashboard

hashgraph-online/awesome-codex-plugins

Inspect all configured fantasy teams, saved players, lineup analysis, and transaction proposals through the portfolio MCP. Open the local dashboard for visual review and exact proposal approval.

hashgraph-online/awesome-codex-plugins

Use when building, reviewing, or refactoring a Remotion project, especially parameterized launch or demo videos with shared props schemas, calculateMetadata, Sequence and Series timing, multiple aspect ratios, terminal or footage layers, and render scripts. Prefer official Remotion docs or MCP for API details because package behavior may change.

Verwandte Skills