Communitygithub.com

0xsline/openchatcut

À utiliser pour vérifier que les modifications d'un agent sont correctement répercutées dans le projet et l'éditeur OpenChatCut.

Qu'est-ce que openchatcut ?

Ce skill permet à un agent d'IA de vérifier que ses modifications sont bien appliquées dans le projet OpenChatCut. Il définit des niveaux de vérification (L0, L1, L2) en fonction de la profondeur de test requise, allant des vérifications statiques (compilation, tests) jusqu'à l'exécution complète de l'application de bureau avec inspection humaine. Il met l'accent sur deux méthodes principales de preuve : l'inspection de la structure du projet via `read_project` (actifs, pistes, éléments, placement des images, durée de la timeline) et la capture visuelle via `view_timeline_frames` pour la timeline composée (montage, calques, sous-titres, effets, marqueurs, transitions) et `view_asset_frames` pour les images sources brutes. Le skill détaille les chemins de preuve optimaux, les vérifications post-exécution (transcription des logs d'outils), et les cas de blocage (média local, autorisation, rendu cloud). Il est conçu pour les agents interagissant avec OpenChatCut, que ce soit via l'éditeur en localhost, l'API, ou l'application de bureau packagée.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xsline/openchatcut/tree/HEAD/src/agent/skills/verification

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Vérification

Utilisez le niveau de vérification le plus bas qui prouve le résultat demandé :

NiveauPreuve requise
L0Vérifications statiques telles que le script de vérification ciblé, npx tsc --noEmit, les tests, et la compilation.
L1Une exécution réelle de l'agent sur l'éditeur à localhost:5199, suivie d'une preuve structurelle et visuelle.
L2L'application de bureau packagée qui exécute le scénario utilisateur, incluant une revue visuelle humaine lorsque l'automatisation est insuffisante.

Les modifications du comportement à l'exécution nécessitent L0 + L1. Les modifications de version et celles propres au bureau nécessitent également L2 lorsque l'application packagée est le comportement testé.

Privilégiez deux signaux :

  1. read_project pour la structure : actifs, pistes, éléments, placement des images, durée de la timeline.
  2. Un chemin de capture visuelle pour une preuve rendue à des images exactes.

Utilisez view_timeline_frames pour une preuve de la timeline composée. Cela vérifie la timeline OpenChatCut éditée : rognages, calques, sous-titres, effets, marqueurs, espaces réservés, recadrages, transitions, et mise en page.

Pour l'inspection brute des images sources d'un actif, choisissez le chemin le moins coûteux en fonction de l'emplacement des octets :

  • L'agent de cette version n'a pas accès au système de fichiers local ; tous les octets sources résident dans le magasin multimédia du projet (/media/uploads/). Utilisez view_asset_frames avec l'ID d'actif du projet — le serveur emprunte automatiquement un chemin rapide de planche contact ffmpeg, c'est donc déjà le chemin le moins coûteux pour les images sources.
  • view_timeline_frames rend la timeline composée (la vérification de la vérité dans l'éditeur) ; view_asset_frames échantillonne les images sources brutes. Choisissez en fonction de ce que vous vérifiez.
  • Il n'y a pas d'outil get_contact_sheet distinct dans cette version — la planche contact est ce que view_asset_frames / view_timeline_frames renvoient déjà.

Utilisez les artefacts d'images sources locales ou distantes uniquement pour la compréhension de la source, la sélection de moments, et les décisions de rognage approximatif, pas comme preuve de sortie éditée ou de timeline.

Pour les médias locaux ou en cours de téléchargement, la preuve de la timeline composée peut être bloquée jusqu'à ce que l'actif ait des octets disponibles pour le rendu. L'inspection des images sources via view_asset_frames fonctionne toujours tant que les octets de l'actif sont sur le disque (/media/uploads/).

Si les deux chemins de preuve visuelle sont bloqués, demandez à l'utilisateur d'inspecter directement l'éditeur OpenChatCut et notez explicitement le blocage.

Vérifications utiles :

  • Après l'importation : read_project({ "view": "assets", "assetId": "<prefix>" })
  • Après un déplacement/rognage : read_project({ "view": "timeline" })
  • Après un calque visuel ou une animation graphique sur un média de la timeline : view_timeline_frames({ "frames": [30, 45, 75] }), puis examinez les images renvoyées.
  • Pour une sélection de source ou un choix de moment visuel demandé par l'utilisateur : échantillonnez des images fixes avec view_asset_frames et inspectez-les. Utilisez cela uniquement pour choisir les fichiers sources, les moments et les rognages approximatifs. Construisez le montage visible comme des éléments de la timeline OpenChatCut. Ne traitez pas l'inspection brute des sources comme une vérification de la timeline ou comme une autorisation à produire la vidéo modifiée ailleurs.
  • Pour l'inspection des images sources : appelez view_asset_frames({"assetId":"...","sourceTimesMs":[...]}) après que read_project({"view":"assets"}) a confirmé l'ID/type d'actif. Préférez cela plutôt que de demander à l'utilisateur de rattacher le fichier.
  • Pour une vérification visuelle locale uniquement : téléversez/enregistrez un média lisible dans le cloud avant de vous fier à une preuve visuelle par connecteur.
  • Pour une validation sans source : confirmez que le manifeste de l'outil expose les paramètres que vous avez utilisés, puis enregistrez la preuve visible dans le journal de trace.

Lorsque vous parlez de secondes, vérifiez le fps à partir de read_project ou utilisez des outils d'adaptateur qui résolvent le fps en interne.

Lorsque vous signalez l'emplacement d'un élément de la timeline, utilisez uniquement la dernière structure read_project pour l'alias de piste, l'ID d'élément, le début, la durée et l'ID d'actif. Ne signalez pas les pistes planifiées/par défaut ou l'intention d'appel d'outil comme un placement vérifié.

Ne considérez pas une réponse JSON de ligne de commande seule comme suffisante lorsque l'utilisateur demande si l'éditeur reflète le résultat. Utilisez l'URL de l'éditeur ou une preuve visuelle lorsque c'est pratique.

Vérification du journal de transcription de l'Agent

Après chaque exécution d'agent L1, inspectez l'intégralité de l'enregistrement de la conversation avant de signaler le succès :

  1. Lisez la réponse finale de l'assistant et chaque ligne d'outil créée par l'exécution.
  2. Développez les lignes ayant échoué ou d'avertissement et enregistrez l'erreur exacte.
  3. Vérifiez les tours abandonnés, les tentatives répétées, les propositions obsolètes, les travaux incomplets, et les résultats d'outil que la réponse finale décrit incorrectement comme réussis.
  4. Comparez le dernier résultat de read_project avec la timeline visible.
  5. Pour les modifications visuelles, inspectez les images de la timeline renvoyées plutôt que de vous fier au résumé de l'assistant.

Une exécution avec une timeline d'apparence correcte mais une erreur d'outil non signalée n'est pas une réussite propre. Corrigez la cause ou signalez explicitement l'erreur restante.

Si la vérification échoue, classez l'écart avant de changer d'outil :

  • la description ou le schéma de l'outil était insuffisant
  • les instructions du skill manquaient une étape
  • read_project n'exposait pas assez d'état
  • l'autorisation de l'éditeur n'était pas terminée
  • le pipeline de média/transcription a échoué
  • le rendu cloud/l'observation de l'éditeur était bloquée

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 acquiring or importing media into a OpenChatCut project asset library for video editing or creation, including local/attached videos, user-provided paths, public media URLs, web video/audio/image assets, upload fallback decisions, and deciding between import_media, download_media, or manual user action.

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

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.

Skills associés