Communitygithub.com

bujiandan168-sys/douyin-script

Escribe guiones para videos verticales cortos de Douyin (TikTok chino), WeChat Channels (视频号) y Kuaishou: gancho de 3 segundos, voz en off calibrada por duración, storyboard ejecutable, subtítulos línea por línea, título y hashtags, con autoverificación de cumplimiento de la Ley de Publicidad y marcado de contenido de IA.

¿Qué es douyin-script?

Este skill genera guiones completos para videos verticales cortos (short-form vertical videos) enfocados en plataformas chinas como Douyin (TikTok chino), WeChat Channels (视频号) y Kuaishou. Permite producir desde un gancho inicial de 3 segundos hasta un storyboard detallado, subtítulos en formato SRT, y metadatos de publicación (título, hashtags, texto de portada). El flujo de trabajo incluye 8 pasos: 1) completar información faltante (máximo 2 preguntas), 2) definir el mensaje principal, duración y llamada a la acción (CTA), 3) escribir 3 ganchos y seleccionar el mejor, 4) redactar el guion completo con conteo de palabras calibrado por duración, 5) desglosar en storyboard (cada 2-4 segundos un cambio de plano), 6) generar subtítulos (≤14 caracteres por línea), 7) autoverificar con un script de Python o una lista de verificación manual, y 8) entregar en una plantilla estandarizada. El skill también incluye verificaciones de cumplimiento legal: prohibición de términos absolutos (como 'mejor', 'primero'), afirmaciones de salud o curación no verificadas, y la obligación de etiquetar contenido generado por IA según la normativa china (vigente desde septiembre de 2025). Es especialmente útil para guiones de venta, promoción de tiendas, videos educativos o de conocimiento, y para adaptar artículos o material promocional a formato de video corto. No está diseñado para transmisiones en vivo, videos largos (como en Bilibili) o publicaciones de Xiaohongshu.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bujiandan168-sys/bujiandan168-sys.github.io/tree/HEAD/skills/douyin-script

Preguntar en tu IA favorita

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

Documentación

Guion para video vertical de Douyin / WeChat Channels

Genera un guion de video vertical corto listo para grabar y editar: gancho → desarrollo → clímax → llamada a la acción.

Flujo de trabajo

- [ ] 1. Completar información faltante (máximo 2 preguntas)
- [ ] 2. Definir mensaje principal + duración + CTA única
- [ ] 3. Escribir 3 ganchos, elegir 1
- [ ] 4. Redactar guion completo, calibrado por duración
- [ ] 5. Desglosar en storyboard
- [ ] 6. Generar subtítulos
- [ ] 7. Autoverificar (guion + lista de verificación), corregir hasta aprobar
- [ ] 8. Entregar según plantilla

1. Completar información faltante

Solo preguntar si falta información crucial, máximo 2 preguntas. Priorizar: ¿Se puede grabar con persona real? / ¿Qué material visual hay disponible? (determina si el storyboard es ejecutable) y ¿Cuál es la única acción que quieres que haga el espectador? (seguir/comentar/visitar tienda/añadir al carrito).

Si no se especifica, usar valores por defecto: plataforma = Douyin; duración = 45 segundos; persona real hablando + grabación con teléfono + algunos planos de producto/entorno; CTA = comentar.

2. Mensaje principal y duración

  • Un video solo trata un tema, máximo 3 puntos de información.
  • Número de palabras del guion = duración (segundos) × 4–5 palabras/segundo (valor empírico, ritmo normal). 45 s ≈ 180–225 palabras, 60 s ≈ 240–300 palabras.
  • Distribución del tiempo: gancho 0–3 s | introducción 10–15% | cuerpo 60–70% (cada 5–8 s un punto de información o cambio de imagen) | clímax 5–10% | CTA últimos 3–5 s.

3. Gancho

Escribir 3 opciones, marcar la recomendada. Cada gancho debe tener una acción visual y una frase:

  • La primera frase ≤15 caracteres, en el primer segundo ya hay acción o cambio. No empezar con «Hola a todos, soy…».
  • La promesa del gancho debe cumplirse en el video; de lo contrario, el espectador se sentirá engañado y no interactuará.

Por defecto usar «resultado primero» (mostrar el resultado final + una conclusión). Los 8 tipos de gancho y las estructuras principales para videos de venta, conocimiento o tienda están en references/hooks-and-structures.md (leer la sección correspondiente al escribir para venta/conocimiento/tienda).

4. Guion completo

  • Usar «tú» en lugar de «usuario»; frases cortas; se permiten interjecciones; números en dígitos arábigos.
  • Cada punto de información = opinión + ejemplo/demostración + una frase destacada (citable).
  • Cada párrafo indicar segundos estimados y número de palabras. El total debe estar dentro del rango calculado en el paso 2.

5. Storyboard

Usar el encabezado de assets/storyboard-template.md. Reglas: cambiar de plano o encuadre cada 2–4 segundos; un solo plano no debe durar más de 15 segundos; cada fila de «contenido visual» debe ser tan clara que quien grabe sepa exactamente qué filmar (sujeto + acción + encuadre).

6. Subtítulos

  • Máximo 14 caracteres por línea, máximo 2 líneas por pantalla, con saltos por sentido.
  • Máximo 1 palabra clave con estilo llamativo por pantalla.
  • Colocar los subtítulos en la parte central-inferior de la imagen, evitando la columna de interacción derecha y la zona de texto inferior.
  • Entregar también en formato SRT para importar a CapCut (剪映).

7. Autoverificación (obligatoria)

python3 scripts/check_copy.py --platform douyin --body-file <guion_completo> --seconds <duración_objetivo>

Verifica velocidad de habla (3.5–5 palabras/segundo), términos absolutos/medicinales, información de contacto. Procesar cada advertencia (WARN). Si no hay Python, verificar manualmente según la «Lista de verificación previa a la entrega».

8. Plantilla de entrega

## Información del video
Plataforma: … | Duración: … s | Palabras guion: … | Velocidad: … palabras/s | Acción objetivo: …

## Opciones de gancho
1. [Visual] … [Guion] … (Recomendado: <motivo>)
2. …
3. …

## Guion completo
[0–3s | Gancho | … palabras] …
[3–8s | Introducción | … palabras] …
…

## Storyboard
<según assets/storyboard-template.md>

## Subtítulos (SRT)
1
00:00:00,000 --> 00:00:02,500
…

## Información de publicación
Título: … | Hashtags: #… #… #… (3–5) | Texto de portada: …

## Consejos de grabación (≤3)
- …
- Pendiente del usuario: <【Pendiente】; si no, escribir «Ninguno»>

Errores comunes / Gotchas

  • La tasa de finalización es solo una señal: El centro de seguridad y confianza de Douyin explica que el sistema de recomendación evalúa múltiples comportamientos del usuario (ver completo, dar like, comentar, compartir, seguir) y los pondera según su valor. El objetivo principal es el «valor a largo plazo del usuario». Por lo tanto, no acortes el video solo para aumentar la tasa de finalización, ni uses ganchos engañosos que no tengan relación con el contenido. Los primeros 3 segundos retienen al espectador; luego, retenlo con densidad de información y cumplimiento de la promesa. Las umbrales como «si la tasa de salida en 3 segundos supera el X% se detiene la difusión» no tienen respaldo oficial y no deben incluirse en la entrega.
  • El contenido de IA debe declararse activamente: La «Medida para la identificación de contenido generado por IA» entra en vigor el 1 de septiembre de 2025. Douyin exige que al publicar contenido generado por IA se active la identificación de IA en la página de publicación; el contenido no declarado puede ser etiquetado por la plataforma. Si el guion incluye voz en off generada por IA, avatares digitales o imágenes generadas por IA, recordar al usuario en los «Consejos de grabación» que active la declaración.
  • Si hay enlace de compra en videos de venta/visita a tienda, debe etiquetarse como «publicidad»: Artículo 9 del «Reglamento de gestión de publicidad en Internet»: las reseñas de experiencias o consumo que incluyan enlaces de compra deben mostrar claramente la etiqueta «publicidad».
  • Términos absolutos y afirmaciones de salud/eficacia también aplican en videos cortos y subtítulos (más, primero, el más bajo del mercado; en alimentos/cosméticos no se puede decir que curan o adelgazan). Ver references/ad-compliance-cn.md. Leerlo antes de escribir guiones de venta, tiendas o productos con efectos.
  • Precios y ofertas deben incluir condiciones y plazos (Artículo 8 de la Ley de Publicidad): «Al visitar la tienda, diga la contraseña y obtenga un descuento» debe especificar la fecha de caducidad y el número de usos por persona.
  • Música de fondo usar la biblioteca de la plataforma o música con licencia. Las imágenes que incluyan retratos de otras personas o tiendas de terceros requieren consentimiento.
  • La velocidad de habla es un valor empírico (4–5 palabras/segundo), no una regla de la plataforma. El usuario final debe ajustar según su lectura real.

Lista de verificación previa a la entrega

  • El número de palabras del guion está dentro del rango de «duración × 4–5»
  • Los primeros 3 segundos tienen acción visual y frase de gancho, y la promesa se cumple después
  • Cada línea del storyboard es ejecutable, cambio cada 2–4 segundos
  • Solo hay 1 CTA principal
  • Subtítulos con máximo 14 caracteres por línea, acompañados de SRT
  • Sin términos absolutos ni afirmaciones de salud; ofertas con condiciones y plazos
  • En caso de venta con enlace, se ha recordado etiquetar como «publicidad»; contenido de IA recordado declarar
  • Material faltante marcado con 【Pendiente】

Archivos de referencia (leer según necesidad)

Autoverificación para eliminar el estilo «IA» (revisar antes de entregar)

  • Eliminar palabras como «en primer lugar», «en segundo lugar», «en resumen», «cabe destacar», «empoderar», «crear»; reemplazar con hechos concretos, números o escenarios.
  • Variar la longitud de las frases, no hacer que cada párrafo tenga tres puntos paralelos ni que cada frase sea simétrica.
  • Incluir al menos un detalle que solo una persona real podría mencionar (experiencia personal, precio específico, error que ha cometido).
  • Eliminar cualquier dato sin fundamento o adjetivos exagerados, o marcar como «por verificar».

Skills relacionados