Communitygithub.com

0xsline/openchatcut

Verwendung beim Erfassen oder Importieren von Medien in eine OpenChatCut-Projekt-Asset-Bibliothek für die Videobearbeitung oder -erstellung, einschließlich lokaler/angeschlossener Videos, benutzerdefinierter Pfade, öffentlicher Medien-URLs, Web-Video/Audio/Bild-Assets, Upload-Fallback-Entscheidungen und der Entscheidung zwischen import_media, download_media oder manueller Benutzeraktion.

Was ist openchatcut?

Diese Fähigkeit (Skill) „Asset Import“ verwaltet den Import von Medien in ein OpenChatCut-Projekt. Sie beschreibt drei klare Pfade: lokale Dateien (Benutzer zieht Dateien per Drag & Drop in den Editor), öffentliche URLs (der Agent verwendet `download_media`) und externe Host-Transfers (der Agent ruft `import_media` auf, um einen temporären Upload-Slot zu erstellen). Der Schwerpunkt liegt auf der direkten Verwendung von Originalquellen-Assets und der gesamten Bearbeitung auf der Zeitleiste, um jeden Schritt überprüfbar zu halten. Die Fähigkeit unterstützt keine lokalen Dateisysteme, OAuth oder CLI-Importe; sie ist für die Integration mit der Desktop-App und den `download_media`/`import_media`-Tools konzipiert und gewährleistet eine korrekte Transkodierung, ASR (automatische Spracherkennung) und Finalisierung von Assets.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xsline/openchatcut/tree/HEAD/src/agent/skills/asset-import

In Ihrer bevorzugten KI fragen

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

Dokumentation

Asset-Import

Dieser Build führt den Editor und seinen Medienserver lokal aus. Es gibt keine gehostete Import-API, kein CLI und kein OAuth: Medien gelangen über die Editor-Oberfläche oder die unten aufgeführten Agent-Tools in das Projekt. Wählen Sie den Pfad basierend darauf, wo die Bytes leben.

Pfad 1 — Lokale Dateien des Benutzers (primär)

Bitten Sie den Benutzer, die Dateien per Drag & Drop in den Editor (Vorschau-Canvas oder „Meine Medien“-Panel) zu ziehen oder die Upload-Schaltfläche zu verwenden. Die lokale Pipeline läuft dann automatisch: Streaming-Schreiben nach /media/uploads/, bedingte Transkodierung (≤1920 lange Kante, browserfreundlicher Codec, ~8 Mbit/s), Audio-Extraktion und automatische Transkription (ASR startet beim Upload). Bitten Sie den Benutzer nicht, selbst eine Vorkonvertierung, Vorbearbeitung oder Transkodierung durchzuführen – die Pipeline erledigt das.

Der Agent kann nicht auf das Dateisystem des Benutzers zugreifen. Wenn Ihnen der Benutzer einen Pfad wie /Users/... oder C:\... gibt, sagen Sie ihm, dass er die Datei stattdessen in den Editor ziehen soll; Sie können sie nicht abrufen.

Pfad 2 — Öffentliche URLs (Agent-gesteuert)

Verwenden Sie download_media mit einer einzelnen URL oder einem Batch-Array. Der Server ruft die Medien ab, speichert sie unter /media/uploads/ und registriert Pool-Assets. Bevorzugen Sie diesen Pfad für Stock-/Webmedien, auf die der Benutzer verweist. Nach dem Download verhält sich das Asset wie jedes andere Medienpool-Asset.

Pfad 3 — Externer Host-Transfer

Rufen Sie import_media mit {"action":"create_session", "assetType":..., "filename":..., "contentType":..., "size":...} auf. Es gibt einen kurzlebigen Upload-Slot zurück, der an das aktuelle Projekt, die Sitzung, die Asset-Identität, den Basisnamen, POST, den MIME-Typ und die genaue Byte-Anzahl gebunden ist. Ein Skript auf dem Host kann in diese genaue URL mit den deklarierten Headern hochladen. Die Agent-Sandbox kann nicht auf den Localhost des Benutzers zugreifen. Führen Sie daher keinen Transfer von run_code aus durch.

Die erfolgreiche Upload-Antwort gibt eine undurchsichtige Quittung, den wiedergegebenen assetType und den hochgeladenen Pfad zurück. Überprüfen Sie den hochgeladenen Pfad, wenn genaue Dauer, Abmessungen, fps oder Audio-Präsenz benötigt werden, und rufen Sie dann finalize_uploaded_asset mit der Quittung, dem wiedergegebenen assetType, den gemessenen Medienmetadaten und durationInSeconds für Audio/Video/GIF auf. Der Server löst den autoritativen Hash, Pfad, die Größe, den Dateinamen und die Asset-ID auf. Der Finalisierungsvorgang übergibt das Asset, startet aber niemals ASR; platzieren Sie ein Audio/Video-Asset auf einer Spur und rufen Sie dann separat transcribe_track auf, wenn eine Transkription gewünscht wird. Das Asset ist vor erfolgreichem Finalisieren weder vorhanden noch nutzbar. Für den Austausch fehlender Medien übergeben Sie die vorhandene assetId an import_media; lassen Sie sie für ein neues Asset weg. Konstruieren Sie niemals selbst /media/uploads/... und behaupten Sie niemals, dass Bytes bereit sind, bevor die Upload-Antwort eintrifft.

