Communitygithub.com

zenstory-ai/drama-skills

Suíte de habilidades para creación de series cortas de AI (dramas/comedias) para Claude Code y Codex: guiones, activos, storyboards, indicaciones de imagen/vídeo y revisión independiente.

¿Qué es drama-skills?

Este skill proporciona un flujo de trabajo completo para la creación de series cortas de drama (AI short-drama) utilizando asistentes de IA como Claude Code y Codex. Cubre todo el proceso: desde la inicialización del proyecto, desarrollo de ideas, escritura de guiones, desglose de personajes y activos, generación de storyboards, creación de indicaciones para imágenes y vídeos, hasta la revisión final y exportación. Está diseñado para seguir un flujo de trabajo 'creator-first', donde cada episodio mantiene cinco documentos clave (guion, configuración visual, storyboard, indicaciones de imagen, indicaciones de vídeo) sin estructuras paralelas. El skill incluye herramientas de línea de comandos (scripts en Python) para inicializar proyectos, iniciar un dashboard web para visualizar y editar archivos, y exportar el estado actual del proyecto con manifiesto y sumas de verificación, todo ello con un énfasis en la transparencia, la confirmación explícita del usuario y la seguridad de los datos.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add zenstory-ai/drama-skills

Preguntar en tu IA favorita

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

Documentación

Enrutamiento de creación de series cortas

Este skill se encarga de la inicialización del proyecto, el enrutamiento entre fases, la forma de producción y el Dashboard. El cuerpo de cada fase lo completa el propietario correspondiente.

Inicio rápido

Todos los proyectos utilizan el flujo de trabajo creator-first: por cada episodio se mantienen según sea necesario Guion.md, ConfiguraciónVisual.md, Storyboard.md, IndicacionesDeImagen.md, IndicacionesDeVideo.md, sin establecer una verdad de creación estructurada en paralelo. La redacción concreta se encuentra en Cinco documentos de creación.

Enrutamiento

Qué quiere hacer el usuarioowner / acción
Desarrollar ideas, compromiso de serie, adaptación y mapa de episodios$short-drama-develop, solo cuando el usuario lo necesite
Tener varios episodios completos/borradores sueltos, identificar episodios$short-drama-develop establece un índice temporal según los límites reales
Analizar una obra original extensa$short-drama-novel-analyze, solo cuando el usuario lo necesite
Escribir o modificar el guion de un episodio$short-drama-write → Guion.md
Desglosar personajes, estilos, lugares, atrezo$short-drama-assets → ConfiguraciónVisual.md
Escribir indicaciones de imagen para activos$short-drama-image-prompts → IndicacionesDeImagen.md
Hacer planos y fotogramas clave congelados$short-drama-storyboard → Storyboard.md
Escribir indicaciones de vídeo/línea de tiempo/música$short-drama-video-prompts → IndicacionesDeVideo.md
Generar medios reales$short-drama-produce, primero previsualizar, luego confirmar explícitamente, y finalmente ejecutar
Revisar o verificar$short-drama-review, solo cuando el usuario lo solicite
Inicializar, Dashboard, archivar documentos solicitadosEste skill

El análisis de materiales extensos y el índice de episodios en DesarrolloDelProyecto/ son áreas de trabajo de análisis opcionales, no participan en la determinación del diseño de un episodio individual; al escribir cualquier episodio solo se mantienen los cinco documentos Markdown de creator-first de ese episodio.

Los guiones existentes se pueden desglosar directamente en activos; los hechos visuales existentes permiten escribir directamente indicaciones de imagen o storyboard; los storyboards existentes permiten escribir directamente indicaciones de vídeo. No falsificar aguas arriba para completar una línea de producción artificial.

Ejecutar solicitudes

  1. Encontrar el proyecto o material proporcionado por el usuario, leer solo la entrada directa de la tarea actual.
  2. Pasar el alcance completo solicitado por el usuario al propietario correspondiente; los lotes solo controlan el contexto, se ejecutan automáticamente de forma continua.
  3. Preguntar solo ante bifurcaciones creativas reales; no preguntar al creador sobre esquemas, directorios, transacciones o comprobadores.
  4. Al completar el alcance, informar de una sola vez: contenido completado, decisiones clave, asuntos pendientes reales y próximos pasos opcionales.
  5. No iniciar automáticamente revisiones, archivados o producción que el usuario no haya solicitado.

Inicialización y Dashboard

Cuando se necesite configuración del proyecto, ejecutar:

python3 {directorio_del_skill}/scripts/project_tool.py init ./mi-drama --title "Serie Corta de Ejemplo"

init solo crea la configuración y directorios vacíos; en la primera creación, los documentos se escriben en Episodios/<EP>/, sin precrear archivos vacíos. La ubicación del proyecto y la escritura segura se describen en Pre-ejecución. Cuando el usuario solicite explícitamente el Dashboard, ejecutar:

python3 {directorio_del_skill}/scripts/dashboard_server.py --workspace <workspace> --port 0 --detach --open

--detach hace que el proceso de servicio se ejecute de forma independiente fuera del shell actual; la sesión termina, la terminal se cierra o el agente sale sin afectarlo; el enlace permanece válido durante toda la sesión de creación. La dirección, el puerto y el PID en ejecución se registran en <workspace>/.short-drama/dashboard.json (solo legible por el usuario), los registros están en el mismo directorio dashboard.log:

python3 {directorio_del_skill}/scripts/dashboard_server.py --workspace <workspace> --status   # Imprimir enlace actual
python3 {directorio_del_skill}/scripts/dashboard_server.py --workspace <workspace> --stop     # Detener

Si ya hay un Dashboard en ejecución en el mismo workspace, al iniciarlo de nuevo solo se imprimirá el mismo enlace, sin abrir un segundo puerto; para cambiar de puerto o de token, añadir --restart. Sin --detach, el comportamiento es el mismo: ejecución en primer plano, Ctrl-C para finalizar.

El Dashboard muestra y edita archivos de creación, no se encarga de la orquestación del flujo de trabajo ni de la producción de medios.

Decisiones creativas a nivel de proyecto

Cuando la forma de producción, la dirección visual, la plataforma de visualización y la duración objetivo realmente condicionen múltiples fases, mostrar las opciones y su impacto, y dejar que el usuario decida. Look Development es una rama opcional, no un requisito fijo para entrar en indicaciones de imagen o storyboard.

Para cada pregunta, leer solo un conocimiento relevante:

Límites de producción y entrega

La producción externa siempre mantiene previsualización -> confirmación explícita -> ejecución. El archivado solo copia los documentos actuales y los resultados solicitados por el usuario, excluyendo entradas privadas, credenciales, rutas absolutas y estado de ejecución oculto; no inventar aprobaciones, hashes o un segundo conjunto de contenido para el archivado.

Cuando el usuario pregunte "¿cómo se exporta/entrega lo hecho?", usar export para empaquetar el estado actual:

python3 {directorio_del_skill}/scripts/project_tool.py export <proyecto> --out <directorio_fuera_del_proyecto>

Copia los cinco documentos de creación existentes de cada episodio y Episodios/<EP>/ResultadosDeProduccion/ en --out, junto con manifest.json y checksums.sha256, excluyendo Entradas/, Entregas/ y .short-drama/. Para solo una parte, añadir --episode EP001 (repetible); para solo texto, añadir --no-media; para sobrescribir directorio antiguo, añadir --overwrite. --out debe estar fuera del proyecto.

export es una instantánea del estado actual; en el manifest, asserts_approval siempre es false: no afirma ninguna revisión ni aceptación del creador. Para un paquete de entrega formal con evidencia de aprobación, sigue existiendo la ruta package/verify.

Instalación y mantenimiento

Ejecutar python3 scripts/selftest.py solo cuando se necesite instalar, actualizar o solucionar problemas.

Skills relacionados