Communitygithub.com

linwanjiu/short-video-copy

Convierte una frase como tema en un guion de video corto. Por defecto solo genera el guion y el texto de publicación; la tabla de storyboard se entrega solo si se solicita. Combina preajustes por plataforma/categoría/tono, con modelo de temporización y normas de puntuación. Úsalo cuando el usuario diga 'escribe un guion de video corto/guion de locución/script'.

¿Qué es short-video-copy?

Esta habilidad convierte una frase inicial en un guion completo para video corto, siguiendo una estructura modular de 'motor + preajustes'. Está diseñada para agentes de IA que asisten en la creación de contenido para plataformas como TikTok, Xiaohongshu, WeChat Channels, Bilibili o formato genérico. El agente genera primero un borrador genérico (con guion de locución, storyboard opcional y texto de publicación), luego ajusta basándose en cuatro preguntas fijas (plataforma, tono, estructura, gancho y giro). Soporta personalización mediante un archivo de perfil (`profile.md`) que almacena selecciones persistentes (plataforma, categoría, tono, duración, densidad, persona, CTA, palabras prohibidas) y preajustes en `presets/`. La salida por defecto incluye solo el guion (con marcas de tiempo calculadas mediante un script de temporización) y el texto de publicación; la tabla de storyboard se entrega solo si el usuario la solicita explícitamente. La habilidad incluye una lista de autoverificación (checklist) para garantizar calidad, manejo de retroalimentación (cambios temporales vs. permanentes), y un modo opcional de análisis de videos de referencia para extraer estructuras y estilos. Los límites incluyen no inventar datos, no hacer promesas de resultados en áreas sensibles (salud, finanzas, educación), y no usar lenguaje absoluto sin fuentes verificables.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/linwanjiu/short-video-copy/tree/HEAD/skills/short-video-copy

Preguntar en tu IA favorita

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

Documentación

Guion de Video Corto

Una frase como tema → un guion listo para grabar.

Esta habilidad tiene una estructura de motor + preajustes: la metodología está aquí, los estilos en presets/, y la selección actual en profile.md.


0. Lee primero dos cosas

  1. profile.md — selección actual (platform / category / tone / duration / density / person / cta / banned)
  2. Según el perfil, lee la sección correspondiente en el archivo de preajustes, no el archivo completo
Campo del perfilDónde leerQué sección leer
platformpresets/platforms.mdLa sección del mismo nombre (TikTok / Xiaohongshu / WeChat Channels / Bilibili / Genérico)
categorypresets/categories.mdLa sección del mismo nombre
tonepresets/tones.mdLa sección del mismo nombre
Ganchopresets/hooks.mdElegir 1–2 categorías según el tipo de tema

Los valores del perfil tienen prioridad sobre cualquier valor por defecto de este archivo; si el usuario cambia de opinión durante la sesión, prevalece lo dicho en ese momento.


1. Flujo por defecto: entrega primero, luego ajusta parámetros

Cuando el usuario da una frase, no hagas una lluvia de preguntas primero. Usa el perfil actual (si no hay, usa: genérico / claro y directo / 30 segundos) para entregar una versión completa, que pueda ver, y luego pregunta.

Primer paso: entrega un borrador genérico

Incluye los cuatro elementos (guion de locución + storyboard + texto de publicación), con tiempos calculados según presets/timing.md. Empieza con una nota: «Esta es una versión genérica, no está adaptada a ninguna plataforma» — de lo contrario el usuario pensará que es la versión final.

Segundo paso: cuatro preguntas fijas

Solo estas cuatro, en orden, cada una con opciones. No agregues preguntas adicionales.

1. Plataforma: TikTok / Xiaohongshu / WeChat Channels / Bilibili / ¿Usamos la genérica? — Determina ritmo, velocidad de habla y CTA

2. Tono: Incisivo / Afable / Humorístico / Profesional contenido / Mantener claro y directo — Determina longitud de las frases, verbos y distancia con la audiencia

3. Estructura: Locución en tres partes / Divulgación (conclusión primero + mecanismo) / Historia (experiencia + reflexión) / Trama (conflicto + giro) — Determina el orden y la proporción de los párrafos

4. Giro y gancho: Sin giro / Giro de sentido común a mitad / Giro al final / Doble gancho (detener en los primeros 3 segundos + retener a los 8 segundos) — Determina el diseño de retención

Después de preguntar, añade: «Responde directamente con el número 1/2/3, o con una frase. Lo reescribo según eso.»

Tercer paso: reescribe

  • Modifica solo los párrafos afectados, mantén lo que el usuario aprobó
  • Empieza con una línea que indique qué cambió: Plataforma→TikTok, tono→incisivo, duración 30→15 segundos, giro de sentido común a mitad
  • Después de reescribir, recalcula los tiempos, no uses la tabla anterior

