Communitygithub.com

Pedrovbm1/guion

Schreibe das Skript für ein kurzes Erklärvideo (Reel, TikTok, Short oder 3D-Animationserklärer) mit recherchierten und belegten Daten, einem Gedanken pro Satz in Alltagssprache und einer Runde 0 von Prüfern (A Bindung, B Daten, C Klarheit) mit Schwellenwerten, bevor du für Stimme oder Animation ausgibst. Endet mit dem Stopp `GUION LISTO`, damit der Nutzer sein OK geben kann. Verwende es, wenn der Nutzer nach „einem Skript“, „schreibe mir den Videotext“, „erkläre mir X in einem Video“ fragt oder als ersten Schritt der Skill „explicador“. Auch, wenn er ein virales Referenzvideo schickt und „so eins“ möchte: Es werden das Thema und das, was funktioniert, übernommen, niemals dessen Skript.

Was ist guion?

Dieser Skill erstellt das Textskript für kurze Erklärvideos (Reels, TikToks, Shorts oder 3D-Animationen) auf Basis von recherchierten und belegten Fakten. Er folgt einem strengen Qualitätsprozess: Jeder Satz enthält nur einen Gedanken, die Sprache ist alltäglich, und vor der teuren Sprach- oder Animationsproduktion durchläuft das Skript eine „Runde 0“ mit drei unabhängigen Prüfern (Bindung, Daten, Klarheit), die es auf definierte Schwellenwerte prüfen. Der Skill stoppt zwingend beim Status `GUION LISTO`, um das finale OK des Nutzers einzuholen – eine Fehlerkorrektur im Text ist extrem günstig im Vergleich zu nachträglichen Änderungen am fertigen Video. Der Skill arbeitet mit Projektdateien (`voz/frases.txt`, `MAPA.md`, `DECISIONES.md`) und kann durch die Analyse von Referenzvideos das erfolgreiche Format übernehmen, ohne jedoch das Skript zu kopieren. Er ist ideal für Entwickler, Content-Creators und alle, die professionelle, datengestützte Videoskripte erstellen möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pedrovbm1/explicadores-3d/tree/main/skills/guion

In Ihrer bevorzugten KI fragen

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

Dokumentation


name: guion description: Schreibe das Skript für ein kurzes Erklärvideo (Reel, TikTok, Short oder 3D-Animationserklärer) mit recherchierten und belegten Daten, einem Gedanken pro Satz in Alltagssprache und einer Runde 0 von Prüfern (A Bindung, B Daten, C Klarheit) mit Schwellenwerten, bevor du für Stimme oder Animation ausgibst. Endet mit dem Stopp GUION LISTO, damit der Nutzer sein OK geben kann. Verwende es, wenn der Nutzer nach „einem Skript“, „schreibe mir den Videotext“, „erkläre mir X in einem Video“ fragt oder als ersten Schritt der Skill explicador. Auch, wenn er ein virales Referenzvideo schickt und „so eins“ möchte: Es werden das Thema und das, was funktioniert, übernommen, niemals dessen Skript.

Skript eines Erklärers

Das Skript ist das Billigste zu korrigieren und das Teuerste, um es falsch zu entdecken. Ein Skript neu zu schreiben, wenn das Video bereits erstellt ist, kostet Stunden; es im Text zu lesen, kostet eine Minute. Deshalb hält dieser Skill immer bei GUION LISTO an.

Ausgabe: ein Projektordner mit voz/frases.txt (ein Satz pro Zeile), MAPA.md (visuelles Skript + Daten mit Quelle) und DECISIONES.md. Wenn der Skill mit explicador verwendet wird, wurde das Projekt bereits von nuevo.py erstellt und das MAPA ist der Entwurf von escena/CONTRATO.md.

1. Die Idee empfangen

  • Wenn ein Videolink eintrifft, analysiere ihn mit dem Skill ver-video. Von einem fremden Video wird nur das Thema und das, was es funktionieren lässt (Hook, Rhythmus, Struktur) übernommen. Niemals sein Skript, seine Sätze, seine Bilder oder seine Musik.
  • Frage das, was du nicht weißt, in einem einzigen Paket (maximal 4 Fragen): Zielgruppe, Dauer, ob es einzeln oder Teil einer Serie ist, Ton. Was der Nutzer entscheidet, kommt mit Datum in DECISIONES.md (wird nach dem Komprimieren des Kontexts erneut gelesen).

2. Mit Quellen recherchieren

  • Jede Zahl, jedes Datum oder jede überprüfbare Behauptung erhält ihre Quelle (Link + was sie sagt). Wenn es keine seriöse Quelle gibt, wird sie nicht aufgenommen. Wenn die Quellen nicht übereinstimmen, wird es mit Nuancen gesagt („zwischen 10 und 15“, „es wird geschätzt“).
  • Erklärungen von „Warum“, die Theorien oder Hypothesen sind, werden als solche gekennzeichnet („es wird angenommen“, „eine Idee ist“).
  • Ein erfundenes „zum Beispiel“ wird als Beispiel gekennzeichnet („sagen wir, es misst 8 cm“).
  • Du kannst die Suche an einen Unteragenten mit Websuche und Aufwand high delegieren (eine falsche Aussage kostet Vertrauen), aber du überprüfst die wichtigsten Quellen.
  • Notiere alles in MAPA.md → Abschnitt „Überprüfte Daten“: Daten · Quelle · kurzes Zitat.

