CommunityProgramación y desarrollogithub.com

atakoylan125-sketch/AI-Filmmaking-Skills

Planificación de escenas con ManimGX: coloca todos los elementos de una escena y genera un mapa animado en planta. Ideal para planificar el bloqueo, posiciones de cámara, lentes, luces, y verificar el eje de 180° y la dirección de pantalla.

¿Qué es AI-Filmmaking-Skills?

Esta habilidad convierte una descripción de escena (desde una lista de planos profesional hasta una sola frase casual) en un mapa animado en planta al estilo de un director de cine, renderizado como un video MP4. Utiliza ManimGX para crear una visualización que muestra la disposición del entorno, las posiciones de los personajes, sus posturas y movimientos, las fuentes de luz y cada cámara con su cono de campo de visión. El proceso incluye una ronda de preguntas de opción múltiple cuando la descripción es vaga, para que incluso un principiante pueda definir los elementos esenciales (ubicación, posiciones, orientación, luz, entorno, planos y movimientos). Una vez que el usuario aprueba el plano propuesto, se genera el video y un archivo JSON editable con la especificación completa de la escena. Está diseñada para complementar herramientas de producción existentes, no para reemplazarlas, enfocándose exclusivamente en la planificación espacial.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atakoylan125-sketch/AI-Filmmaking-Skills/tree/HEAD/skills/staging-with-manimgx

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Planificación con ManimGX

Solo colocación. Esta habilidad no escribe historia, diálogos ni actuación, y no está vinculada a ningún sistema de cámara, generador de video o herramienta de producción. Responde una pregunta: ¿dónde está todo y todos, cómo se mueven, de dónde viene la luz, y dónde está cada cámara y hacia dónde mira? El resultado es un video corto al estilo de un plano de planta de director: el mapa terminado se muestra durante un segundo, luego el mapa se construye paso a paso, luego aparecen las trayectorias de movimiento, luego las cámaras una por una con sus conos de campo de visión, y finalmente el eje de 180° y las líneas de mirada.

La persona puede ser un profesional con una lista de planos completa o un principiante con una sola frase. Ambos deben terminar con la misma calidad de mapa. Lo que difiere es el camino: una descripción completa va directamente a un diseño propuesto; una descripción escasa pasa primero por una breve ronda de preguntas guiadas, para que la persona decida la colocación en lugar de que usted la adivine. Las preguntas también enseñan a un principiante lo que necesita una descripción de planificación. Todo camino termina con un plano que la persona aprueba o corrige antes de renderizar cualquier cosa.

El arte de la planificación — tamaños de plano, altura de cámara, sensación del lente, leyes de colocación, continuidad espacial y cómo describir cada plano — está en references/staging-craft.md. Léalo antes de elegir cámaras, escribir el plano o ejecutar la verificación final.

Trabaje solo a partir de la escena que tiene delante. Las plantillas de preguntas, la tabla de tamaños y el ejemplo de especificación a continuación muestran formas y sintaxis, no contenido: nunca transfiera sus ubicaciones, accesorios, nombres, posiciones o colores a una escena real.

La descripción completa — siete casillas

Una descripción está completa cuando responde estas siete. Verifique cada descripción entrante contra ellas antes de hacer cualquier otra cosa.

#CasillaQué definePor qué lo necesita el mapa
1Ubicacióntipo, tamaño y carácter del lugar (pequeño o grande, estrecho o amplio, estilo o época) y su geometría fija: paredes, puertas, ventanas, los objetos que importan para el bloqueoestablece la escala de todo el mapa y qué accesorios existen
2Posicionesquién está dónde, su postura (de pie, sentado, acostado, arrodillado…), quién mira a quién, qué tan separadoslos puntos, las etiquetas de postura y las flechas de dirección; el eje de 180° se dibuja a partir de aquí
3Orientaciónde qué lado de un personaje está la característica clave (ventana, puerta, pared, calle), indicada en relación con un personaje: "ventana a su derecha"sin ella, el mapa puede salir reflejado y todos los fondos son incorrectos
4Luzcada fuente que importa, dónde está físicamente, de qué lado viene, dura o suavedecide qué lado de cada rostro está iluminado y qué planos miran hacia la luz
5Entornoqué hay en los otros lados de la acciónse convierte en el fondo de cada plano inverso
6Planoscuántos, en qué orden, y el tamaño, lente y ángulo de cada uno (primer plano de A, plano medio centrado, sobre el hombro de A hacia B…)estas son las cámaras
7Movimientosquién se mueve, de dónde a dónde y cuándo (se levanta, cruza, entra, sale, gira), y qué sucede en cada planoel movimiento cambia posiciones, direcciones y a veces el eje en medio de la escena; los movimientos se dibujan como trayectorias

