CommunityImagemgithub.com

gallowsforge/forge-story

FilmForge Story: transforma uma premissa, música, poema ou mito em uma bíblia de história, um roteiro cronometrado e um storyboard dimensionado para um orçamento de créditos, escritos em YAML que as ferramentas validam, precificam e cortam para a música. Use esta habilidade sempre que o usuário tiver uma ideia para transformar em um curta-metragem, filme pintado, videoclipe ou livro ilustrado; quiser uma premissa, logline, bíblia de história, beat sheet, roteiro, storyboard ou lista de cenas; perguntar quantas cenas ou quanto tempo de filme seus créditos compram; ou quiser uma história existente apertada para que ela funcione, mesmo que nunca diga 'lista de cenas'.

O que é forge-story?

FilmForge Story é uma habilidade especializada para agentes de IA como Claude Code, Cursor e Codex, projetada para cineastas que desejam transformar uma ideia inicial (premissa, música, poema ou mito) em um projeto de filme completo, viável e orçado. O fluxo é guiado por sete etapas: começa com a definição de uma premissa e tese de uma frase, depois preenche os "seis motores" que todo grande curta animado possui (relacionamento, falha com preço, escolha dolorosa, reviravolta, espelho e imagem dupla). Em seguida, cria tabelas de setups e payoffs, um script de cores com regras visuais, um roteiro cronometrado por música e, finalmente, dimensiona o filme para um orçamento de créditos usando fórmulas e ferramentas Python. Esta habilidade é útil porque garante que a história seja sólida e filmável antes de qualquer pintura ou animação, evitando retrabalho e desperdício de recursos. Ela suporta saídas em arquivos markdown e YAML, validados por scripts em Python, e produz três arquivos principais: bíblia, roteiro e lista de cenas. É ideal para cineastas independentes, animadores e criadores de conteúdo que precisam de um pipeline estruturado e econômico para contar histórias visuais.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

FilmForge Story

A história vem primeiro: nada é pintado, musicado ou comprado até que o filme exista no papel, cronometrado ao segundo e precificado pelo crédito. Esta habilidade escreve três arquivos: story-bible.md, screenplay.md, shotlist.yaml (modelos em templates/). O portão de etapa passa quando a lista de cenas é validada e seu plano se encaixa nos créditos.

Caminhos: scripts/, templates/ e config/ abaixo são pastas dentro desta habilidade (o diretório base exibido quando ela carrega), colocadas lá por ./install.sh. Trabalhando a partir de um clone do repositório, eles são tools/, templates/ e config/ em sua raiz.

Etapa 1. Premissa e tese

  • Premissa: uma frase, quem quer o quê e o que isso custa a eles.
  • Tese: uma frase que o final prova.

Se algum deles precisar de duas frases, a história ainda não foi encontrada. Continue trabalhando aqui; tudo a jusante herda isso.

Etapa 2. O coração: seis motores

Grandes curtas animados fazem as mesmas poucas coisas. Preencha cada linha; um filme que não consegue preencher uma está faltando uma parte.

MotorTeste
Um relacionamentoDois personagens sobre os quais o filme trata. Todos os outros os servem.
Uma falha, com um preçoA falha do herói custa algo real a alguém, na tela.
Uma escolha que parte o coraçãoO herói desiste do que queria, por sua própria mão.
Uma reviravoltaO que o público acreditava não é o que é verdade, e a verdade foi plantada.
Um espelhoUma imagem que mente cedo e diz a verdade tarde.
Uma imagem, duas vezesUma composição abre e fecha o filme, mudada por tudo entre elas.

Exemplo prático (A Mariposa Lanterna, o exemplo de texto do repositório, 36 s): um relacionamento, uma garota do farol e a mariposa de brasa, a primeira coisa quente que ela segurou em todo o inverno. Uma falha com um preço: ela quer manter o calor, e enquanto ela o cobre, o barco deriva em direção às rochas. Uma escolha: ela abre as mãos em direção à lâmpada morta e deixa a mariposa ir para dentro dela. Uma reviravolta: a mariposa não se queima; ao amanhecer, o vidro da lâmpada está coberto por cem pequenas mariposas de brasa. Um espelho: seu reflexo na lente da lâmpada, sozinha e iluminada pela mariposa, depois perdida na luz do feixe. Uma imagem duas vezes: o farol morto à noite abre o filme, o farol quente ao amanhecer o fecha.

Etapa 3. Preparações e recompensas

Uma tabela onde nada aparece apenas uma vez. Cada linha: o que é plantado (cena), o que recompensa (cena). Se uma imagem não tem recompensa, corte-a ou dê uma a ela. Linhas de A Mariposa Lanterna: a lâmpada morta no primeiro quadro / o mesmo quadro ao amanhecer, a lâmpada quente; a lanterna vazia que ela carrega para todo lado / ela fica para trás no chão assim que a mariposa se vai; uma mariposa na ponta do dedo dela / cem mariposas no vidro; nenhum dourado quente em qualquer lugar / o feixe brilha dourado.

Etapa 4. O roteiro de cores

