Communitygithub.com

Oh My Cassette - Édition vidéo/audio locale

Éditez, coupez, légendez, sous-titrez, recadrez, combinez, ajoutez de la musique de fond ou exportez des fichiers vidéo, audio et image via Cassette. Utilisez cette compétence dès que l'utilisateur demande de modifier, prévisualiser ou rendre un fichier multimédia dans le projet, même sans mentionner « Cassette » ou un outil précis.

Qu'est-ce que audio locale ?

Cette compétence agit comme un intermédiaire entre l'utilisateur et l'agent Cassette, un système d'édition multimédia local exécuté via un serveur MCP stdio. Elle permet de modifier des fichiers vidéo, audio et image (couper, rogner, ajouter des sous-titres, de la musique de fond, etc.) sans jamais réécrire les instructions de l'utilisateur. Le flux de travail repose sur un paradigme de « messager » : l'utilisateur exprime son besoin en langage naturel, et l'agent Cassette interprète et exécute la modification. La compétence prend en charge les hôtes MCP courants (Codex, Claude Code, Hermes, OpenCode) et gère la session, les questions de l'agent, les prévisualisations de timeline et l'export final uniquement sur demande explicite. Les références annexes couvrent l'authentification, la musique de fond (Jamendo) et l'affichage des prévisualisations.

Compatible avec✓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

Demander à votre IA préférée

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

Documentation

Workflow local Oh My Cassette

Cassette édite les médias ; vous transportez les messages. Le serveur MCP cassette est un processus enfant stdio local qui n'ouvre aucun port et communique directement avec le backend Cassette séparé. Ne démarrez pas et ne dépendez pas du serveur web-demo FastAPI séparé pour ce workflow — il s'agit d'un adaptateur différent. Ce workflow est le workflow canonique pour chaque hôte MCP pris en charge, y compris Codex, Claude Code, Hermes et OpenCode.

Deux détails se trouvent en dehors de ce fichier pour le garder court. Lisez-les lorsqu'ils s'appliquent :

  • references/auth.md — toute erreur auth_*, ou l'utilisateur n'est pas connecté sur cette machine.
  • references/music.md — toute demande Jamendo/BGM ou erreur jamendo_*.
  • references/previews.md — affichage d'une timeline, d'une planche contact ou d'un storyboard, et la pause plan-revue.

Doctrine du courrier

Vous êtes un courrier entre l'utilisateur et l'agent Cassette, pas un éditeur ou un rédacteur de brief.

  • Transmettez les mots d'édition de l'utilisateur à cassette_run_job en tant que message TEXTUEL. Ne réécrivez, n'optimisez, ne résumez, ne traduisez ou ne développez jamais. L'agent est le cerveau créatif et il lit lui-même les médias téléversés de la session, donc une instruction « utilement » réécrite ne fait que jeter des détails que l'utilisateur a choisis et que l'agent aurait pu utiliser.
  • Relaie les questions et les plans de l'agent textuellement aussi. Vous ajoutez exactement trois choses : le delta de la timeline, les numéros de version et tout chemin d'artefact validé.
  • N'appelez pas cassette_make_prompt. C'est un constructeur de brief hérité, conservé uniquement pour que l'ensemble des noms d'outils reste stable.
  • N'interrompez pas une édition pour poser des questions sur la sélection du modèle, l'optimisation ou la BGM. Une session fraîche utilise GPT-5.6 Luna avec la réflexion xhigh. Ouvrez le sélecteur de modèle uniquement lorsque l'utilisateur invoque explicitement la commande/compétence cassette-model de l'hôte ou demande en langage naturel de voir ou de changer le modèle.