3. Schreiben

Stilregeln (sie erhöhen die Bindung und Klarheit am meisten):

  1. Ein Gedanke pro Satz. Wenn ein Satz „und außerdem“, „obwohl“ oder eine zusätzliche Bedingung enthält, teile ihn auf.
  2. Alltagssprache, wie du es einem Freund erzählen würdest: alltägliche Wörter, Beispiele aus dem Haushalt oder der Arbeit. Jeder Fachbegriff wird beim ersten Mal erklärt oder nicht verwendet.
  3. Hook innerhalb von 3 s (spätestens 4,5 s): eine Neugierfrage oder etwas, das dem widerspricht, was das Publikum glaubt. Der erste Frame muss ohne Audio verständlich sein: klares Bild + geschriebene Frage.
  4. Versprechen und Einlösung: Was der Hook verspricht, wird eingelöst, und zwar mit etwas Sichtbarem.
  5. Ein Mikro-Hook alle 5-8 s („aber Achtung“, „und hier kommt das Seltsame“).
  6. Ende, das zum Anfang zurückkehrt (Loop) und eine Frage für Kommentare, die nicht allgemein ist.
  7. Dauer: ~16 Zeichen pro Sekunde Sprechgeschwindigkeit (≈ 3 Wörter/s). Ein einzelnes Video funktioniert am besten bei 15-30 s; mehr als 60 s nur, wenn es Teil einer Serie mit Name und Nummer ist.
  8. Kein Kopieren anderer Kreativer, weder ihrer festen Phrasen.
  9. Für 3D-Animation: nichts mit Augen oder gleichen Kreispaaren, die wie Augen aussehen (Orbits mit Ringen, zwei identische Fenster, Scheiben mit einem Bogen darüber). Wenn das Objekt rund ist, sagt das MAPA, wie es gezeichnet wird, damit es nicht so aussieht.

Schreibe voz/frases.txt und das MAPA: eine Tabelle mit jedem Satz, seinem Schlüsselwort (das den Bildwechsel auslöst), was bei diesem Wort zu sehen ist, der genauen Einblendung, falls vorhanden, und seiner ungefähren Sekunde.

4. Runde 0 über das MAPA (nur Text, vor Stimme und Animation)

Starte 3 unabhängige Prüfer parallel (Unteragenten, mittleres Modell wie Sonnet mit Aufwand medium; B mit high). Jeder liest voz/frases.txt und MAPA.md, liest nicht die der anderen, und liefert revision/REV_<buchstabe>_mapa_v<N>.md mit Bewertung /10 und genauen Korrekturen (welcher Satz, welches Wort, welche Einblendung). Der Auftrag steht in RONDA0.md.

  • A · Bindung: Frame 0 ohne Audio, Hook < 3 s, Versprechen und Einlösung, Mikro-Hooks, Abschnitte von mehr als 5 s ohne Wechsel, Loop, Schlussfrage, Dauer.
  • B · Daten: Jede Zahl gegen ihre Quelle (sie überprüft sie), dass jede genannte Zahl ihre Einblendung hat, dass auf dem Bildschirm nichts erscheint, was nicht im MAPA steht.
  • C · Klarheit für einen Unkundigen: Erzählt das Skript aus der Perspektive eines 15-Jährigen nach; listet jedes Wort, jeden Namen, jedes Akronym oder jede unerklärte Zahl auf; markiert Sätze mit mehr als einem Gedanken und Kleingedrucktes („im Allgemeinen“, „ein Szenario, keine Vorhersage“). Schlägt die umgeschriebene Version jedes Satzes vor und legt die Dauer fest.

Wende die Korrekturen an und wiederhole, bis A ≥ 9 und C ≥ 9 und B keine HOHEN Befunde aufweist, mit maximal 2 Runden. Wenn es im zweiten Durchgang nicht besteht, stoppe und sende dem Nutzer das Skript mit den Notizen: Es wird nicht erstellt.

5. GUION LISTO (obligatorischer Stopp)

Sende dem Nutzer in einer einzigen Nachricht und im Chat (nicht als Datei):

  • das Skript im Klartext (10-12 Zeilen),
  • die geschätzte Dauer und die Notizen aus Runde 0,
  • die Daten mit ihren Quellen,
  • maximal 4 Fragen.

Beende deinen Zug mit GUION LISTO. Generiere keine Stimme und starte keine Animation, bis der Nutzer antwortet. Dieser Schritt wird nicht übersprungen, selbst wenn der Nutzer sagt „arbeite durchgehend“: Das gilt für Recherche und Erstellung, nicht für diesen Schritt.

Individual skills in this repo

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

Verwandte Skills