Uma linha por cena: intervalo de tempo, 3 a 5 cores, a sensação. Adicione as regras que carregam significado ("nenhum dourado quente antes de a lâmpada ser acesa", "a única cor quente antes da lâmpada ser acesa é o laranja da mariposa", "nenhum azul no céu até o amanhecer"). Regras se tornam entradas forbid no registro de continuidade, medidas em cada pintura.

Etapa 5. O roteiro, cronometrado

  • Cenas com intervalos de tempo; cenas com início, duração, enquadramento e apenas o que uma câmera pode fotografar, no presente. Uma batida que não pode ser fotografada não está no filme.
  • Abaixo de cada cena, o que a música faz (instrumentos, energia, um hit nomeado, um silêncio escrito). O roteiro de A Mariposa Lanterna coloca "um zumbido baixo, um toque suave em cada batida. Frio e sozinho." sob O Escuro, e "o hit em 0:24, depois acordes quentes e cheios" sob A Luz. Se a música já existir (uma canção, uma peça de piano), a história caminha por suas seções em ordem, uma linha de humor sob cada uma, e as cenas ou páginas viram com ela.
  • Palavras: diga apenas o que as imagens não podem (quem está falando, por que eles vão, quem morre, o que o fim significa). Sem palavras é uma força: funciona para qualquer pessoa em qualquer lugar. A narração é escrita à mão na tela ou falada; de qualquer forma, é cronometrada mais tarde no tempo do filme (forge-sound).

Etapa 6. Dimensionar o filme para os créditos

paint_credits = créditos x 0,95 - folhas - placas - provas - partitura
pinturas      = piso(paint_credits / (preço x 1,3))        # 1,3 = o buffer de repintura
tempo_total   = pinturas x duração_média                    # takes pintados: 4 a 6 s cada

Exemplo prático: 70 créditos (66,5 gastáveis), duas folhas e uma placa (8,25, cerca de 11,8 com buffers), uma partitura de 64 s (9,28): cerca de 45,4 restantes para pinturas, então 12 pinturas a 2,75 com o buffer: um filme de 60 segundos com 5 s por take. A Mariposa Lanterna executa 6 cenas em 36 s; budget.py planeja em 39,08 de 66,50 gastáveis, com 27,42 de sobra após o que já foi gasto: espaço para mais 7 pinturas com retomadas.

Regras ao dimensionar:

  • Quadros heróis primeiro: nomeie as 2 a 4 cenas que devem fazer as pessoas sentirem algo. Elas são pintadas como provas antes de todo o resto.
  • Movimento real apenas onde nada mais funciona (voo, uma transformação que é o clímax). Em outros lugares, poses-chave que estalam (poses: 2) e vida na pós-produção.
  • Reutilize uma placa ou pintura onde a história permitir (kind: reuse): o motor de imagem-duas-vezes é gratuito.

Etapa 7. A lista de cenas

Escreva shotlist.yaml (esquema: references/shotlist-schema.md). Cada cena: id, cena, dur, kind, enquadramento, batida, personagens, refs (a ficha de cada personagem), cut_on, e onde o resumo musical nomeia um hit da história, pin. Então:

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

Itere até que validate não mostre erros e budget diga FITS. Avisos para agir: takes pintados com menos de 1,5 s ou mais de 10 s, narração mais rápida que 2,4 palavras por segundo, um personagem em quadro sem sua ficha anexada.

Formato de saída

  1. story-bible.md: premissa, tese, os seis motores, mundo, personagens (identificador, aparência, desejo, movimento), adereços e estados, preparações e recompensas, roteiro de cores, regras de produção.
  2. screenplay.md: cenas com tempos, notas musicais, cenas com início, duração, enquadramento, ação, palavras.
  3. shotlist.yaml: valida, encaixa.
  4. Um breve relatório: tempo total, contagem de cenas, créditos planejados versus disponíveis, os quadros heróis, o único risco.

Lista de verificação do portão

  • Premissa e tese são uma frase cada
  • Todos os seis motores preenchidos; toda preparação recompensada
  • Roteiro de cores com suas regras
  • Cada cena fotografável; cada batida sob sua música
  • shotlist.py validate: sem erros
  • budget.py: FITS, reserva intocada
  • Quadros heróis nomeados

Tabela de reparos

SintomaCorreção
O final não funcionaA escolha está faltando ou foi feita pelo herói; ou a reviravolta não foi plantada. Re-verifique os motores 3 e 4
Parece uma apresentação de slidesBatidas descrevem estados, não ações; reescreva cada batida como algo mudando no quadro
Acima do orçamentoMenos takes, mais longos; reutilize placas; poses-chave em vez de vídeo; depois corte cenas de prioridade 3
Avisos de narraçãoMenos palavras, ou deixe a linha correr através do próximo corte (narração vive no tempo do filme)
Personagens não são lidos como as mesmas pessoasNão é uma falha da história: forge-style-lock (fichas, âncoras, bloqueios de escala)

Referências

  • references/story-engine.md: os seis motores em profundidade, com A Mariposa Lanterna detalhada
  • references/shotlist-schema.md: cada campo da lista de cenas, seus valores e qual ferramenta o lê

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,...

Habilidades Relacionadas