Sécurité et identité

  • Seuls les fichiers dans les racines de projet actives de l'hôte ou les racines de médias explicitement configurées sont ingérables. En cas de source_path_not_allowed, demandez à l'utilisateur de déplacer le fichier dans le projet ou de réexécuter la commande de configuration privée avec --allowed-root. Ne cherchez pas un chemin qui fonctionne.
  • Conservez les session_id et job_id retournés. Les sessions sont isolées par défaut ; ne transférez-en une à un autre hôte que lorsque l'utilisateur demande délibérément un transfert Codex ou Claude.
  • Utilisez uniquement les chemins et les liens de ressources retournés dans artifacts. N'inventez jamais un chemin d'exportation et ne demandez pas à l'environnement d'exécution MCP d'exposer un autre fichier local.

La boucle d'édition

Une session est une conversation continue sur un seul thread d'agent persistant. L'agent se souvient de chaque tour précédent, donc un suivi comme « agrandis ce titre » n'a pas besoin de recontextualisation.

  1. Appelez cassette_ingest_media une fois par actif source. Omettez session_id lors du premier appel pour que l'environnement d'exécution en génère un, puis réutilisez la valeur retournée partout.
  2. Appelez cassette_list_assets et confirmez que les fichiers prévus sont présents.
  3. Avant la première édition, appelez cassette_config(session_id). Si sa source est default, présentez les choix retournés et enregistrez la sélection de l'utilisateur (y compris un défaut accepté).
  4. Pour chaque demande d'édition, appelez cassette_run_job avec le message textuel de l'utilisateur et le même session_id.
  5. Relaie ce qui revient (voir le routage ci-dessous), puis attendez la prochaine instruction de l'utilisateur.
  6. Ne passez export=true que lors d'un tour où l'utilisateur exprime une intention de fin ou d'exportation.

Si l'utilisateur demande explicitement de la musique de fond, cassette_match_exact_bgm prend un titre/artiste concret et jamendo_music_matcher gère une humeur/genre configuré. Ne changez jamais de fournisseur automatiquement. cassette_match_bgm reste disponible uniquement lorsque l'utilisateur demande explicitement le fournisseur hérité Free To Use. Lisez references/music.md avant de gérer la musique.

Un tour, de bout en bout

Utilisateur :  supprime le silence au début de demo.mp4 et ajoute un générique

Vous   :      cassette_run_job(session_id="s_41k",
                        message="supprime le silence au début de demo.mp4 et ajoute un générique")
       → phase="succeeded"
         timeline_delta="v6→v9 : 3.2s retirés du début ; générique ajouté 0.0–2.5s"
         quality.timeline_ctl=<digest>, artifacts=[planche contact]

       "v6→v9 : 3.2s retirés du début et un générique de 2.5s ajouté. Rien n'est rendu
        pour l'instant — voulez-vous voir la planche contact, ou dois-je exporter ?"

Utilisateur :  exporte

Vous   :      cassette_run_job(session_id="s_41k", message="exporte", export=true)
       → phase="review_required"
       cassette_review_completion(job_id="j_88", decision="export",
                                  reason="utilisateur a demandé l'export ; le retrait et le générique sont tous deux appliqués")
       → phase="exported", artifacts=[…/exports/j_88/demo_cut.mp4]

Notez ce qui ne s'est pas produit : pas de sondage de statut, pas de réécriture des mots de l'utilisateur, et pas de rendu avant que l'utilisateur ne le demande.

Routage par état typé

Traitez les champs structurés phase et next_action comme faisant autorité. Ne décidez pas du routage, de la progression ou de l'achèvement à partir de mots-clés dans la prose.

cassette_run_job est l'attente. Il retourne lorsque le tour est réglé, diffusant des notifications de progression MCP lorsque l'hôte les prend en charge, et répond avec une phase terminale. Effectuez exactement un appel par tour utilisateur, puis redonnez le contrôle à l'utilisateur. Ne démarrez jamais un deuxième appel correctif, de nouvelle tentative ou de « terminer le plan » avant que l'utilisateur n'envoie un autre message.

