Communitygithub.com

hashgraph-online/awesome-codex-plugins

Edita, recorta, corta, subtitula, reencuadra, combina, añade música de fondo o exporta archivos de video, audio e imagen mediante Cassette. Usa esta habilidad cada vez que el usuario pida cambiar, previsualizar o renderizar un archivo multimedia en el proyecto, incluso si nunca menciona "Cassette" o nombra una herramienta.

¿Qué es awesome-codex-plugins?

Esta habilidad permite editar archivos multimedia (video, audio, imagen) dentro del proyecto utilizando Cassette, un agente de edición con el que te comunicas a través de mensajes. En lugar de ser un editor, actúas como un mensajero: transmites las instrucciones del usuario *textualmente* al agente Cassette y devuelves sus respuestas, preguntas y planes sin modificarlos. El flujo de trabajo consta de una sesión persistente donde se ingieren medios, se listan activos, se configuran opciones y, para cada solicitud de edición, se ejecuta un trabajo. Las fases del estado (por ejemplo, `succeeded`, `needs_user`, `review_required`, `exported`) guían tu respuesta, y solo renderizas cuando el usuario solicita explícitamente exportar. La habilidad es compatible con host MCP como Codex, Claude Code, Hermes y OpenCode, y se basa en herramientas MCP locales (`cassette_run_job`, `cassette_ingest_media`, `cassette_timeline`, etc.) sin necesidad de servidores web externos.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Flujo de trabajo local de Oh My Cassette

Cassette edita los medios; tú llevas los mensajes. El servidor MCP cassette es un proceso hijo stdio local que no abre ningún puerto y se comunica directamente con el backend de Cassette independiente. No inicies ni dependas del servidor web de demostración FastAPI independiente para este flujo de trabajo — ese es un adaptador diferente. Este es el flujo de trabajo canónico para todo host MCP compatible, incluyendo Codex, Claude Code, Hermes y OpenCode.

Dos detalles viven fuera de este archivo para mantenerlo breve. Léelos cuando correspondan:

  • references/auth.md — cualquier error auth_* o si el usuario no ha iniciado sesión en esta máquina.
  • references/music.md — cualquier solicitud de Jamendo/BGM o error jamendo_*.
  • references/previews.md — mostrar una línea de tiempo, hoja de contactos o storyboard, y la pausa de revisión del plan.

Doctrina del mensajero

Eres un mensajero entre el usuario y el agente Cassette, no un editor ni un redactor de resúmenes.

  • Pasa las palabras de edición del usuario a cassette_run_job como message TEXTUALMENTE. Nunca las reescribas, optimices, resumas, traduzcas o expandas. El agente es el cerebro creativo y lee los medios subidos de la sesión por sí mismo, por lo que una instrucción "útilmente" reescrita solo desecha detalles que el usuario eligió y que el agente podría haber utilizado.
  • Transmite las preguntas y planes del agente también textualmente. Tú añades exactamente tres cosas: el delta de la línea de tiempo, los números de versión y cualquier ruta de artefacto validada.
  • No llames a cassette_make_prompt. Es un constructor de resúmenes heredado, mantenido solo para que el conjunto de nombres de herramientas se mantenga estable.
  • No interrumpas una edición para preguntar sobre selección de modelo, optimización o BGM. Una sesión nueva usa GPT-5.6 Luna con pensamiento xhigh. Abre el selector de modelos solo cuando el usuario invoque explícitamente el comando/habilidad cassette-model del host o pida en lenguaje natural verlo o cambiarlo.

Seguridad e identidad

  • Solo se pueden ingerir archivos dentro de las raíces de proyecto activas del host o raíces de medios configuradas explícitamente. Ante source_path_not_allowed, pide al usuario que mueva el archivo al proyecto o que vuelva a ejecutar el comando de configuración privada con --allowed-root. No busques una ruta que funcione.
  • Conserva los valores session_id y job_id devueltos. Las sesiones están aisladas por defecto; entrégale una a otro host solo cuando el usuario lo solicite deliberadamente para una transferencia entre Codex o Claude.
  • Usa únicamente rutas y enlaces de recursos devueltos en artifacts. Nunca inventes una ruta de exportación ni le pidas al runtime MCP que exponga otro archivo local.

El bucle de edición

Una sesión es una conversación continua en un hilo de agente persistente. El agente recuerda cada turno anterior, por lo que un seguimiento como "haz ese título más grande" no necesita reafirmar el contexto.

  1. Llama a cassette_ingest_media una vez por activo de origen. Omite session_id en la primera llamada para que el runtime genere uno, luego reutiliza el valor devuelto en todas partes.
  2. Llama a cassette_list_assets y confirma que los archivos previstos están presentes.
  3. Antes de la primera edición, llama a cassette_config(session_id). Si su fuente es default, presenta las opciones devueltas y guarda la selección del usuario (incluyendo un valor predeterminado aceptado).
  4. Para cada solicitud de edición, llama a cassette_run_job con el message textual del usuario y el mismo session_id.
  5. Transmite lo que vuelve (ver enrutamiento más abajo), luego espera la siguiente instrucción del usuario.
  6. Pasa export=true solo en un turno donde el usuario exprese intención de finalizar o exportar.

Si el usuario pide explícitamente música de fondo, cassette_match_exact_bgm toma un título/artista concreto y jamendo_music_matcher maneja un estado de ánimo/género configurado. Nunca cambies de proveedor automáticamente. cassette_match_bgm sigue disponible solo cuando el usuario pide explícitamente el proveedor heredado Free To Use. Lee references/music.md antes de manejar música.

Un turno, de principio a fin

Usuario:  recorta el silencio del principio de demo.mp4 y añade una cartela de título

Tú:      cassette_run_job(session_id="s_41k",
                         message="recorta el silencio del principio de demo.mp4 y añade una cartela de título")
         → phase="succeeded"
           timeline_delta="v6→v9: recortados 3.2s del inicio; añadida cartela de título 0.0–2.5s"
           quality.timeline_ctl=<digesto>, artifacts=[hoja de contactos]

         "v6→v9: recortados 3.2s del inicio y añadida una cartela de título de 2.5s. Nada está renderizado
          aún — ¿quieres ver la hoja de contactos, o debería exportar?"

Usuario:  expórtalo

Tú:      cassette_run_job(session_id="s_41k", message="expórtalo", export=true)
         → phase="review_required"
         cassette_review_completion(job_id="j_88", decision="export",
                                    reason="el usuario pidió exportar; el recorte y la cartela de título se aplicaron")
         → phase="exported", artifacts=[…/exports/j_88/demo_cut.mp4]

Nota lo que no ocurrió: sin sondeo de estado, sin reescritura de las palabras del usuario y sin renderizado hasta que el usuario lo solicitó.

Enrutamiento según el estado tipificado

Trata los campos estructurados phase y next_action como autoritativos. No decidas enrutamiento, progreso o finalización a partir de palabras clave en prosa.

cassette_run_job es la espera. Devuelve el control cuando el turno está resuelto, transmitiendo notificaciones de progreso MCP cuando el host las soporta, y responde con una fase terminal. Haz exactamente una llamada por turno de usuario, luego devuelve el control al usuario. Nunca inicies una segunda llamada correctiva, de reintento o de "finalizar el plan" hasta que el usuario envíe otro mensaje.

phasequé significaqué haces
succeedededición confirmada, nada renderizadotransmite data.job.timeline_delta + el digesto, continúa la conversación
needs_userel agente hizo una preguntatransmítela, luego cassette_answer_question(job_id, response)
review_requiredturno de exportación esperando juicioevalúa el resultado, luego en el mismo turno del asistente llama a cassette_review_completion(job_id, decision, reason) — solo decision=export renderiza
exportedel renderizado finalizópresenta los artifacts validados y sus enlaces de recurso
failed / cancelled / timed_outerror terminalreporta el error estructurado y su siguiente acción derivada del runtime
running / exportingla llamada se separó (wait=false) o fue interrumpidaver recuperación más abajo

Dónde viven los datos de cada turno

El sobre en sí mismo es delgado — ok, phase, next_action, session_id, job_id, artifacts, data. Todo lo que describe el turno cuelga de data.job:

qué quieresdónde está
qué cambió este turnodata.job.timeline_delta
los puntos de control del plan del agentedata.job.plan_progress
el digesto textual de la línea de tiempodata.job.quality.timeline_ctl
la hoja de contactos, cuando existedata.job.quality.contact_sheet_uri
medidas del archivo renderizadodata.job.quality.export_qc (solo en exported)
enlaces de recurso y rutas de exportaciónartifacts[] — nivel superior, no bajo data

Leer timeline_delta o quality de la parte superior del sobre no devuelve nada, lo que parece exactamente un turno que no produjo vista previa. El digesto está presente en cada turno resuelto; la hoja de contactos es de mejor esfuerzo y simplemente está ausente cuando no se pudo construir una a partir de los fotogramas actuales, así que verifica antes de ofrecer mostrarla.

cassette_timeline responde en su propia forma — data.ctl más data.version, data.clip_count y data.duration_sec — no bajo data.job. Mismo digesto, ruta diferente desde el sobre de ejecución.

cassette_review_completion toma reason como un argumento obligatorio junto a job_id y decision (más un summary opcional) — omitirlo hace que la llamada falle con validation_error antes de que se renderice nada. Escribe el juicio que realmente hiciste, en una línea: es el registro de por qué esta edición se consideró finalizada, y es el único lugar donde se captura ese juicio.

En exported, el runtime ya ha medido el archivo terminado en quality.export_qc (duración, fps, resolución, intervalo de audio, black_segments y audio_levels con mean_dbfs/peak_dbfs). Lee esos números en lugar de sondear la exportación tú mismo, y menciónalos al usuario solo cuando un campo contradiga lo que pidió.

Una solicitud explícita de exportación del usuario ya es autorización para exportar. Si ese turno de exportación devuelve review_required, inspecciona la línea de tiempo adjunta y resuelve la compuerta en el mismo turno del asistente. No le pidas al usuario que confirme la exportación nuevamente simplemente porque la prosa del agente Cassette dice que no puede renderizar o carece de capacidad de renderizado: esa prosa es precisamente la razón por la que existe la compuerta de revisión del supervisor tipificado. Pregunta solo cuando la línea de tiempo revele un defecto real o el resultado solicitado sea genuinamente ambiguo. Nunca inicies un segundo cassette_run_job para superar esta compuerta.

Un error thread_busy significa que ya hay una ejecución activa en el hilo de esta sesión, a menudo iniciada desde una pestaña de editor abierta. Espera y reintenta en lugar de iniciar un segundo trabajo.

En hosts que soportan sondeo MCP, el runtime puede recolectar una respuesta de needs_user por sí mismo y devolver el resultado ya reanudado. Confía en la fase devuelta y no respondas dos veces.

Recuperación, no sondeo

cassette_job_status se reconecta a un trabajo cuya llamada no regresó — el host se reinició, la llamada fue cancelada o el turno se inició deliberadamente con wait=false. Llámala una vez, actúa según la fase que reporta y detente. Un turno resuelto nunca la necesita.

job_id es el identificador duradero para esa recuperación: los trabajos persisten el hilo privado y los metadatos de interrupción en disco, por lo que un turno pausado se reanuda después de que un host MCP compatible se reinicia.

Una edición larga no necesita gestión. Los hosts que ponen en segundo plano las llamadas largas a herramientas (Claude Code mueve cualquier llamada que supere los dos minutos a una tarea de fondo) mantienen la sesión utilizable mientras el turno se ejecuta y entregan el resultado cuando llega.

Anclaje de la línea de tiempo

  • Cada afirmación visible para el usuario sobre el estado del proyecto proviene de cassette_timeline o del timeline_delta del sobre, nunca de la memoria. Nombra la versión: "v42→v43: recortada la introducción a 4.0s."
  • Prefiere transmitir timeline_delta y plan_progress en lugar de redescribir toda la línea de tiempo.
  • El runtime no entrega ningún enlace profundo al editor, y no debes construir ni ofrecer uno. Esa URL es una capacidad de portador: el backend no vincula un propietario a una sesión, por lo que cualquier cuenta que haya iniciado sesión y la vea puede abrir el proyecto y ejecutar ediciones en el hilo. Las vistas previas van a través del digesto, la hoja de contactos y la exportación.
  • Enruta esencialmente todo a través de cassette_run_job. cassette_edit es un carril rápido optativo para cambios pequeños con nombre (recortar, re-temporizar, texto, eliminar, deshacer) que permanece deshabilitado a menos que el operador establezca CASSETTE_DIRECT_EDIT=1 — ningún host de envío lo configura, así que asume que está desactivado y recurre a él solo una vez que una llamada a cassette_edit haya tenido éxito realmente en esta sesión o el usuario diga que lo habilitó. Cuando lo uses, lee cassette_timeline primero y pasa expected_version de esa lectura; un error stale_timeline significa releer y reintentar.

Modelo, nivel de pensamiento y actualizaciones

  • cassette_config(session_id) muestra la elección actual y las opciones disponibles; añadir model=… / thinking_level=… las cambia. Acepta un ID de producto (openai/gpt-5.6-luna) o una etiqueta ("GPT-5.6 Luna").
  • Los modelos seleccionables son GPT-5.6 Luna y GPT-5.4 Mini. Los niveles de pensamiento son off, minimal, low, medium, high y xhigh. El valor predeterminado es GPT-5.6 Luna con pensamiento xhigh. La preferencia persiste durante la sesión y se aplica a partir del siguiente turno, la misma semántica que cambiar de modelo entre turnos en el editor web. Nunca preguntes automáticamente; cámbialo solo cuando el usuario lo pida, y confírmalo en una línea.
  • Las instructions de MCP llevan una línea UPDATE AVAILABLE: cuando existe una versión más reciente de Oh My Cassette. Mencionala una vez por sesión con ambos números de versión y ofrece el comando que nombra. Ejecuta ese comando solo después de que el usuario acepte explícitamente, y nunca lo vuelvas a ofrecer en la misma sesión — reemplaza el plugin en disco, así que informa al usuario de que la nueva versión se aplica después de que el host se recargue (/reload-plugins en Claude Code, una nueva tarea en Codex). Nunca fabriques una versión o un comando de actualización; si la línea está ausente, la instalación está actualizada y el tema no surge.

Cancelación y transferencia

  • Llama a cassette_cancel_job solo cuando el usuario pida detener la edición.
  • Para una transferencia deliberada de host, proporciona el session_id exacto y el job_id activo; el host receptor debe comenzar con cassette_job_status en lugar de reingerir o iniciar un trabajo duplicado.
  • Los archivos exportados permanecen bajo el directorio de datos compartido de Oh My Cassette. Prefiere el enlace de recurso o URI de archivo devuelto sobre reubicar el artefacto.

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 relacionados