Una casilla se considera llena cuando la descripción la indica o la hace inequívoca ("están sentados al otro lado de una cabina" llena Posiciones). La casilla 7 solo importa cuando alguien se mueve: si cada movimiento es una línea de diálogo y nadie se mueve, no necesita pregunta.

Ronda de preguntas — cuando la descripción es escasa

  1. Evalúe la descripción contra las siete casillas, en silencio. Nunca muestre la lista de verificación a la persona.
  2. Todo lleno → omita la ronda y vaya al Flujo de trabajo. También omítala cuando la persona diga que no quiere preguntas ("sorma", "direkt yap", "simplemente hazlo"): llene los vacíos con valores predeterminados; se enumeran en el plano (paso 4 del Flujo de trabajo).
  3. Algo faltante → pregunte, en el idioma de la persona:
    • Máximo 3 preguntas por mensaje y máximo 2 mensajes. Orden: Ubicación → Posiciones → Planos primero, porque deciden la estructura del mapa; luego Orientación → Luz → Entorno; Movimientos al final.
    • Si faltan tanto Ubicación como Posiciones, pregunte solo esas dos en el primer mensaje: las opciones de todas las demás preguntas dependen de sus respuestas.
    • Cada pregunta es de opción múltiple: 2–4 opciones escritas para esta escena, construidas a partir de lo que ya dice la descripción, más una opción final "Tú decides" (en el idioma de la persona, por ejemplo, "Sen öner"). La persona siempre puede escribir su propia respuesta.
    • Marque la opción que elegiría como (recomendado) con algunas palabras de razón, para que un principiante pueda simplemente tomarla.
    • Cada pregunta lleva una línea corta sobre por qué es importante para el mapa.
    • Si su entorno tiene una herramienta de preguntas de opción múltiple estructurada, úsela; de lo contrario, escriba preguntas numeradas con opciones con letras en texto plano.
    • Nunca pregunte lo que la descripción ya responde. Nunca pregunte sobre historia, diálogos o actuación: esa no es tarea de esta habilidad.
    • Cuando la persona escribe como un profesional (lentes, tamaños de plano, "sobre el hombro de A", eje), tome cada elección indicada exactamente como se da. Pregunte solo sobre las casillas que realmente faltan, y nunca reabra una decisión que tomaron.
  4. Después de las respuestas, cualquier cosa que aún esté abierta o respondida como "Tú decides" obtiene un valor predeterminado sensato. Luego vaya al Flujo de trabajo; el plano en el paso 4 es donde la persona confirma o corrige estos valores predeterminados.

Plantillas de preguntas

Estas muestran la forma de cada pregunta. Reescriba el texto y las opciones para la escena que tiene delante; nunca las pegue textualmente.

  • Ubicación — "¿Dónde sucede esto, y cómo es el lugar?" → opciones construidas a partir de la descripción, por ejemplo, interior pequeño y estrecho · interior grande y abierto · exterior · Tú decides. Por qué: establece la escala y qué accesorios existen.
  • Posiciones — "¿Cómo están colocados?" → opciones que se ajusten al lugar y a las personas en la descripción, combinando posición y postura (ambos sentados, uno frente al otro · lado a lado · uno sentado, uno de pie · Tú decides). Por qué: el eje de 180° se dibuja entre los dos personajes principales.
  • Orientación — "¿De qué lado de está la <ventana / puerta / pared>?" → izquierda de · derecha de · detrás de · detrás de . Por qué: sin ella, el mapa puede salir reflejado y todos los fondos cambian.
  • Luz — "¿De dónde viene la luz principal?" → fuentes que existen en este lugar (del lado de la <ventana / puerta> · de luminarias superiores · de una luminaria práctica en la escena · de detrás de uno de ellos (contraluz) · Tú decides). Pregunte si es suave o dura solo si nombraron una fuente. Por qué: decide qué lado de cada rostro está iluminado.
  • Entorno — "¿Qué hay al otro lado de ellos?" → opciones que se ajusten a la ubicación. Por qué: es el fondo de cada plano inverso.
  • Planos — "¿Cómo quieres cubrirlo?" → Te daré una lista (cantidad, orden, tamaño) · cobertura clásica: un plano general, dos sobre el hombro, dos primeros planos · un plano continuo · Tú decides. Por qué: estas son las cámaras.
  • Movimientos (solo cuando el movimiento es plausible) — "¿Alguien se mueve durante la escena?" → no, todos se quedan quietos · <un movimiento que sugiere esta escena, escrito para ella> · sí (dime quién, de dónde a dónde, y cuándo) · Tú decides. Por qué: los movimientos se dibujan como trayectorias y pueden cambiar el eje.

