Communitygithub.com

control-calidad

Filtro automatizado que mide duración, fps, escala, zonas seguras, negros, congelados, volumen, picos, siseo y alfa real en renders; compara con versiones anteriores y permite la firma de un supervisor.

Was ist control-calidad?

Die Skill `control-calidad` ist ein automatisierter Qualitätssicherungsfilter für Render-Ausgaben, der sicherstellt, dass alle messbaren Fehler vor der Freigabe erkannt werden. Sie unterstützt Plattformen wie Claude Code, Cursor oder Codex und wird durch einen Supervisor ergänzt, der die nicht messbaren Aspekte prüft und mit Veto-Recht „freigegeben“ oder „Änderungen“ zeichnet. Die Skill misst unter anderem Bildrate, Dauer, schwarze Bildbereiche, eingefrorene Frames, Lautstärke (LUFS), Spitzenpegel, Rauschen und echten Alpha-Kanal. Zusätzlich wird das Timing mit einem Referenzwerkzeug (`referencia.py`) überprüft und jede Korrektur mit der vorherigen Version verglichen, um Regressionen zu vermeiden. Der Arbeitsablauf umfasst das Messen nach einem festgelegten Katalog von Schwellenwerten, das Erstellen eines Kontrollbogens mit 6–24 Frames, die Prüfung des Timings und die Endabnahme durch den Supervisor. Fehler werden kategorisiert in blockierend (✘) und Warnung (⚠). Die Skill enthält detaillierte Regeln zur Vergleichsprüfung, zur Protokollierung von Korrekturen und zur Vermeidung von technischen Fallstricken bei der Verwendung von ffmpeg. Sie ist besonders nützlich für Teams, die regelmäßig Renderings erstellen und sicherstellen müssen, dass Änderungen keine zuvor freigegebenen Teile beschädigen. Die Skill reduziert manuelle Prüfungen und beschleunigt den Review-Prozess durch klare Metriken und automatisierte Checks.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/robinfernandez2016-create/claqueta/tree/HEAD/skills/control-calidad

In Ihrer bevorzugten KI fragen

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

Dokumentation

Qualitätskontrolle

Die Person soll die Arbeit sehen, nicht die handwerklichen Fehler. Alles, was messbar ist, wird gemessen, bevor es gezeigt wird. Was nicht messbar ist, prüft ein Supervisor mit frischen Augen und mit Vetorecht. Und jede Korrektur der Person wird notiert, damit sie beim nächsten Mal automatisch erkannt wird.

  • Das automatische Kontrollwerkzeug ist ein Modul in Vorbereitung. In der Zwischenzeit stammt jede Messung von ffmpeg und ffprobe: Die Befehle stehen in referenzen/mediciones.md.
  • Die Liste der bereits aufgetretenen Fehler mit ihren Schwellwerten und Prüfmethoden befindet sich in referenzen/lista-de-errores.md.
  • Der supervisor-Agent des Pakets folgt dieser Skill.

1 · Der Ablauf

  1. Vor dem Rendern die Projektdaten (pieza.md) lesen: das bereits Freigegebene, das nicht verändert werden darf, und die offenen Notizen.
  2. Den Render messen (§ 2). ✘ werden korrigiert, bevor es weitergeht; ⚠ werden durch Betrachten des Einzelbildes entschieden.
  3. Das Timing messen mit referencia.py (§ 3).
  4. Das Kontrollblatt erstellen: 6 bis 24 Einzelbilder, verteilt über das gesamte Stück, mit eingezeichneten Sicherheitszonen. Jedes davon prüfen.
  5. Wenn es sich um eine Korrektur handelt, mit der vorherigen Version vergleichen (§ 4).
  6. Der Supervisor zeichnet „freigegeben“ oder „Änderungen“ (§ 5).
  7. Der Person denselben Render zeigen und was der Supervisor gesagt hat, bevor etwas neu gemacht wird.
  8. Ausliefern mit Bericht (§ 9).

