CommunityImagengithub.com

galloforge/forge-historia

Convierte una premisa, canción, poema o mito en una biblia de historia, un guion cinematográfico cronometrado y una lista de planos ajustada a un presupuesto de créditos, todo escrito en YAML que las herramientas validan, presupuestan y sincronizan con música. Usa esta habilidad cuando el usuario quiera convertir una idea en un cortometraje, película pintada, videoclip o libro ilustrado; desee una premisa, logline, biblia de historia, escaleta, guion, storyboard o lista de planos; pregunte cuántos planos o cuánto dura una película que sus créditos pueden comprar; o quiera ajustar una historia existente para que funcione, incluso si nunca dice 'lista de planos'.

¿Qué es forge-historia?

FilmForge Story es una habilidad de IA diseñada para guiar la creación de una historia completa desde el concepto hasta una lista de planos validada y presupuestada, ideal para cortometrajes animados, películas pintadas, videoclips o libros ilustrados. Centrada en seis motores narrativos (relación, defecto, elección, giro, espejo e imagen doble), la habilidad produce tres archivos clave: una biblia de historia (`story-bible.md`), un guion cronometrado (`screenplay.md`) y una lista de planos en YAML (`shotlist.yaml`) que se valida con scripts como `shotlist.py validate` y `budget.py`. Funciona con herramientas de línea de comandos y presupuestos de créditos, asegurando que el ritmo, los giros y los costos se alineen. Es especialmente útil para desarrolladores y cineastas que desean un flujo de trabajo estructurado, verificable y escalable, integrado con sistemas como Claude Code o Cursor.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gallowforge/filmforge/tree/HEAD/skills/forge-story

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

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

Documentación

FilmForge Historia

La historia es lo primero: nada se pinta, se musicaliza o se compra hasta que la película existe en papel, cronometrada al segundo y presupuestada al crédito. Esta habilidad escribe tres archivos: story-bible.md, screenplay.md, shotlist.yaml (plantillas en templates/). La compuerta de etapa se supera cuando la lista de planos se valida y su plan cabe en los créditos.

Rutas: scripts/, templates/ y config/ son carpetas dentro de esta habilidad (el directorio base que se muestra al cargarla), colocadas por ./install.sh. Trabajando desde un clon del repositorio, son tools/, templates/ y config/ en su raíz.

Paso 1. Premisa y tesis

  • Premisa: una frase, quién quiere qué y qué le cuesta.
  • Tesis: una frase que el final demuestra.

Si cualquiera ocupa dos frases, la historia aún no se ha encontrado. Sigue trabajando aquí; todo lo que viene después lo hereda.

Paso 2. El corazón: seis motores

Los grandes cortometrajes animados hacen las mismas pocas cosas. Llena cada fila; una película que no pueda llenar una está perdiendo una parte.

MotorPrueba
Una relaciónDos personajes sobre los que trata la película. Todos los demás les sirven.
Un defecto, con un precioEl defecto del héroe le cuesta algo real a alguien, en pantalla.
Una elección que rompe el corazónEl héroe renuncia a lo que quería, por su propia mano.
Un giroLo que el público creía no es lo que es verdad, y la verdad fue plantada.
Un espejoUna imagen que miente al principio y dice la verdad al final.
Una imagen, dos vecesUna composición abre y cierra la película, cambiada por todo lo que hay en medio.

Ejemplo trabajado (La Polilla de la Linterna, el ejemplo de texto del repositorio, 36 s): una relación, una chica del faro y la polilla de brasa, la primera cosa cálida que ha sostenido en todo el invierno. Un defecto con un precio: quiere conservar el calor, y mientras lo acuna el bote deriva hacia las rocas. Una elección: abre las manos hacia la lámpara muerta y deja ir a la polilla hacia ella. Un giro: la polilla no se apaga; al amanecer el cristal de la lámpara está cubierto de cien pequeñas polillas de brasa. Un espejo: su reflejo en la lente de la lámpara, sola e iluminada por la polilla, luego perdida en la luz del haz. Una imagen dos veces: el faro muerto de noche abre la película, el faro cálido al amanecer la cierra.

Paso 3. Preparaciones y recompensas