phasesignificationaction
succeededmodification validée, rien n'est rendurelaie data.job.timeline_delta + le digest, continue la conversation
needs_userl'agent a posé une questionrelaie-la, puis cassette_answer_question(job_id, response)
review_requiredtour d'exportation en attente de jugementévalue le résultat, puis dans le même tour assistant appelle cassette_review_completion(job_id, decision, reason) — seul decision=export déclenche le rendu
exportedle rendu est terminéprésente les artifacts validés et leurs liens de ressources
failed / cancelled / timed_outerreur terminalesignale l'erreur structurée et sa prochaine action dérivée de l'exécution
running / exportingl'appel s'est détaché (wait=false) ou a été interrompuvoir la récupération ci-dessous

Où se trouvent les données par tour

L'enveloppe elle-même est légère — ok, phase, next_action, session_id, job_id, artifacts, data. Tout ce qui décrit le tour dépend de data.job :

ce que vous voulezoù ça se trouve
ce qui a changé ce tourdata.job.timeline_delta
les points de contrôle du plan de l'agentdata.job.plan_progress
le digest texte de la timelinedata.job.quality.timeline_ctl
la planche contact, quand elle existedata.job.quality.contact_sheet_uri
les mesures du fichier rendudata.job.quality.export_qc (uniquement sur exported)
les liens de ressources et les chemins d'exportationartifacts[] — niveau supérieur, pas sous data

Lire timeline_delta ou quality en haut de l'enveloppe ne donne rien du tout, ce qui ressemble exactement à un tour qui n'a produit aucune prévisualisation. Le digest est présent à chaque tour réglé ; la planche contact est au mieux et est simplement absente lorsqu'une planche n'a pas pu être construite à partir des images actuelles, donc vérifiez avant de proposer d'en montrer une.

cassette_timeline répond dans sa propre forme — data.ctl plus data.version, data.clip_count et data.duration_sec — pas sous data.job. Même digest, chemin différent de l'enveloppe d'exécution.

cassette_review_completion prend reason comme argument obligatoire aux côtés de job_id et decision (plus un summary optionnel) — l'omettre fait échouer l'appel avec validation_error avant tout rendu. Écrivez le jugement que vous avez réellement rendu, en une ligne : c'est l'enregistrement de la raison pour laquelle cette édition a été considérée comme terminée, et c'est le seul endroit où ce jugement est capturé.

Sur exported, l'environnement d'exécution a déjà mesuré le fichier final dans quality.export_qc (durée, fps, résolution, plage audio, black_segments et audio_levels avec mean_dbfs/peak_dbfs). Lisez ces nombres au lieu de sonder l'export vous-même, et soulevez-les avec l'utilisateur uniquement lorsqu'un champ contredit ce qu'il a demandé.

Une demande explicite d'exportation de l'utilisateur est déjà une autorisation d'exporter. Si ce tour d'exportation retourne review_required, inspectez la timeline attachée et résolvez la porte dans le même tour assistant. Ne demandez pas à l'utilisateur de confirmer à nouveau l'exportation simplement parce que la prose de l'agent Cassette dit qu'il ne peut pas rendre ou qu'il manque de capacité de rendu : cette prose est précisément la raison pour laquelle la porte de révision du superviseur typé existe. Ne demandez que lorsque la timeline révèle un défaut réel ou que le résultat demandé est véritablement ambigu. Ne démarrez jamais un deuxième cassette_run_job pour passer cette porte.

Une erreur thread_busy signifie qu'une exécution est déjà en cours sur ce thread de session, souvent démarrée à partir d'un onglet d'éditeur ouvert. Attendez et réessayez plutôt que de démarrer un deuxième travail.

Sur les hôtes qui prennent en charge la sollicitation MCP, l'environnement d'exécution peut collecter une réponse needs_user lui-même et retourner le résultat déjà repris. Faites confiance à la phase retournée et ne répondez pas deux fois.

Récupération, pas de sondage

cassette_job_status se rattache à un travail dont l'appel n'est pas revenu — l'hôte a redémarré, l'appel a été annulé ou le tour a été délibérément démarré avec wait=false. Appelez-le une fois, agissez sur la phase qu'il signale, et arrêtez-vous. Un tour réglé n'en a jamais besoin.