2 · Was gemessen wird

MaßSchwellwertBei Nichteinhaltung
FormatBestellt: 1080×1920 vertikal, 1920×1080 horizontal, 1080×1350 Feed. 4K nur auf Anfrage✘
Bilder pro SekundeDie der Sequenz (±0,02) und konstant✘ · ⚠ wenn variabel
DauerReel: max. 40 s. Exportiert: der Bereich zwischen Marken ±1 Bild⚠ · blockierend bei Kampagnen-Reel
SkalierungKein schwarzer Balken an einem Rand für 0,5 s oder länger✘
Sicherheitszonen (1080×1920)54 px an den Seiten; nichts Lesbares über y 224 und unter y 1495; Buttonspalte frei (ab x 897 und y 1228). Horizontal: 96 px rundherum✘ wenn 0,35 s oder länger · ⚠ wenn ein Augenblick
Ganze ObjekteIm Alpha berührt nichts den Bildrand für 0,35 s oder länger✘
SchwarzDas erste Bild zeigt Inhalt. Kein einzelnes schwarzes Bild (1 Frame) außer einem gezielten Aufblenden✘ am Anfang · ⚠ in der Mitte
EingefrorenNichts steht still 0,5 s oder länger, wo Bewegung sein sollte⚠ · ✘ bei B-Roll oder Animation, wenn es 1 s oder länger dauert oder in die letzte Sekunde fällt
Es passiert etwasKein Fenster von 4 s ohne Schnitt oder Bewegung⚠
Letztes BildExistiert, ist nicht schwarz, alles innerhalb der Ränder. Gezählte Bilder = erwartete; Audio nicht länger als Video✘
LautstärkeReel um −15 LUFS integriert (zwischen −17 und −13)✘
SpitzenEchter Spitzenpegel ≤ −1 dBTP; keine Abtastung bei −0,1 dBFS oder mehr (Übersteuerung)✘
StilleStartet nicht mit mehr als 0,3 s Stille; keine Lücke von 0,5 s unter −50 dB bei vorhandener Sprache⚠
SoundeffekteSolo: Spitze ≈ −5,5 dB (Deckel −5). Unter Sprache: Spitze ≤ −9 dB und RMS ≤ −27 dB✘
Zischen („chhh“)Kein breitbandiges Rauschen: 150 ms bei einem Effekt, 300 ms im Mix. Bei einem Effekt höchstens 20 % der Energie über 4 kHz✘ beim Effekt · ⚠ im Mix
Echtes AlphaPixelformat mit Alpha (yuva…, rgba…) und etwas Sichtbares✘
FarbeGekennzeichnet als bt709 und im TV-Bereich. HLG oder bt2020 bei Auslieferung✘
ExportH.264 und AAC 48 kHz Stereo; Datenrate 30 Mbps oder mehr (bei Ziel 52 ergibt sich ein Durchschnitt von 38–43)⚠

3 · Das Timing, mit referencia.py

Das Werkzeug, das eine Referenz zerlegt, misst auch Ihren eigenen Render. Es befindet sich in herramientas/referencia.py im Stammverzeichnis des Pakets (zwei Ordner über dieser Skill):

python3 herramientas/referencia.py <render> --idioma es --salida control/<stueck>-vN-ritmo

Lies analisis.md und schaue dir hoja.jpg und gancho.jpg an:

Im BerichtSollte ergeben
„etwas passiert alle“4 s oder weniger
„der ruhigste Abschnitt dauert“Weniger als 4 s. Falls nicht, nenne den Abschnitt und was dort eingefügt wird
„Die längste Einstellung dauert“3 bis 4 s. Länger nur, wenn es nicht anders erzählbar ist und du begründen kannst, warum
Dauer (im „Steckbrief“)Maximal 40 s bei einem Reel
gancho.jpg (0,1 bis 3 s)Würdest du den Finger anhalten? Vor 0,5 s passiert etwas Unerwartetes und nach 3 s versteht man die Geschichte
„Integrierte Lautstärke“Gleich wie in § 2 gemessen
  • Dass sich Botschaften innerhalb einer Einstellung ändern oder die Kamera sich langsam bewegt, zählt nicht als neue Einstellung. Ein Schnitt zu einem anderen Maßstab, einem anderen Winkel oder einer anderen Idee schon.
  • Bei einer Animation ohne Schnitte ist „1 Einstellung“ kein Fehler: Ihr Timing liegt in „visuellen Änderungen“.
  • Wenn das Stück aus einer Referenz entstanden ist, vergleiche ihre Zahlen mit denjenigen des freigegebenen Konzepts.

4 · Mit der vorherigen Version vergleichen

Eine Korrektur darf die Version, die bereits gefiel, nicht verschlechtern.

  1. Vor der Korrektur in pieza.md das bereits Freigegebene lesen, das nicht angetastet werden darf.
  2. Danach die neue Version mit der vorherigen vergleichen, Bild und Ton (Befehle in mediciones.md):
    • außerhalb der angeforderten Abschnitte (mit 0,25 s Toleranz) muss es gleich sein;
    • innerhalb muss es sich ändern: wenn nichts geändert wurde, ist die Notiz nicht erledigt;
    • wenn sich die Dauer geändert hat, kann alles danach verschoben sein.
  3. Was sich außerhalb des Gewünschten geändert hat, ist entweder beabsichtigt und wird in der Auslieferung erklärt, oder es ist eine Regression und wird behoben, bevor es gezeigt wird.
  4. Jede Notiz wird in ihrem Bild der neuen Version geprüft und so erledigt, wie sie gefordert wurde, ohne Interpretation.

Der Vollbildvergleich erkennt kleine Änderungen nicht (ein Schild, das 5 % des Bildes einnimmt, eine 110 px große Abdeckung, ein korrigierter Untertitel): Betrachte diese Stellen in Ausschnitten in Originalgröße beider Versionen. Was eine Korrektur typischerweise zerstört, steht in der Fehlerliste, § „Regressionen“.

5 · Der Supervisor

Der Supervisor weiß dasselbe wie derjenige, der das Stück gemacht hat, betrachtet es aber mit frischen Augen: Derjenige, der es gemacht hat, sieht seine eigenen Fehler nicht. Er repariert nichts: Er schaut, misst und zeichnet.

Er erhält den Render, seinen Typ (Reel, B-Roll, Alpha, Effekt, Cover …), die fps der Sequenz und pieza.md. Handelt es sich um eine Korrektur, zusätzlich die vorherige Version, die angeforderten Abschnitte und die Notizen mit ihrer genauen Sekunde. Fehlt etwas, sucht er es, bevor er zeichnet.

Wie er prüft:

  1. Er identifiziert das Stück anhand dessen, was es sagt, zeigt und wie lange es dauert, nicht anhand des Dateinamens.
  2. Er liest pieza.md, die Korrekturendatei (§ 6) und die Fehlerliste.
  3. Er misst (§ 2). Bei einem ✘ lautet sein Urteil „Änderungen“, ohne weitere Diskussion.
  4. Seine erste Frage ist, ob das Stück fesselt, bevor es die Einhaltung der Regeln (§ 3) prüft.
  5. Er betrachtet das Blatt und extrahiert in voller Größe die fragwürdigen Sekunden, jeden Schnitt und die Sekunde jeder erledigten Notiz.
  6. Handelt es sich um eine Korrektur, vergleicht er (§ 4).
  7. Er überprüft Daten und Texte: Keine Ziffer, kein Name und kein Fall, der erfunden ist.

Schweregrad:

  • Blockierend: ein ✘; ein privates Datum, das bei normaler Geschwindigkeit lesbar ist; ein Fehler, den die Person bereits früher korrigiert hat; ein Reel von mehr als 40 s; ein Hook, der den Finger nicht anhalten würde; eine Einstellung von mehr als 3–4 s ohne Grund.
  • Warnung: alles andere, einschließlich Ermessensfragen (ein 1-Bild-Blitz, der nur im Standbild lesbar ist, eine größere Abdeckung). Diese entscheidet die Person.

Durchläufe:

  • Erste Überprüfung: Sagt ALLES, was er sieht, auf einmal, mit seinem Schweregrad.
  • Zweite: Sieht nur seine blockierenden Punkte und den Vergleich mit der vorherigen Version. Ein neuer Punkt, der bereits in der vorherigen Version vorhanden war, ist ein Fehler von ihm beim ersten Mal: geht als Warnung.
  • Dritte: Zeichnet „freigegeben“ mit Warnungen, wenn kein blockierender Punkt mehr übrig ist.
  • Er erhöht nie die Messlatte zwischen den Versionen. Eine erneute Überprüfung dauert weniger als 5 Minuten.

Er zeichnet gegen die aktuelle Liste. Wenn das Stück älter ist als eine Regel, zählt der Fehler trotzdem, gekennzeichnet als „nach dem Rendern“. Bevor er einen schwarzen Bereich oder ein eingefrorenes Bild als Fehler meldet, prüft er, ob es sich um einen absichtlichen Aufblender von Schwarz handelt.

URTEIL: FREIGEGEBEN | ÄNDERUNGEN
Änderungen: 1) 0:04,2 · was falsch ist · Regel (ID) · blockierend | Warnung; 2) …
Geprüft: Maße, Timing, Blatt (n Bilder), Bilder in voller Größe in …, Vergleich mit vN, erledigte Notizen …

Die Unterschrift gilt für diesen Render: Wenn die Datei sich ändert, wird sie gemessen und erneut gezeichnet.

6 · Die Korrekturendatei

correcciones.md, im Arbeitsverzeichnis. Der Supervisor liest sie vor jeder Überprüfung: So ist seine Messlatte die der Person.

  • Während die Person prüft, notiert sie jede Korrektur sofort: Zeit · was sich ändert · warum · was bleibt. Zuerst lesen, was bleibt.
  • Am selben Tag wird jede Korrektur, die ein wiederholbarer Fehler ist, in eine Regel umgewandelt, mit ihrer Nummer und wie sie verifiziert wird: COR-12 · YYYY-MM-DD · Eine Einstellung dauert maximal 4 s · messen: „Die längste Einstellung“ von referencia.py · Ursprung: „Mir kommt es viel vor, dass ein Clip 8 s dauert“, Reel X v3
  • Wenn es eine frühere Regel widerspricht, gilt die neue: Korrigiere die alte, lass nicht beide stehen.
  • Notiere auch, was beim ersten Mal freigegeben wurde und was man sehen oder stehen lassen kann: das wird ebenfalls nicht verboten.
  • Wenn die Person etwas entdeckt, das der Supervisor nicht gesehen hat, schlägt der Supervisor vor, es hinzuzufügen.
  • Der Supervisor erfindet keine Geschmacksfragen. Wenn etwas eindeutig falsch ist und nicht in der Liste steht, verlangt er die Änderung und sagt warum: So wächst die Liste.

7 · Was nicht kaputtgeht

  • ✘ werden korrigiert, nicht diskutiert. Ein gemessener Fehler, der zur Person gelangt, bringt sie dazu, ihre Überprüfung mit handwerklichen Fehlern zu verbringen.
  • Gut zu messen heißt nicht freizugeben. Eine nur mit Warnungen freigegebene Version kam zurück wegen „zu lang“ (52 s) und „langweilig“ (31 s durchgehend dasselbe Handy).
  • Eine Korrektur berührt nur das Angeforderte. Nochmal von vorne anfangen ließ Handarbeit verlorengehen und verschlechterte das, was gefiel.
  • Wenn eine Eigenschaft geändert werden soll, wird nur diese geändert. „Senke die Deckkraft des Schwarzen“ wurde gelesen als „entferne die Spalte“, und das war es nicht.
  • Was die Person freigegeben oder ausgewählt hat, wird nicht wegen eines Details des Supervisors neu gemacht: Man fragt sie in einer Zeile. Drei Vetos gegen etwas, das sie bereits überzeugte, kosteten Geld und Zeit.
  • Wenn die Person am Computer ist, prüft sie selbst. Der Agent tritt ein, wenn sie nicht da ist.
  • Die Person sieht dasselbe wie der Supervisor und seine Meinung, bevor sie neu macht: was er ablehnt, in welcher Sekunde und was er vorschlägt. Es kann sein, dass ihr das Veto egal ist, und jeder Durchlauf kostet einen Render. Was sie bereits angefordert hat, wird ohne Nachfrage gemacht.
  • Maximal 2 oder 3 Versionen pro Stück. Beim zweiten Veto derselben Art oder bei einer Ermessensfrage wird angehalten und sie mit Optionen gefragt. Es gab 8 Versionen in einer Nacht mit einem Supervisor, der die Messlatte anlegte.
  • Jede Version erstellt nur die Teile neu, die sich ändern. Ein 45-minütiges Video wurde einmal komplett neu gerendert wegen einer lokalen Änderung.
  • Eine erneute Überprüfung betrachtet nur das Abgelehnte. Eine vollständige Runde dauerte 12 bis 17 Minuten und verbrauchte 300.000 bis 400.000 Tokens.
  • „Mach diese letzte Änderung und fertig“ = das wird behoben, gemessen, gezeigt und fertig. Ohne eine weitere Runde Veto.
  • Ein beiläufiger Kommentar ist kein Befehl. Wegen eines „gefällt mir nicht so sehr“ wurde eine freigegebene Person geändert und der Render abgelehnt: Das Angeforderte wird behoben, der Rest bleibt; höchstens einmal anbieten. Wenn die Person ein Thema abschließt, wird es nicht wieder aufgemacht.
  • Generiertes wird ausgehend vom Freigegebenen neu gemacht. Man geht von dem Bild aus, das gefiel, und ändert nur das Angeforderte. Nach zwei aufeinanderfolgenden Ablehnungen ohne Richtung wird kein drittes Mal blind ausgegeben: Man sagt, was verstanden wurde, und bittet um ein Bild oder einen Satz. Wenn sie ihre Meinung ändert, gilt das zuletzt Gesagte.
  • Wenn du sagst, dass etwas offen oder auf dem Bildschirm ist, überprüfe es. Es wurden vier offene Skizzen angekündigt, die nicht da waren.

8 · Technische Fallstricke

  • nb_frames lügt bei ProRes: Es zählt Pakete (-count_packets).
  • Das Anhängen des Tons mit -shortest frisst 1 bis 4 Bilder: Verwende die exakte Dauer (-t).
  • Das Label „4444“ garantiert kein Alpha: Das Pixelformat muss mit yuva beginnen.
  • ffmpeg -ss t liefert das erste Bild, das in t beginnt: Verwende für Bild f t = (f − 0,25) / fps.
  • QuickTime und die Schnellvorschau bleichen die Farbe aus: Vergleiche mit dem Bild aus dem Editor, nicht mit bloßem Auge.
  • Die Sicherheitszonen werden im Textbereich gemessen: Helles Filmmaterial verfälscht die Messung des Vollbildes.
  • Die Transkription klebt das erste Wort bei 0,0 an und fügt lange Pausen innerhalb des folgenden Wortes ein: Was direkt nach einer Pause kommt, wird per Energie gemessen.
  • Der Editor speichert Dauer und Ton einer überschriebenen Datei im Cache: Jede Version mit neuem Namen.
  • Das Lesen von Text mit 4 Bildern pro Sekunde überspringt Blitze: Für Privatsphäre 10.