Una tabla donde nada aparece solo una vez. Cada fila: lo que se planta (plano), lo que recompensa (plano). Si una imagen no tiene recompensa, córtala o dale una. Filas de La Polilla de la Linterna: la lámpara muerta en el primer fotograma / el mismo fotograma al amanecer, la lámpara caliente; la linterna vacía que lleva a todas partes / se queda atrás en el suelo una vez que la polilla se ha ido; una polilla en la punta de su dedo / cien polillas en el cristal; ningún dorado cálido en ningún lado / el haz brilla dorado.

Paso 4. La partitura de color

Una fila por escena: rango de tiempo, 3 a 5 colores, la sensación. Añade las reglas que llevan significado ("ningún dorado cálido antes de que la lámpara se encienda", "el único color cálido antes de que la lámpara se encienda es el naranja de la polilla", "no hay azul en el cielo hasta el amanecer"). Las reglas se convierten en entradas prohibición en el libro de contabilidad de continuidad, medidas en cada pintura.

Paso 5. El guion, cronometrado

  • Escenas con rangos de tiempo; planos con inicio, duración, encuadre, y solo lo que una cámara puede fotografiar, en tiempo presente. Un latido que no pueda ser fotografiado no está en la película.
  • Debajo de cada escena, lo que hace la música (instrumentos, energía, un golpe nombrado, un silencio escrito). El guion de La Polilla de la Linterna pone "un zumbido grave, un golpe suave en cada compás. Frío y sola." bajo La Oscuridad, y "el golpe a 0:24, luego acordes cálidos completos" bajo La Luz. Si la música ya existe (una canción, una pieza de piano), la historia camina a través de sus secciones en orden, una línea de estado de ánimo debajo de cada una, y los planos o páginas giran con ella.
  • Palabras: di solo lo que las imágenes no pueden (quién habla, por qué se van, quién muere, qué significa el final). Sin palabras es una fortaleza: llega a cualquier persona en cualquier lugar. La narración está escrita a mano en pantalla o dicha en voz alta; de cualquier modo, se cronometra en tiempo de película más tarde (forge-sonido).

Paso 6. Dimensionar la película a los créditos

creditos_pintura = creditos x 0.95 - hojas - placas - pruebas - partitura
pinturas         = piso(creditos_pintura / (precio x 1.3))        # 1.3 = el búfer de repintado
duracion         = pinturas x sostenido_promedio                     # sostenidos pintados: 4 a 6 s cada uno

Ejemplo trabajado: 70 créditos (66.5 utilizables), dos hojas y una placa (8.25, aproximadamente 11.8 con búferes), una partitura de 64 s (9.28): aproximadamente 45.4 restantes para pinturas, así que 12 pinturas a 2.75 con el búfer: una película de 60 s a 5 s por sostenido. La Polilla de la Linterna ejecuta 6 planos en 36 s; budget.py lo planifica en 39.08 de 66.50 utilizables, con 27.42 de sobra después de lo que ya está gastado: espacio para 7 pinturas más con retomas.

Reglas al dimensionar:

  • Fotogramas héroe primero: nombra los 2 a 4 planos que deben hacer sentir algo a la gente. Se pintan como pruebas antes de todo lo demás.
  • Movimiento real solo donde no funciona nada más (vuelo, una transformación que es el clímax). En otros lugares, poses clave que encajan (poses: 2) y vida en postproducción.
  • Reutiliza una placa o una pintura donde la historia lo permita (tipo: reutilizar): el motor de imagen doble es gratis.

Paso 7. La lista de planos

Escribe shotlist.yaml (esquema: referencias/shotlist-schema.md). Cada plano: id, escena, dur, tipo, encuadre, latido, personajes, refs (la ficha de cada personaje), corte_en, y donde el resumen de música nombra un golpe de historia, marcador. Luego:

python3 scripts/shotlist.py validate shotlist.yaml
python3 scripts/budget.py shotlist.yaml --production produccion.yaml

Itera hasta que validar no muestre errores y presupuesto diga CABE. Advertencias a las que actuar: sostenidos pintados por debajo de 1.5 s o por encima de 10 s, narración más rápida de 2.4 palabras por segundo, un personaje en cuadro sin su ficha adjunta.