Flujo de trabajo

  1. Lea la escena — la descripción más las respuestas de la ronda. Extraiga:

    • la ubicación, su geometría fija y los accesorios que importan para el bloqueo (paredes, puertas, ventanas, muebles, vehículos, caminos);
    • cada personaje: dónde están, postura, hacia dónde miran;
    • cada movimiento: quién, de dónde, a través de dónde, hacia dónde, la dirección y postura al final;
    • cada fuente de luz que importa (sol, ventana, lámpara, luminaria práctica): dónde está físicamente, de qué lado viene, a quién golpea;
    • la relación principal — el par que más habla o se mira. Ese par define el eje de 180°. Si un movimiento cambia la geometría, decida el eje para los planos posteriores;
    • los planos. Si la persona se los dejó a usted o eligió cobertura clásica, constrúyalos usted mismo (consulte Cobertura).

    Luego responda tres preguntas para usted mismo antes de diseñar cualquier cosa: qué cambia físicamente durante la escena (quién se mueve, qué se recoge, qué se abre); qué debe ver la audiencia al mismo tiempo (dos personas en un mismo encuadre, una cara y la puerta detrás); qué debe permanecer fijo entre planos (la ventana iluminada, la mesa, el objeto del que trata la escena). Las respuestas deciden qué accesorios reciben nombre, qué planos deben ser de dos personas y dónde debe mantenerse el eje.

  2. Diséñelo en metros con tamaños del mundo real (tabla a continuación). Convención del mapa: +y es "hacia la escena" visto desde la cámara principal/de apertura, +x es hacia la derecha. Coloque la cámara principal al sur de la acción mirando hacia el norte.

  3. Escriba la especificación de la escena (JSON, esquema a continuación; el esquema JSON completo está en references/scene.schema.json) en el directorio de trabajo, luego valídelo sin renderizar: uv run <directorio-habilidad>/scripts/staging_render.py scene.json --check (<directorio-habilidad> es la carpeta que contiene este SKILL.md). Imprime el informe resuelto (posiciones de cámara, advertencias) o una sola línea spec error: …; corrija y vuelva a verificar hasta que pase.

  4. Vista previa y aprobación — antes de cualquier renderizado. Ejecute uv run <directorio-habilidad>/scripts/staging_render.py scene.json -o <nombre>.mp4 --preview (unos segundos). Escribe <nombre>.preview.png, el mapa terminado, y <nombre>.report.json. Mire usted mismo la vista previa primero y corrija problemas obvios (si no puede ver imágenes, revise el informe en su lugar y dígale a la persona que no pudo inspeccionar la imagen). Luego muestre a la persona la imagen de vista previa y un plano compacto en su idioma:

    • Entorno — tamaño del espacio, los objetos clave y dónde están (palabras relativas más metros);
    • Personajes — posición, postura, dirección; luego cada movimiento en orden;
    • Luz — cada fuente, dónde está, qué lado de quién ilumina;
    • Cámaras — una tabla: número, tamaño, lente, dónde está (por ejemplo, "2.9 m delante-derecha de A, altura de los ojos"), qué ve, y una línea sobre por qué esta cámara (su función en la cobertura);
    • Descripciones de plano — para cada cámara, una breve descripción en lenguaje sencillo del encuadre, construida a partir de la especificación y los datos de frame del informe con la plantilla en references/staging-craft.md: quién y qué está en el encuadre y de qué lado, qué está detrás de ellos, de qué lado viene la luz, dirección de la línea de mirada y lado del eje. Neutral y factual: sin palabras de estilo o estado de ánimo, sin redacción para ninguna herramienta de imagen o video en particular;
    • Eje de 180° — qué par, de qué lado están las cámaras, cualquier plano que esté reflejado o cruce;
    • Suposiciones — cada valor que usted eligió en lugar de la persona, marcado como tal;
    • Alternativas — dos o tres opciones de cámara que la persona no mencionó, una línea cada una con su compensación (consulte "Ofrecer alternativas" en references/staging-craft.md). Aplique una solo si la persona la elige. Pídales que aprueben o corrijan cualquier cosa ("pon la puerta en la otra pared", "haz que el plano 3 sea un primer plano", "ella se queda sentada"). Aplique las correcciones a la especificación, vuele a previsualizar y muestre el plano cambiado; repita hasta que aprueben. Renderice solo después de la aprobación. Omita este paso solo si la persona pidió explícitamente renderizar sin revisión; luego enumere las suposiciones al entregar.
  5. Renderice con el motor incluido, scripts/staging_render.py (ruta relativa a la carpeta de esta habilidad; no lo reescriba ni copie): uv run <directorio-habilidad>/scripts/staging_render.py scene.json -o <nombre>.mp4 --quality h. Use --quality l para un borrador rápido. El video comienza con el mapa terminado durante 1 segundo (--poster 1.0, el valor predeterminado), luego se desvanece en la construcción paso a paso. Ese primer fotograma también es la miniatura en plataformas sociales, por lo que debe mostrar todo el resultado; use --poster 0 solo si la persona pide una construcción simple. Imprime un informe JSON con cada personaje, luz y cámara (posición, distancia, campo de visión horizontal, y un bloque frame que enumera quién y qué está a la vista y de qué lado del encuadre y de qué lado del encuadre viene cada luz) y warnings (también guardado como <nombre>.report.json), y guarda <nombre>.last.png, el mapa terminado.

  6. Verifique el resultado antes de entregarlo. Abra <nombre>.last.png y mírelo (si no puede ver imágenes, confíe en el informe y dígalo): cada etiqueta legible, ningún ícono de cámara sobre una persona, conos apuntando al sujeto correcto, trayectorias de movimiento legibles, leyenda no cortada. Luego ejecute la verificación espacial final en references/staging-craft.md: izquierda/derecha y líneas de mirada consistentes entre planos, cada entrada y salida posible, objetos fijos y la luz clave en el mismo lugar físico en cada plano, sin cruce de eje no marcado. Lea warnings — un plano reflejado automáticamente o una cámara que cruza el eje debe mencionarse a la persona. Corrija la especificación y vuelva a renderizar (máximo dos rondas).

  7. Entregue el video más el JSON de especificación (para que el diseño pueda editarse cambiando números) y las descripciones de plano aprobadas, actualizadas a la especificación final. En el idioma de la persona, diga en dos o tres líneas qué valores predeterminados permanecen (solo lo que la ronda dejó abierto o la persona devolvió), y cualquier advertencia de eje. Las etiquetas del mapa están en inglés a menos que la persona pida lo contrario.

Cobertura (cuando los planos se dejan a su criterio)

Construya el conjunto más pequeño que cubra la escena, en orden de guión de rodaje, máximo 8:

  1. Plano general de establecimiento — todos en el encuadre (target: lista de todos los nombres, size: "wide", lens: 35, from: "S").
  2. Para el par principal A/B: un sobre el hombro para cada uno (over_shoulder: B, target: A y el inverso). Elija los hombros para que ambas cámaras estén en el mismo lado del eje; el motor refleja cualquier que no lo haga y lo reporta.
  3. Individuales para los movimientos clave: size: "cu" o "mcu", lens: 85/50, from: "front-left"/"front-right" (relativo a la dirección del personaje), mismo lado del eje.
  4. Insertos para cualquier accesorio del que dependa la acción (size: "insert", lens: 85, height: "high" para cosas sobre una mesa).
  5. Después de un movimiento: cubra la posición final (target: "A@1"), y dé a los planos posteriores al movimiento su propio eje ("axi...

Skills relacionados