Communitygithub.com

Remocn/remocn

Öffne ein Remotion-Projekt in Remocn Studio, der Desktop-App zur visuellen Feinabstimmung und zum Export als mp4.

Was ist remocn?

Diese Fähigkeit ermöglicht es einem KI-Agenten (wie Claude Code, Cursor oder Codex), ein Remotion-Projekt nahtlos an die Desktop-App Remocn Studio zu übergeben. Remocn Studio (für macOS und Linux) ermöglicht eine Live-Vorschau des Projekts, manuelle Anpassungen von Elementen und den Export als mp4-Datei. Die Fähigkeit besteht aus zwei Hauptschritten: Zuerst wird das Projekt durch die Ausführung eines Skripts (`studio.mjs`) vorbereitet, das die notwendige Projektstruktur (`.remocn/project.json` und einen Registry-Eintrag) erstellt, ohne bereits vorhandene Konfigurationen zu überschreiben. Anschließend kann das Projekt in Studio geöffnet werden, entweder per Deep Link oder mit Anweisungen an den Benutzer (falls Studio noch nicht installiert ist). Die Fähigkeit behandelt auch Fehlerfälle, etwa wenn die Projektvorbereitung fehlschlägt oder das Betriebssystem nicht unterstützt wird. Sie stellt sicher, dass die Projekt-ID eindeutig bleibt, um Kollisionen in Studio zu vermeiden, und behält die Kompatibilität zu bestehenden Compositionen des Benutzers bei.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Remocn/remocn/tree/HEAD/plugins/remocn/skills/studio

In Ihrer bevorzugten KI fragen

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

Dokumentation

Remocn Studio Übergabe

Remocn Studio (https://remocn.studio) ist eine Desktop-App für macOS und Linux. Sie zeigt ein Remotion-Projekt live in der Vorschau, erlaubt dem Benutzer, Elemente manuell anzupassen und exportiert mp4-Dateien. Die App öffnet nur Ordner, die sie erkennt. Daher wird ein Projekt einmal vorbereitet und kann danach jederzeit geöffnet werden.

Das Hilfsskript ist ${CLAUDE_SKILL_DIR}/scripts/studio.mjs (außerhalb von Claude Code: scripts/studio.mjs neben dieser Datei). Es benötigt nur Node und gibt pro Befehl ein JSON-Objekt aus. Führe es aus dem Remotion-Projektverzeichnis aus oder übergib das Projektverzeichnis als erstes Argument.

Vorbereiten

node "${CLAUDE_SKILL_DIR}/scripts/studio.mjs" init <projekt-verzeichnis> --name "<Video- oder Produktname>"

Was es tut und was dem Benutzer gesagt werden soll:

  • Schreibt .remocn/project.json (das Projektmanifest von Studio: eine neue projectId, revision: 0, keine Marke), falls es noch nicht existiert. Ein vorhandenes Manifest wird niemals verändert: Seine projectId ist die Identität des Projekts in Studio.
  • Platziert den Scan von Studio in src/videos/registry.tsx, falls nicht vorhanden, und umschließt die Wurzel im Einstiegspunkt als registerRoot(withVideos(Root)). Von da an ist jedes src/videos/<slug>/index.tsx, das meta exportiert, eine Composition mit der ID <slug> – sowohl in Remotion Studio als auch in Remocn Studio. Die eigenen Compositionen des Benutzers in Root.tsx funktionieren weiterhin.

In einem Projekt, das der Benutzer bereits hatte, frage vor der Ausführung: Es bearbeitet den Einstiegspunkt (einen Import, eine Umschließung) und fügt zwei Dateien hinzu.

Wenn das Ergebnis ok: false mit einem Grund zum Einstiegspunkt sagt, ruft der Einstiegspunkt registerRoot(Root) nicht genau einmal nach seinen Importen auf. Führe die Umschließung manuell durch: Füge import { withVideos } from "<registry.specifier>"; hinzu, wobei du den specifier aus dem Ergebnis verwendest (er ist relativ zum Einstiegspunkt, z.B. ../src/videos/registry für remotion/index.ts), und ändere den Aufruf zu registerRoot(withVideos(Root)). Falls das nicht möglich ist, erkläre dem Benutzer warum.

Überprüfe dann, ob npx remotion compositions jeden Video-Slug auflistet.

Öffnen

Nur nachdem der Benutzer zugestimmt hat, das Projekt in Studio zu öffnen:

node "${CLAUDE_SKILL_DIR}/scripts/studio.mjs" open <projekt-verzeichnis>

Gib die message aus dem Ergebnis weiter. Je nach action:

  • deep-link: Studio öffnet das Projekt und zeigt einen Bestätigungsdialog. Nichts weiter zu tun.
  • launched: Studio startet, kann aber noch nicht mitgeteilt bekommen, welcher Ordner geöffnet werden soll. Sage dem Benutzer, er solle Ordner öffnen (⌘O auf macOS, Strg+O auf Linux) und das Projektverzeichnis auswählen, und gib ihm den Pfad.
  • not-installed: Gib den Download-Link (https://remocn.studio) und die gleichen Schritte zum Öffnen des Ordners nach der Installation an.
  • unsupported-platform: Studio läuft auf diesem Betriebssystem nicht. Das Video kann trotzdem mit npx remotion studio in der Vorschau angezeigt und mit npx remotion render <slug> gerendert werden.

Wenn das Ergebnis besagt, dass das Manifest fehlt, führe zuerst Vorbereiten aus.

Um zu prüfen, ob Studio installiert ist, ohne etwas zu öffnen, führe den detect-Befehl aus.

Verbote

  • Erstelle .remocn/project.json nicht von Hand und kopiere es nicht aus einem anderen Projekt. Zwei Projekte mit derselben projectId kollidieren in Studio, und Studio lehnt das zweite ab.
  • Verschiebe Videos nicht aus src/videos/<slug>/. Studio identifiziert ein Video anhand seines Ordnernamens.
  • In claude.ai oder ChatGPT gibt es kein lokales Projekt zur Übergabe. Verweise den Benutzer an einen Coding-Agenten (Claude Code, Codex) mit diesem Plugin oder an die eigenen Vorlagen von Remocn Studio.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills