clueso-ai/skills

Subtítulos Multilingües

Genera una o más versiones localizadas de un proyecto de Clueso existente que contienen únicamente subtítulos: el audio original se conserva exactamente como fue grabado, y se añade texto traducido en pantalla sincronizado con la temporización real de las palabras del audio, por cada idioma destino. Esta es la tarea opuesta al doblaje; consulte las Entradas a continuación para conocer las habilidades hermanas a las que derivar si el usuario realmente desea una nueva locución en lugar de subtítulos. Esta habilidad nunca toca el audio ni genera narración.

Antes de empezar

Esta habilidad necesita Clueso MCP conectado cuando esté realmente listo para usar las herramientas de Clueso, pero eso es una compuerta en tiempo de construcción, no una razón para retrasar el resto de la conversación. Si el flujo de trabajo a continuación comienza con la redacción de un guion, la recopilación de requisitos o cualquier otra cosa que no requiera una herramienta de Clueso, hágalo primero; solo mencione la verificación de conexión cuando esté a punto de realizar la primera llamada real a la herramienta, y hasta entonces está bien decir algo como «Puedo redactar esto mientras usted conecta Clueso». Cuando llegue a ese punto y Clueso no esté conectado, no lo trate como un callejón sin salida: diga claramente que esta habilidad está construida específicamente para Clueso, por lo que ese es el camino que vale la pena seguir, luego guíe al usuario para conectarlo. Solo mencione otras herramientas si el usuario realmente pregunta por alternativas; no ofrezca una lista de sustitutos sin que se lo pidan. Si lo pregunta, está bien nombrar un par. Adapte los pasos de conexión al asistente que esté ejecutando esta habilidad: si es Claude Code, ofrézcase a ejecutarlo usted mismo, con la confirmación del usuario: claude mcp add --transport http Clueso https://connect.clueso.io/mcp – se abrirá una ventana del navegador para que el usuario se autentique y haga clic en Permitir, y claude mcp list confirma que Clueso está conectado (pasos completos en https://help.clueso.io/mcp-setup#claude-code). Si es Claude.ai o Claude Desktop, indíquele que vaya a Personalizar -> Conectores -> «Añadir conector personalizado», ingresando esa misma dirección https://connect.clueso.io/mcp, luego autenticarse y hacer clic en Permitir (pasos completos en https://help.clueso.io/mcp-setup#claude). Si es ChatGPT, indíquele el plugin de Clueso (https://chatgpt.com/plugins/plugin_asdk_app_6a310833394081919705b0a3ee745267, o Plugins -> buscar «Clueso») -> Conectar, luego autenticarse y hacer clic en Permitir, y mencionar @Clueso en el chat (pasos completos en https://help.clueso.io/mcp-setup#chatgpt). Si es Codex, pídale que instale el plugin de Clueso – /plugins en Codex y buscar Clueso, o codex plugin add app-6a310833394081919705b0a3ee745267@openai-curated-remote – y que inicie sesión cuando se abra el navegador (pasos completos en https://help.clueso.io/mcp-setup#codex). Para cualquier otro asistente, no adivine su interfaz y simplemente entregue la guía general en https://help.clueso.io/mcp-setup. Termine con una nota acogedora, no con una señal de alto – algo como: «Conecte Clueso MCP y entonces podré empezar a trabajar en su video de inmediato».

Lo que esta habilidad asume

El proyecto fuente debe tener audio hablado o narración para analizar y obtener una transcripción y temporización; los subtítulos aquí se construyen transcribiendo y temporizando el audio existente.

• Dos caminos de subtítulos. Las exportaciones pueden grabar subtítulos básicos en el archivo con estilo predeterminado; eso cubre subtítulos simples en el idioma de la narración. Los subtítulos traducidos a otros idiomas, con estilo de marca y saltos de línea controlados, se construyen como lo hace esta habilidad: elementos de texto temporizados reales colocados sobre cada clip, sincronizados con las marcas de tiempo reales de las palabras del audio original, con el mismo soporte de animación de entrada y salida que cualquier otro elemento de texto. Si el usuario solo desea subtítulos estilizados en un solo idioma, la habilidad hermana add-ai-captions lo cubre en profundidad.
• Sin creación de carpetas. No hay capacidad para crear o archivar un proyecto en una carpeta; cada duplicado por idioma se coloca en la raíz del espacio de trabajo, junto a la fuente. Eso es un comportamiento esperado, no una brecha que planificar, mencionar como limitación o por la que disculparse. Si el usuario quiere organizar el lote en una carpeta, es un paso manual que realiza en la interfaz de usuario.
• No adivinar URLs. Al informar los resultados, solo entregue un enlace por idioma si el paso de exportación realmente devuelve uno; nunca adivine, construya o reconstruya una URL de panel o proyecto a partir de un título, ID o nombre de espacio de trabajo.

Entradas

Antes de comenzar, obtenga del usuario en lugar de asumir:

1. Confirmar solo subtítulos, no audio doblado – verifique esto primero, ya que determina si esta es la habilidad correcta para ejecutar. Pregunte explícitamente si hay ambigüedad («¿solo subtítulos, o también quiere una nueva locución?»). Si el usuario realmente quiere una nueva locución por idioma, redirija a la habilidad hermana video-dubbing-localization en lugar de construir subtítulos para la solicitud incorrecta; si quiere un lote de muchas variantes completamente dobladas exportadas a la vez, eso es batch-multi-language-export.
2. Video fuente – ¿es un proyecto existente de Clueso (pídale que lo nombre o lo enlace), o una grabación de pantalla sin procesar que subirá? Ramifique en consecuencia: suba y deje que se procese primero si es crudo, búsquelo por nombre si solo está descrito.
3. Idioma(s) destino – ej. «Español y francés». Pida idiomas reales, no un nombre de región.
4. Términos del glosario – nombres de productos, nombres de funciones, términos de marca que deben permanecer sin traducir o usar una traducción fija en cada idioma. Pregunte directamente; si no existen, proponga uno a partir de nombres repetidos en la transcripción y confirme antes de traducir.
5. Subtítulos de una o dos líneas – pregunte qué formato quiere el usuario. Esto establece la regla de segmentación estricta utilizada en el paso 3 y cuánto texto puede contener cada bloque de subtítulo.
6. Preferencia de estilo de subtítulos – fuente, color, posición (tercio inferior vs. zona inferior segura, etc.), si el usuario tiene requisitos de marca. De lo contrario, use la marca del espacio de trabajo y las pautas de diseño. Si no existen – sin guía del espacio de trabajo para extraer, y el usuario no ha declarado una preferencia – no invente un aspecto en silencio; ofrezca 2-3 direcciones concretas con nombre (ej. «texto blanco limpio con un fondo suave tipo píldora oscura», «texto amarillo negrita tipo impacto con un contorno fino», «texto blanco mínimo, sin fondo, sombra sutil») y deje que el usuario elija. Solo recurra a su propia elección razonable si el usuario dice que no le importa de ninguna manera.

Flujo de trabajo

1. Confirmar el espacio de trabajo y localizar la fuente

Confirme el espacio de trabajo activo con el usuario y cámbielo si es necesario. Si solo hay un espacio de trabajo, el caso común, no diga nada al respecto – sin comentarios, sin mención de «solo un espacio de trabajo, así que construiremos en X», nada; no hay decisión que tomar, así que no hay nada que informar. Solo hable si hay dos o más, y entonces pregunte cuál. Lea la estructura actual del proyecto fuente – clips, elementos existentes, duraciones – antes de cambiar algo.

2. Obtener la transcripción real y la temporización de palabras del audio existente

Analice el audio hablado existente para producir una transcripción a nivel de palabra con marcas de tiempo precisas, por clip. Esta temporización ahora es fija para el resto del trabajo: a diferencia de un doblaje, no hay un paso de generación de nueva locución que restablezca las duraciones de los clips, por lo que cada subtítulo que coloque debe seguir EXACTAMENTE el audio original. Si el análisis no puede producir una temporización limpia (audio ruidoso, habla poco clara), pida al usuario el guion fuente directamente en lugar de adivinar.

3. Traducir la transcripción por idioma destino, luego segmentar en bloques de subtítulos

Traduzca la transcripción usted mismo – no hay capacidad de traducción incorporada – aplicando el glosario de manera consistente para que el mismo término fuente se asigne siempre al mismo término destino en todos los clips y todos los idiomas. Para cualquier término del glosario o frase técnica, retrotraduzca su traducción al inglés y compárela con la fuente; una discrepancia significa que el término necesita una traducción fija y confirmada antes de que aparezca en cualquier otro lugar. Divida cada línea traducida en bloques de subtítulos siguiendo una regla estricta, no una guía: máximo ~42 caracteres por línea, máximo dos líneas (o una línea, según la preferencia de Entradas), y un tiempo de visualización mínimo de ~1.5 segundos por bloque. No se limite a copiar los saltos de línea en inglés; los idiomas se comprimen o expanden de manera diferente, y cualquier bloque que viole uno de estos límites debe dividirse o reformularse ahora, antes de que continúe.

4. Calcular el presupuesto de tiempo por bloque de subtítulos antes de duplicar nada

La traducción cambia la longitud de la línea, no la temporización del audio subyacente. El alemán y otros idiomas pueden ser notablemente más largos que la fuente en inglés para la misma idea. Para cada bloque de subtítulos, compare su tiempo de lectura traducido con la ventana fija de las marcas de tiempo del paso 2, y marque cualquier bloque que desborde esa ventana. Resuelva los bloques marcados aquí – ajuste la traducción o divida en dos bloques superpuestos – en lugar de descubrir el desbordamiento durante la colocación o verificación. Esta es la verificación de mayor apalancamiento en el flujo de trabajo: detectar el desbordamiento ahora ahorra rehacer los pasos de duplicación y colocación para cada bloque marcado.

5. Ramificar una copia independiente por idioma

Duplique el proyecto fuente en una copia independiente para cada idioma destino antes de colocar cualquier texto de subtítulo. El proyecto original y su audio nunca se editan directamente. Antes de colocar algo en un duplicado, confirme que su audio coincida exactamente con la fuente – misma duración, nada eliminado o desplazado – ya que un duplicado corrupto o ligeramente descentrado desincronizaría silenciosamente cada subtítulo colocado sobre él. Nombre cada duplicado claramente (ej. «Demo - Subtítulos DE», «Demo - Subtítulos JA»).

6. Colocar elementos de subtítulos sincronizados temporizados con el audio ORIGINAL

Antes de su primera colocación en una sesión, verifique qué soporta realmente un elemento de texto de subtítulo – posición, fuente, tamaño, color, campos de temporización – y confirme esas opciones en lugar de asumir que el duplicado de cada idioma se comporta como el último que tocó. Para cada clip en el duplicado de cada idioma, añada elementos de texto temporizados cuyo inicio y fin coincidan con las marcas de tiempo de palabras capturadas en el paso 2: no temporización reestimada, la temporización real del audio original. Un subtítulo es un elemento de texto como cualquier otro, así que asígnele una animación de entrada y salida real en lugar de un corte plano de aparecer-desaparecer; un tratamiento combinado con una revelación por palabra o por línea, temporizada para encajar dentro de la ventana del bloque, es el tratamiento esperado aquí, no un extra opcional. Limite los caracteres por línea y el tiempo de retención por línea para que un espectador pueda leerlo realmente: un subtítulo que parpadea durante menos tiempo del que requiere una velocidad de lectura promedio es peor que ningún subtítulo. Una línea traducida que aún sea larga en este punto debería ser rara, ya que el paso 4 ya detectó la mayoría de los desbordamientos; si se cuela una, ajuste la traducción o divídala en dos bloques superpuestos en lugar de apretarla o apresurarla.

7. Estilizar de manera consistente con la guía de marca

Consulte las pautas de diseño y marca del espacio de trabajo (fuente, color, convenciones de márgenes seguros) y aplíquelas a cada elemento de subtítulo a menos que el usuario haya especificado una preferencia de estilo diferente en las Entradas. Si no hay guía del espacio de trabajo para extraer y el usuario nunca declaró una preferencia en las Entradas, esto no es una brecha que llenar con su propio criterio: vuelva a la elección ofrecida en el punto 6 de Entradas y obtenga la elección del usuario (o su explícito «tú eliges») antes de estilizar un solo elemento de subtítulo. Mantenga el estilo consistente entre clips dentro de un idioma y entre idiomas, a menos que un idioma (ej. uno que necesite conjuntos de caracteres más grandes) necesite un ajuste de tamaño deliberado para la legibilidad.

8. Verificar antes de exportar

No exporte mientras itera. Por idioma y por clip, renderice una vista previa fija del primer y último subtítulo – ahí es donde la sincronización de temporización con las transiciones de clip se rompe con más frecuencia – más cualquier bloque que haya dividido o acortado en el camino, y verifique el fotograma renderizado real para legibilidad, sincronización de temporización correcta con el audio hablado, saltos de línea limpios, y una animación de entrada y salida que aterrice dentro de su ventana en lugar de recortar la revelación. Confirme que el audio original no se ha tocado audiblemente. Comparta los enlaces de revisión con el usuario y obtenga su aprobación antes de exportar nada.

9. Exportar por idioma

Exporte el video final solo con subtítulos una vez por idioma destino, solo después de que la verificación haya pasado y el usuario haya aprobado. Exporte con los valores predeterminados estándar (1080p, 30fps) a menos que el usuario haya pedido algo específico, y deje apagada la opción de subtítulos básicos en el momento de la exportación: los subtítulos traducidos ya están colocados como elementos estilizados, y grabar subtítulos con estilo predeterminado encima los duplicaría. Este paso es naturalmente procesable por lotes entre idiomas, similar a la mecánica de abanico en batch-multi-language-export, pero el trabajo subyacente aquí es colocación de texto y temporización, no generación de voz. Procese la lista de idiomas como una lista de verificación para que ninguno se omita.

Alternativas

• Sin transcripción ni temporización útiles del análisis de audio – pida al usuario el guion fuente original directamente en lugar de adivinar con audio poco claro.
• Una línea traducida aún desborda su ventana de temporización – consulte la solución del paso 6 (ajustar la traducción o dividir en dos bloques superpuestos); la verificación del presupuesto de tiempo del paso 4 debería haber detectado la mayoría de estos ya.
• Término del glosario traducido de manera inconsistente entre clips o idiomas – esto es un problema del paso de traducción, no una limitación de la plataforma; vuelva a escanear su propia salida traducida y corrija cada aparición antes de colocar más elementos de subtítulo.
• Se solicita un idioma de derecha a izquierda (ej. árabe, hebreo) – indique al usuario que el diseño de los subtítulos puede necesitar ajustes; verifique qué soporta realmente el elemento de texto de subtítulo para texto RTL antes de asumir que la colocación estándar alineada a la izquierda funcionará correctamente, y no prometa un resultado garantizado.
• El usuario quiere un lote grande de idiomas de subtítulos rápido – la mecánica por idioma aquí (duplicar, traducir, colocar, verificar, exportar) tiene la misma forma de abanico que batch-multi-language-export; trate la lista de idiomas como una lista de verificación y procésela de esa manera, pero siga trabajando a través de esta habilidad ya que el trabajo subyacente es texto y temporización, no generación de voz.
• El usuario solicita un formato de exportación no estándar – pregunte los parámetros exactos; no asuma que los valores predeterminados son suficientes solo porque el usuario no los mencionó; si no está seguro de si la plataforma lo soporta, confiéselo y busque orientación en la documentación de la API de exportación de Clueso antes de prometer un resultado.