CommunityBildgithub.com

gallowforge/forge-frame-qa

FilmForge Bild-Qualitätsprüfung: Überprüft jedes Gemälde in voller Größe anhand der Charakterblätter und des Kontinuitätsprotokolls, misst Farbregeln, Palette und Belichtung mit Werkzeugen, bewertet es nach einem Neun-Kriterien-Raster und entscheidet: Akzeptieren, per Code korrigieren (mit Angabe des Moduls und der genauen Parameter) oder neu malen (mit der Ursache und dem vollständigen korrigierten Prompt). Verwende diese Fähigkeit, wenn Gemälde, Standbilder, Keyframes, Charakterblätter oder Buchseiten von einem Bildmodell zurückkommen, wenn der Benutzer fragt, ob...

Was ist forge-frame-qa?

Diese Fähigkeit implementiert eine automatisierte Qualitätskontrolle (QA) für Filmproduktionen, bei der KI-generierte Gemälde Frame für Frame überprüft werden. Sie stellt sicher, dass nur fehlerfreie Bilder in den finalen Film gelangen, und zwar durch eine strenge, systematische Prüfung anhand von neun Kriterien (Identität, Anatomie, Maßstab, Stil, Farbe, Kontinuität, Story, Komposition und Sauberkeit). Basierend auf der Bewertung wird automatisch ein Urteil gefällt: Akzeptieren (kostenlos), Korrektur per Code (kostenlos, mit genauen Modul- und Parameterangaben) oder Neuanfertigung (kostet Credits, mit vollständigem korrigiertem Prompt). Die Fähigkeit stellt die notwendigen Werkzeuge und Skripte bereit, z. B. zur Erstellung von Kontaktabzügen und Messung von Farbpaletten, Belichtung und Maßstäben. Die Ergebnisse werden in einer strukturierten QA-Datei (qa.yaml) festgehalten, die als Grundlage für weitere Bearbeitungsschritte dient. Geeignet für Plattformen wie Claude Code, Cursor, Codex, die Bildgenerierung und -prüfung in KI-gestützten Film-Workflows unterstützen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gallowforge/filmforge/tree/HEAD/skills/forge-frame-qa

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

FilmForge Frame QA

Nichts kommt in den Film als Miniaturansicht. Jedes Gemälde wird in voller Größe gegen seine Blätter gelesen, mit den Werkzeugen gemessen, bewertet und erhält eines von drei Urteilen. Das Urteil sagt immer, was als Nächstes passiert und was es kostet: Akzeptieren (kostenlos), Korrektur per Code (kostenlos, mit dem genauen Aufruf) oder Neu malen (2,75 Credits, mit dem korrigierten Prompt).

Pfade: scripts/, templates/ und config/ unten sind Ordner innerhalb dieser Fähigkeit (das Basisverzeichnis, das angezeigt wird, wenn sie geladen wird), die von ./install.sh dort abgelegt wurden. Bei Arbeiten aus einem Klon des Repositorys befinden sie sich als tools/, templates/ und config/ in dessen Stammverzeichnis.

Das Verfahren

  1. Kontaktabzug der Charge, um sie als Sequenz zu sehen (passen benachbarte Einstellungen zusammen?): python3 scripts/contact_sheet.py build art/film --shotlist shotlist.yaml --out out/contact_sheet.jpg
  2. Vollansicht jedes Gemäldes (lies das Bild selbst, nicht das Blatt).
  3. 100 %-Ausschnitte von dem, was wichtig ist: Gesichter, Hände, das maßstabsrelevante Motiv, alles Kleine. python3 scripts/contact_sheet.py zoom art/film/s03_x.png --out-dir out/zoom --grid 2x2 oder --box x0,y0,x1,y1. Ein Bildleser verkleinert große Bilder; Ausschnitte zeigen die echten Pixel.
  4. Messen von Farbregeln, Palette und Belichtung: python3 scripts/ledger.py palette continuity.yaml --paintings art/film --shotlist shotlist.yaml Es meldet für jedes Gemälde seine Palette, seinen Abstand (delta E) vom Farbskript der Szene, den Anteil jedes verbotenen Farbe an der Bildebene sowie Belichtungssprünge in Blendenstufen zwischen benachbarten Einstellungen einer Szene.
  5. Bewerten des Rasters (unten): neun Kriterien, 0 bis 2.
  6. Entscheiden des Urteils nach den untenstehenden Regeln.
  7. Schreiben des Eintrags in qa.yaml (Format unten), dann Neuerstellung des Kontaktabzugs mit --qa qa.yaml für Abzeichen.
  8. Bericht: die Urteile zählen, jede Korrektur und jedes Neumalen in einer Zeile, Credits, die ein Neumalen kosten würde.