Formato de salida

  1. story-bible.md: premisa, tesis, los seis motores, mundo, personajes (nombre, aspecto, deseo, movimiento), accesorios y estados, preparaciones y recompensas, partitura de color, reglas de producción.
  2. screenplay.md: escenas con tiempos, notas de música, planos con inicio, duración, encuadre, acción, palabras.
  3. shotlist.yaml: se valida, cabe.
  4. Un informe breve: duración, número de planos, créditos planificados frente a disponibles, los fotogramas héroe, el único riesgo.

Lista de verificación de compuerta

  • Premisa y tesis son una frase cada una
  • Todos los seis motores completados; cada preparación recompensada
  • Partitura de color con sus reglas
  • Cada plano fotografiáble; cada latido bajo su música
  • shotlist.py validate: sin errores
  • budget.py: CABE, reserva intacta
  • Fotogramas héroe nombrados

Tabla de reparación

SíntomaSolución
El final no funcionaFalta la elección o se toma por el héroe; o el giro no se plantó. Revisa los motores 3 y 4
Parece una presentación de diapositivasLos latidos describen estados, no acciones; reescribe cada latido como algo que cambia en el cuadro
Excede el presupuestoMenos sostenidos, más largos; reutiliza placas; poses clave en lugar de video; luego corta planos de prioridad 3
Advertencias de narraciónMenos palabras, o deja que la línea corra a través del siguiente corte (la narración vive en tiempo de película)
Los personajes no se leen como las mismas personasNo es un fallo de historia: forge-estilo-bloqueo (fichas, anclas, bloqueos de escala)

Referencias

  • referencias/motor-historia.md: los seis motores en profundidad, con La Polilla de la Linterna desglosada
  • referencias/shotlist-schema.md: cada campo de la lista de planos, sus valores y qué herramienta lo lee

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

gallowforge/forge-deliver

FilmForge deliver: encodes and checks every deliverable of a finished film or book (4K master, 1080p for posting, phone copy, cover stills, print-book PDF, making-of, localised editions) with exact ffmpeg settings, verifies streams, loudness and picture-to-music sync on the finished files, then builds the production archive with a SHA-256 completeness proof that anyone can re-verify later, and proves backup copies byte for byte. Use this skill whenever the user wants to export, encode or render final versions, post a film, make a phone copy or covers, produce a print PDF or a translated edition, back up or archive a production, or prove that an archive or copy is complete.

gallowforge/forge-director

FilmForge director: runs an AI film production end to end (story, style lock, score, paintings, frame QA, motion in code, sound, delivery, archive) through stage gates, so no credit is spent before its gate passes. Keeps the production state file (production.yaml) and the credit ledger, prices the plan against the credits, and always names the one next action. Use this skill whenever the user wants to make, plan, budget, continue or check on a short film, painted film, animated story, music...

gallowforge/forge-frame-qa

FilmForge frame QA: inspects every painting at full size against the character sheets and the continuity ledger, measures colour rules, palette and exposure with tools, scores it on a nine-criterion rubric and decides: accept, fix in code (naming the module and the exact parameters), or repaint (with the root cause and the full corrected prompt). Use this skill whenever paintings, stills, keyframes, character sheets or book pages come back from an image model, when the user asks whether...

gallowforge/forge-motion

FilmForge motion: plans each shot's life in code instead of credits (painted holds brought alive with drifting fog, ash, snow, rain, embers, glints, light sweeps, firelight flicker, heat shimmer, shake, lightning, glass cracks, transitions, golden threads, handwritten words and titles), maps every effect to the painted-film-pipeline renderer's exact parameters, applies frame-QA code fixes, exports the edit timeline and renders the preview; decides when paid video is worth its credits. Use...

gallowforge/forge-painter

FilmForge painter: writes every shot's image prompt from the shot list, the character sheets and the style lock, on a fixed twelve-slot order with continuity anchors (handles, anchors, scale locks, props, states, forbidden-colour clauses); keeps the continuity ledger; lints every prompt before a credit is spent; paints in batches of four and hands each batch to frame QA. Use this skill whenever the user wants image prompts for a film's shots or a picture book's pages, storyboard frames,...

gallowforge/forge-style-lock

FilmForge style lock: fixes one image model and setting, one look sentence (or two when the drawing itself carries the story), the palette and colour rules, the line, brush and lens language, the character-sheet specs with scale bars, and the prompt grammar every shot must follow, so every painting in a film or book matches. Use this skill whenever the user starts the visual side of a film, music video or picture book, wants consistent characters or one consistent look across many images,...

Skills relacionados