9 · Was ausgeliefert und was überprüft wird

  • Der Auslieferungsbericht: Pfad, Dauer, Abschnitt, tatsächliche mittlere Datenrate, was gemessen wurde (mit den Zahlen), das Timing, das Urteil des Supervisors, der Vergleich mit der vorherigen Version und was noch offen ist.
  • In pieza.md Abschnitt „Kontrolle“: vN · Maße (Fehler und Warnungen) · Supervisor (Urteil und warum).
  • Jede Version mit neuem Namen (v2, v3…): Die vorherige bleibt intakt, um sie vergleichen zu können.
  • Nichts wird veröffentlicht oder an jemanden gesendet, ohne dass die Person es fordert.

Individual skills in this repo

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

robinfernandez2016-create/color

Corrige e iguala el color de material real antes de montarlo o entregarlo. Detecta midiendo si un clip es S-Log3 o HLG de celular y lo pasa a Rec.709 (SDR), coloriza cada clip de apoyo antes de usarlo, iguala tomas con una LUT por toma, separa persona y fondo en dos capas, etalona en Premiere con Lumetri por script y revela fotos RAW. Úsalo cuando alguien diga «igualar el color», «corrige el color», «coloriza estos clips», «que todas las tomas se vean iguales», «se ve lavado», «se ve oscuro / amarillo / verdoso», «está muy frío», «la piel sale rara», «el celular sale naranja», «esto está en log», «en QuickTime se ve distinto», «revela estas fotos» o «la foto sale tumbada».

robinfernandez2016-create/generacion-ia

Genera imágenes, vídeo y voz con IA (Higgsfield, Kling, Seedance, GPT Image, HeyGen, ElevenLabs y otros) sin desperdiciar créditos y sin que el resultado mienta. Elige el modelo según lo que haya en el plano, mantiene el mismo personaje dentro de la pieza, hace presentadores con voz clonada y lip-sync, compone croma sobre foto, protege el producto real del cliente (que se reproduce, no se recrea) y corrige editando lo aprobado en vez de regenerar. Siempre pasa antes por la skill `presupuesto`. Úsalo cuando digan «genérame una imagen», «hazme un vídeo con IA», «anima esta foto», «clona mi voz», «que hable sin grabarlo», «haz un 360 del producto», «mete este croma en la foto», «ponle otro fondo» o «no me gusta, hazlo otra vez».

robinfernandez2016-create/guion

Convierte un brief en el guion de un reel o un anuncio, listo para grabar o generar. Escribe el gancho de 3 s, la estructura frase por frase, la toma que va con cada frase (tabla frase → toma), la llamada a la acción y el copy de la publicación, y lo deja todo en un solo guion de producción del que sale el teleprompter. No inventa cifras, nombres ni casos. Úsalo cuando digan «escríbeme el guion», «haz un anuncio», «necesito un reel sobre…», «dame un gancho», «¿cómo cierro el vídeo?», «escribe el copy de la publicación», «prepárame el teleprompter» o «¿qué tomas necesito?».

robinfernandez2016-create/motion

Hace motion graphics como código con Remotion (gráficos animados, brolls, alfas sobre el vídeo o por detrás de una persona, pop-ups, subtítulos, simulacros de chat, 3D y la portada del reel) con la marca en un archivo de tokens, bocetos de 2 o 3 fotogramas antes del render y salida con fondo o con transparencia. Úsalo cuando digan «hazme un gráfico animado», «anima este dato», «hazme un broll», «un pop-up aquí», «ponle subtítulos», «subtítulos con palabras clave», «simula un chat de WhatsApp», «que salga detrás de mí», «hazlo en 3D», «con fondo transparente», «la portada del reel» o «renderiza el MG».

Verwandte Skills