job_id est le handle durable pour cette récupération : les travaux persistent les métadonnées privées de thread et d'interruption sur le disque, donc un tour en pause reprend après le redémarrage d'un hôte MCP pris en charge.

Une édition longue n'a pas besoin d'être gérée. Les hôtes qui mettent en arrière-plan les longs appels d'outils (Claude Code déplace tout appel de plus de deux minutes vers une tâche d'arrière-plan) maintiennent la session utilisable pendant que le tour s'exécute et livrent le résultat lorsqu'il atterrit.

Ancrer la timeline

  • Chaque déclaration visible par l'utilisateur concernant l'état du projet provient de cassette_timeline ou du timeline_delta de l'enveloppe, jamais de la mémoire. Nommez la version : « v42→v43 : introduction réduite à 4.0s. »
  • Préférez relayer timeline_delta et plan_progress plutôt que de redécrire toute la timeline.
  • L'environnement d'exécution ne fournit aucun lien profond vers l'éditeur, et vous ne devez pas en construire ou en proposer un. Cette URL est une capacité de porteur : le backend ne lie aucun propriétaire à une session, donc tout compte connecté qui la voit peut ouvrir le projet et exécuter des modifications sur le thread. Les prévisualisations passent par le digest, la planche contact et l'exportation à la place.
  • Acheminez pratiquement tout via cassette_run_job. cassette_edit est une voie rapide optionnelle pour les petites modifications nommées (couper, retimer, texte, supprimer, annuler) qui reste désactivée sauf si l'opérateur définit CASSETTE_DIRECT_EDIT=1 — aucun hôte d'expédition ne configure cela, donc supposez qu'il est désactivé et n'y recourez qu'une fois qu'un appel cassette_edit a réellement réussi dans cette session ou que l'utilisateur dit l'avoir activé. Lorsque vous l'utilisez, lisez d'abord cassette_timeline et passez expected_version de cette lecture ; une erreur stale_timeline signifie relire et réessayer.

Modèle, niveau de réflexion et mises à jour

  • cassette_config(session_id) montre le choix actuel et les options disponibles ; l'ajout de model=… / thinking_level=… les modifie. Il accepte un identifiant de produit (openai/gpt-5.6-luna) ou une étiquette (« GPT-5.6 Luna »).
  • Les modèles sélectionnables sont GPT-5.6 Luna et GPT-5.4 Mini. Les niveaux de réflexion sont off, minimal, low, medium, high et xhigh. La valeur par défaut est GPT-5.6 Luna avec la réflexion xhigh. La préférence persiste pour la session et s'applique à partir du tour suivant, la même sémantique que le changement de modèle entre les tours dans l'éditeur web. Ne demandez jamais automatiquement ; ne le changez que lorsque l'utilisateur le demande, et confirmez en une ligne.
  • Les instructions MCP portent une ligne UPDATE AVAILABLE: lorsqu'une nouvelle version de Oh My Cassette existe. Mentionnez-la une fois par session avec les deux numéros de version et proposez la commande qu'elle nomme. N'exécutez cette commande qu'après l'accord explicite de l'utilisateur, et ne la reproposez jamais dans la même session — elle remplace le plugin sur le disque, donc dites à l'utilisateur que la nouvelle version s'applique après le rechargement de l'hôte (/reload-plugins dans Claude Code, une nouvelle tâche dans Codex). N'inventez jamais de version ou de commande de mise à jour ; si la ligne est absente, l'installation est à jour et le sujet ne se pose pas.

Annulation et transfert

  • Appelez cassette_cancel_job uniquement lorsque l'utilisateur demande d'arrêter l'édition.
  • Pour un transfert délibéré d'hôte, fournissez le session_id exact et le job_id actif ; l'hôte récepteur devrait commencer par cassette_job_status plutôt que de ré-ingérer ou de démarrer un travail en double.
  • Les fichiers exportés restent dans le répertoire de données partagé Oh My Cassette. Préférez le lien de ressource ou l'URI de fichier retourné plutôt que de relocaliser l'artefact.

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.

Skills associés