Das Raster (templates/qa-rubric.md enthält die Bewertungsanker)

KriteriumWas du prüfst
identityGesichter und Kostümmerkmale anhand der Blätter
anatomyHände, Augen, Gliedmaßen des Fokussubjekts
scalejede Maßstabsfestlegung und jede Anzahl (Pixel in den Ausschnitten messen)
styledie Look-Festlegung: Medium, Linie, Farbe, Textur
colourdas Farbskript und die Verbotsregeln (von ledger.py palette) und Belichtung im Vergleich zu benachbarten Einstellungen
continuityjedes Requisit und jeden Zustand, den das Protokoll für diese Einstellung auflistet, und nichts außerhalb seines Bereichs
storyder Beat liest sich in zwei Sekunden
compositionBildausschnitt wie aufgeführt, das Auge landet auf dem Motiv, der Textbereich ruhig
cleankeine gemalten Texte, Wasserzeichen, Verschmierungen oder fremde Figuren

Maßstab messen: in einem Ausschnitt das Motiv und seine Referenz in Pixeln messen und das Verhältnis mit der Maßstabsfestlegung vergleichen. Das Beispiel der Engine: die Motte erstreckt sich über 20 px auf einem 60 px langen Finger, wo ihre Festlegung eine ganze offene Hand sagt (120 px oder mehr bei diesem Bildausschnitt): ein Sechstel ihrer Größe, Maßstab 0, neu malen.

Die Urteilsregeln

  • accept: kein Kriterium bei 0, insgesamt 15 von 18 oder mehr, keine gemessene Verletzung.
  • fix: jeder Fehler hat eine Code-Korrektur (Tabelle unten) und nichts bei 0 bei Identität, Maßstab oder Story.
  • repaint: Identität, Maßstab oder Story bei 0; Anatomie bei 0 beim Fokussubjekt; Stil bei 0; oder drei oder mehr Fehler.

Korrektur per Code vor Credits (painted-film-pipeline Module)

FehlerModul und Aufruf
Ein Objekt in einer falschen Farbe (ein Schal, der eine Nebenfigur wie den Helden lesen lässt)grade.py IN OUT recolor:x0:y0:x1:y1:lo:hi:new_hue:sat
Eine verbotene Farbe, die durchschimmert (Blau vor dem Ende)grade.py IN OUT blue:0.3 (zieht das Band in Richtung Silber; keep=0.3) oder recolor zu einem erlaubten Farbton
Eine fremde Figur in einem sauberen BereichEin Patch aus einer verschobenen sauberen Region (das fix_s22.py-Muster)
Schlechter Bildausschnitt, Tangente, falscher KopfraumDer crop: [x0, y0, x1, y1] der Einstellung in Quellpixeln
Belichtung oder Kontrast weicht von benachbarten Einstellungen abAutomatisch: die angepasste Gradation ordnet die 0,5- und 99,5-Perzentil-Luminanz jedes Bildes gemeinsamen Zielen zu
Weiche DetailsAutomatisch: Lanczos 4K-Hochskalierung mit Schärfung nur auf Kanten
Ein lebloser FrameBewegung per Code (forge-motion), niemals neu malen

Jede Korrektur schreibt eine neue Datei (_g), wird erneut gemessen und erhält done: true erst, wenn die Messung bestanden wird. Details und Parameterbedeutungen: references/code-fixes.md.

Neu malen: Diagnose, dann korrigieren

Gib die Ursache als Prompt-Platzhalter oder Referenz an: „Maßstabsfestlegung fehlt in Slot 4

Individual skills in this repo

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

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

Verwandte Skills