Bearbeitungsdisziplin

Erstellen Sie für Quellen aus mehreren Quellen überprüfbare Arbeit aus den ursprünglichen Quell-Assets in der OpenChatCut-Zeitleiste. Verketten, vorbearbeiten, vorbereiten, Untertitel einbrennen oder Medien vor dem Import nicht lokal verflachen – importieren Sie Originale und führen Sie die gesamte Komposition auf der Zeitleiste durch, damit jeder Schritt überprüfbar und rückgängig machbar bleibt.

Verwenden Sie für Code-Assets wie handgeschriebene Motion Graphics den Skill create-motion-graphics (create_motion_graphic_from_code für neue Assets, Asset-Code-Updates für Bearbeitungen) – MG-Code ist keine importierte Datei.

Speicherhinweise

  • Bytes befinden sich auf der lokalen Festplatte (/media/uploads/) und werden direkt mit Range-Unterstützung bereitgestellt. Wenn Cloudflare R2 konfiguriert ist, werden Uploads auf R2 gespiegelt und andere Geräte können von dort aus hydrieren; ohne R2 ist das Projekt nur lokal.
  • Nur-lokal ist ein gültiger Endzustand: Vorschau, Bearbeitung und Export lesen alle von der Festplatte. Cloud-Spiegelung ist nur für geräteübergreifenden Zugriff erforderlich.

Individual skills in this repo

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

0xsline/openchatcut

Connect an MCP-capable coding agent to OpenChatCut and edit local video projects. Use when the user asks to install, connect, or set up OpenChatCut; inspect or edit an OpenChatCut project; work with its timeline, transcript, captions, media, generation, motion graphics, audio, color, or export tools; or recover from an OpenChatCut MCP error.

0xsline/openchatcut

Use when a OpenChatCut video editing or creation workflow needs export, render, download, share, final delivery, subtitle-file export, render choice, local-only asset handling, or export fallback explanation.

0xsline/openchatcut

AI image generation via Fal.ai, gpt-image-2, nano-banana, MiniMax image-01, and xAI Grok Imagine. Use when the user wants to generate or create an image / picture / still.

0xsline/openchatcut

Use when a OpenChatCut tool call fails or returns an unexpected shape.

0xsline/openchatcut

Music generation via Mureka, MiniMax, Atlas Cloud, and Sonilo. Use for instrumentals, songs, soundtracks, track/stem generation, covers, or video-conditioned scoring of the finished cut through `submit_music`.

0xsline/openchatcut

OpenChatCut product knowledge — UI layout, editor features, and how generation providers are configured. Use when the user asks about the product interface, how to use a feature, where to find something, or needs GUI guidance for something the agent cannot do directly. Also use as fallback when a task fails and the user needs to complete it manually in the UI. NOT for live project-state queries ("where are my folders?", "what's on my timeline?", "where is clip X?") — those are answered by `read_project`, not by this skill.

0xsline/openchatcut

AI shader generator for WebGL video effects, transitions, masks, and color grading (LUT / 调色 / 电影感 / film look). Use when the user wants a video effect (滤镜 / 特效), a transition (转场 / crossfade / wipe / cube / 3d), a mask (蒙版 / 遮罩 / reveal), a zoom / push-in (推近 / 推镜头), or a color grade — try the built-in effects (zoom, builtin LUTs) before generating a new shader.

0xsline/openchatcut

Use when checking whether agent edits are reflected in the OpenChatCut project and editor.

0xsline/openchatcut

AI video generation via Fal.ai, Seedance 2.0, Kling, MiniMax Hailuo, xAI Grok Imagine, and OFox. Use when the user wants to generate a video clip — text-to-video, image-to-video, first/last-frame transitions, reference-guided generation, multi-shot, or generatively editing / extending an existing clip.

0xsline/openchatcut

Text-to-Speech (TTS), voiceover, narration placement/sync, and custom sound effects (SFX) generator. Use when the user wants generated speech from text, wants to add/replace/align narration or voiceover for an existing video/timeline, wants to keep existing voiceover synced after visual retiming edits, needs voice audition/selection, or explicitly wants a newly generated/custom sound effect that is not available in the Sound Effects library.

0xsline/openchatcut

Use when the agent should ask the user for structured input with an in-chat form, including single-select, multi-select, text fields, style pickers, or voice audition choices.

Verwandte Skills