Cuarto paso: ¿recordar?

Si el usuario dice «de ahora en adelante así» / «recuerda» / «cambia el valor por defecto a» → escribe en profile.md según la sección §5 e informa.

Excepciones

SituaciónQué hacer
El usuario indica de inmediato plataforma/tonoSaltar el cuestionario, entregar versión dirigida directamente
El usuario dice «muéstrame la genérica primero»Solo entregar la versión genérica, no preguntar
El usuario solo quiere ganchos, no el texto completoSolo dar 5 opciones de gancho para que elija

1b. ¿Qué falta en la frase?

¿Qué falta?Cómo manejarlo
¿A quién va dirigido?Inferir la audiencia más probable a partir del tema, indicar claramente la suposición
¿Qué acción se espera?Usar el cta del perfil
¿Duración?Usar la duration del perfil
¿Plataforma?Usar la platform del perfil, si no hay, usar «genérica»

En la etapa de borrador genérico, solo añade la suposición más crítica. No hagas una cadena de preguntas. Las preguntas se reservan para el segundo paso (las cuatro preguntas fijas).


2. Ensamblaje: cómo se superponen los cuatro preajustes

El orden no se puede cambiar; cada capa resuelve un problema diferente:

platform  →  determina ritmo, velocidad de habla, CTA (apariencia)
category  →  determina el orden y proporción de los párrafos (esqueleto)
tone      →  determina longitud de frases, verbos, distancia (piel)
hooks     →  determina los primeros 3 segundos (puerta)

Prioridad en caso de conflicto: platform > category > tone. Por ejemplo, Xiaohongshu pide «lento», pero ventas pide «denso». Toma un valor intermedio e indica al final qué compromiso hiciste.

Combinaciones habituales (puedes recomendarlas directamente)

ObjetivoCombinación
Sensación viral en TikTokTikTok + divulgación + incisivo + gancho de sentido común
Recomendación en XiaohongshuXiaohongshu + ventas + afable + escenario de dolor
Confianza en WeChat ChannelsWeChat Channels + IP personal + profesional contenido + historia presente
Contenido duro en BilibiliBilibili + divulgación + profesional contenido + números concretos
Más seguro para principiantesGenérica + locución + claro y directo + sentido común

3. Salida: por defecto solo el guion

No entregues un montón de cosas de entrada. Por defecto solo entrega dos cosas: el guion y el texto de publicación. Si necesita storyboard, pregúntalo antes de darlo.

3.1 Guion (entrega por defecto, único obligatorio)

Guion de locución con línea de tiempo, tres columnas:

TiempoPalabrasTexto
0.0–1.9s6Cuanto más duermes, más cansado te sientes.
  • El tiempo se calcula según presets/timing.md, no a mano; ejecuta directamente node scripts/timing.mjs --rate <velocidad> "texto1" "texto2"
  • Puntuación y estructura de frases estrictamente según presets/punctuation.md: puntuación de ancho completo, cada frase ≤ 15 caracteres, máximo 2 comas por frase
  • El tiempo final debe tener un error ≤ 0.5 segundos respecto a la duración objetivo. Si se pasa, elimina palabras, no intentes compensar hablando rápido
  • Al entregar, no incluyas JSON ni storyboard a menos que el usuario lo pida

3.2 Texto de publicación (entrega por defecto)

Título (≤ 20 caracteres) + 3–5 etiquetas + una frase de guía para comentarios.

3.3 Después de entregar, pregunta obligatoriamente

Después de entregar el guion, pregunta inmediatamente:

¿Necesitas que, basado en este guion, prepare una tabla de storyboard? (qué imágenes para cada frase, texto en pantalla, puntos de tiempo)

  • El usuario dice que sí → entrega 3.4
  • El usuario dice que no o no responde → detente aquí
  • No entregues content.json ni preguntes «¿quieres que lo convierta en video?»

3.4 Tabla de storyboard (solo si el usuario lo pide explícitamente)

#TiempoImagenTexto en pantallaNotas
  • La columna de tiempo copia directamente los tiempos de 3.1, no los reasignes de forma independiente
  • Una frase = un plano; si una frase se divide en dos, escribe 1a/1b, y la suma debe ser igual a la frase original
  • Un plano < 1.2 segundos se fusiona; > 6 segundos se divide
  • Las imágenes solo deben describir algo que se pueda grabar, no escribas «plano vacío con atmósfera»

3.5 Verificación de efectos (solo si el usuario pide explícitamente producir el video)

Solo cuando el usuario dice «quiero producir el video» / «dame un borrador»:

cd <video-studio>
.\check-effects.ps1 -Human
ResultadoAcción
El script no existeEl usuario no tiene la cadena de producción de video → saltar, no lo trates como error
installed=trueContinuar
installed=falsePrimero avisar, luego preguntar, no generar sin permiso

Aún no has generado la biblioteca de efectos (9 elementos, aproximadamente 196 MB). ¿Quieres generarla ahora? Tarda unos 2.5 minutos.

Si el usuario no ha aceptado, no ejecutes la generación.

3.6 Cosas que no se hacen explícitamente

  • No se genera content.json / scenes: eso pertenece al lado del video, el lado del guion no debe cargar con eso
  • No se entrega storyboard de forma proactiva, no se sugiere «¿quieres producir el video?»
  • No se decide por el usuario la plataforma ni el tono—eso está en profile.md

4. Autoverificación

  • Los primeros 3 segundos son un gancho, no una presentación
  • El gancho pertenece a una categoría clara de hooks.md, no mezcla categorías
  • Hay una frase que se pueda capturar y compartir por separado
  • Al menos un número concreto, y el texto principal lo cumple
  • Cada frase de locución ≤ 15 caracteres, leída a la velocidad no supera el tiempo
  • Todo el texto tiene un solo tono, no cambia a mitad
  • La estructura cumple con la proporción de párrafos de la categoría seleccionada
  • Sin lenguaje absoluto (más… / primero / único / eliminar por completo / cien por cien)
  • En temas de salud, finanzas, educación no hay promesas de resultados
  • ¿Contiene alguna palabra de banned? Si la contiene, reescribe esa frase
  • Toda la puntuación es de ancho completo, sin puntos ni comas de ancho medio ,.!?
  • Las comillas son uniformes («» o “”), las elipsis son ……, las rayas son ——
  • No hay frases largas con una sola coma, cada frase ≤ 15 caracteres
  • El formato de números es uniforme (15s / 73%), los números en inglés tienen espacios alrededor

5. Cómo manejar la retroalimentación

Cambia los preajustes, no el motor.

El usuario diceDónde cambiar
Demasiado largo / cortoduration
Demasiado formal / agresivo / empalagosotone
No parece de Xiaohongshu / parece de TikTokplatform
Demasiada información / demasiado vacíodensity
La estructura no es correctacategory
El inicio no funcionaCambiar la categoría de hooks
No digas esta palabrabanned

Cambio temporal vs. cambio permanente (importante)

El usuario diceQué haces¿Se guarda en disco?
«Cambia esta versión a Xiaohongshu»Solo reescribe esta versión con los nuevos parámetros❌ No escribir archivo
«De ahora en adelante usa Xiaohongshu» / «Recuerda» / «Cambia el valor por defecto a»Debes modificar profile.md con herramientas de edición✅ Escribir archivo
«Demasiado agresivo» / «Demasiado empalagoso»Juzga si es temporal o permanente, pregunta o trata como permanente✅ Escribir archivo

Solo decirlo sin escribirlo = no se cambió. Cuando la sesión termina, el contexto se pierde, y la próxima vez se usarán los parámetros antiguos.

Al guardar en disco, debes hacer tres cosas:

  1. Cambiar la línea correspondiente en profile.md
  2. Añadir una línea al final del registro de cambios en profile.md: - YYYY-MM-DD Se cambió tone de X a Y (motivo)
  3. Responder al usuario: «Ya se ha escrito en profile.md: tone: incisivo»

¿Qué hacer si el valor solicitado no está en los preajustes?

Si el usuario pide platform: Zhihu, pero presets/platforms.md solo tiene cuatro plataformas:

  1. Escribe primero con la más cercana (Zhihu ≈ Bilibili texto largo + profesional contenido), indica que hiciste una aproximación
  2. Pregunta si quiere añadirlo a presets/platforms.md
  3. Si quiere añadirlo, completa una sección con el formato existente, no lo metas en SKILL.md

Si el usuario ajusta en la misma dimensión tres veces consecutivas, significa que el preajuste no es lo suficientemente detallado; entonces considera modificar esa sección en presets/.


6. Modo de análisis de referencia (opcional)

Cuando el usuario da un video de referencia (enlace o transcripción) en lugar de un tema, sigue references/analysis.md: Genera tipo de gancho, segmentación de estructura, etiquetas de estilo, razón de ser viral, y 3 direcciones para reescribir.


7. Límites

  • No inventar datos. Si no se proporcionan números, usa cantidades vagas verificables o pregunta directamente.
  • No escribir promesas de resultados concretos en salud, finanzas o educación.
  • Los hechos no verificables se marcan como «pendiente de verificar», no se escriben como conclusión.
  • No usar expresiones absolutas como «más…», «primero», «único» a menos que haya una fuente verificable.

Skills relacionados