Communitygithub.com

tianbester-ZA/script

Erstellt Drehbücher für 15–60-sekündige Social-Media-Videos (UGC, Founder, Talking Head, Skits) im Butcherbird-Shoot-Pack-Format, prüft jede Entscheidung anhand von 17 Werbebüchern und führt einen unabhängigen Kritik-Durchgang durch.

Was ist script?

Diese Skill automatisiert die Erstellung von Drehbüchern für bezahlte Social-Media-Videos (15–60 Sekunden) im Stil von UGC, Founder-Stories, Talking Heads oder Skits. Sie produziert ein komplettes „Shoot Pack“ im Butcherbird-Format (eine Anzeige pro Seite), das ein Team an einem Nachmittag abfilmen kann. Der Prozess ist in acht Schritte unterteilt: Zuerst werden Kundeninformationen, Personas und bereits vorhandene Anzeigen analysiert; dann wird die Zielgruppe diagnostiziert, es werden 6–10 Buchsuchen zu den tatsächlichen Problemen des Produkts durchgeführt, verschiedene Hook-Typen entwickelt, der Entwurf mit Passagen aus den Büchern untermauert und schließlich ein Kritik-Durchlauf von einem separaten Agenten durchgeführt, der den Entwurf gegen das Briefing und die Buchpassagen prüft. Die Skill unterstützt sowohl die Erstellung neuer Anzeigen als auch die Überarbeitung bestehender schwacher Skripte oder das Schreiben von On-Screen-Texten für bereits gedrehtes Filmmaterial (Edit-Modus). Wichtige Besonderheiten: Es wird immer nur ein Kunde pro Job bearbeitet, keine erfundenen Zahlen oder Bewertungen, und die Buchtexte werden nie direkt zitiert, sondern nur in eigenen Worten zusammengefasst. Die Skill ist für Claude Code optimiert (nutzt Shell-Befehle, plugin-spezifische Pfade und den Start separater Agenten) und erfordert Zugriff auf die Referenzdateien im Skill-Verzeichnis.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tianbester-ZA/butcherbird-skills/tree/main/plugins/bb/skills/script

In Ihrer bevorzugten KI fragen

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

Dokumentation

/bb:script

Ziel

Ein Shoot Pack, das das Team an einem Nachmittag abfilmen kann. Jede Anzeige hält einen Fremden in zwei Sekunden bei ausgeschaltetem Ton auf, gibt einer Person einen Grund zu kaufen und endet mit einem Angebot, auf das sie reagieren kann. Dahinter steht ein Reasoning Sheet, das zu jedem Hook, Versprechen und Beleg die zugehörige Buchpassage nennt.

Hier starten: Lesen, zusammenfassen, einmal nachfragen

Die Person, die dies ausführt, hält den Kontext, und was sie hier sagt, macht die Arbeit gut. Eine unserer Anzeigen ist gescheitert, weil nichts gefragt wurde; ein Reel hat funktioniert, weil jemand echten Kontext geliefert hat.

Zuerst lesen, nicht fragen: die Gewinner des Kunden, Personas, Bewertungen und frühere Anzeigen; Live-Produkt, Preis und Angebot; was im Brief steht.

Zusammenfassen: Käufer, Blickwinkel, Stage, Angebot, so wie du sie aus den Beweisen abliest. Fülle das ein, was du weißt, damit die Person bestätigt statt neu tippt.

Frage nur, was fehlt, in einer kurzen Runde (AskUserQuestion, wenn du es hast, sonst in der Nachricht). Normalerweise zwei oder drei:

  1. Wen soll diese Anzeige bewegen, was sollen sie sich für sich selbst vorstellen und was sollen sie direkt nach dem Anschauen tun?
  2. Welches genaue Produkt, Angebot, Preis, Handlungsgrund und Beleg können wir heute zeigen? Was ist der Person, die spricht, wirklich passiert?
  3. Wer spricht, wie sollen sie klingen und was können wir tatsächlich filmen: Kamera, Personen, Ort, Requisiten, Zeit?

Dann vorschlagen, wo es einzuordnen ist, für ein Ja oder eine Änderung: Käufer × Blickwinkel × Bekanntheitsgrad, der Skript-Modus (Founder-Story, echte Kommentarantwort, Demonstration, problemgesteuert, fairer Vergleich, Field Challenge oder Unterhaltung, direktes Angebot) und das Format.

Schreibe die Antworten in job/brief.md und arbeite dann ohne weitere Unterbrechungen bis zum Ende. Wenn sie bereits alles gegeben haben oder sagen „mach einfach“, dann frage nicht. Wenn niemand antworten kann (ein kopfloser Durchlauf), sag, was du gefragt hättest, und nimm die sinnvollste Lesart.

Geschmack gehört zum Job

Schreibe den Job in die erste Zeile von job/brief.md: bezahlte Anzeige, organischer Reel oder was auch immer die Eröffnungsrunde festgelegt hat. Was jemandem in einem Video gefallen hat, überträgt sich nicht auf ein anderes. Ein organischer Reel und eine Anzeige sind verschiedene Jobs: Die Anzeige soll verkaufen. Daher wird eine Anzeige danach beurteilt, für wen sie ist, die Verkaufsargumente des Produkts, Belege und einen Grund zu kaufen, nicht nach den Witzen oder dem Gefühl eines organischen Stücks. Ein Witz verdient seinen Platz in einer Anzeige nur, wenn er den Verkauf trägt.

Warum das existiert

Allein gelassen schreibt Claude höfliche Anzeigen: eine Person zur Kamera, ein sanfter gesprochener Hook, der dich kennt, ein kleiner Gag, das Angebot zweimal gesagt, derselbe Schluss jedes Mal. Sauber, drehbar und flach. Modelle tendieren zur sicheren, gewöhnlichen Wahl, und eine Liste von Regeln holt sie nicht zurück.

Was es tut: Die Anziehungskraft vor den Worten finden, viele Hooks machen, bevor man wählt, die Buchnotiz vor sich haben, und einen Kritiker, der deine Argumentation nie gesehen hat, den Entwurf beurteilen lassen. Bücher sind Fragen und Passagen, niemals Stimmen. „Schreib wie Schwartz“ bringt nichts. „Dieser Zuschauer ist kalt, beschreibt Zeile eins also ihn und nicht das Produkt?“ mit der Passage dahinter schon.

Wie gut aussieht

  • Fünf Anzeigen, die sich nicht ähneln. Wenn du die Reihenfolge liest, kannst du Anzeige 4 nicht aus Anzeige 1 vorhersagen.
  • Ein erster Frame und eine Textzeile, die ein Fremder stumm versteht, mit wenigen Wörtern. Die Kamera kann ein Charakter sein und der Endgag ein Blick. Nicht jede Idee ist ein Talking Head, und nicht jede Idee endet damit, dass jemand in einen Pool fällt.
  • Schnell und klar, für wen es ist und warum sie kaufen würden, und jede Anzeige endet mit einem Angebot. Skits sind willkommen, wenn das Briefing Spaß will, und müssen trotzdem verkaufen: Der Witz ist das Verkaufsargument, und ihn nachzuerzählen braucht das Produkt.
  • Direktional: „Mach das. Mach das. Sag das.“ Der einfachste Aufbau, der die Idee trägt, normalerweise ein Ort und die wenigsten Personen.
  • Ein Angebot pro Anzeige, einmal gesagt, am Schluss, genau, in zwölf Wörtern oder weniger, formuliert in seiner stärksten wahren Form.
  • Genaue Zahlen und benannte Details statt Adjektive, jeweils auf ihren Eigentümer zurückgeführt.
  • Es spricht zu einer Person und verändert einen Glauben, den sie hat. Ein Produkt, das durch schöne Aufnahmen spaziert, ist eine Showcase, egal wie hübsch, und scheitert.
  • Ein Pack, das genauso aussieht wie das ausgelieferte Format, ohne Zitate, offene Fragen oder als unbestätigt markierte Angaben.

Befehle

Referenzdateien schreiben diese kurz. Der Shell-Zustand bleibt nicht zwischen Befehlen erhalten, verwende daher immer die vollständige Form und gib einem Kritik-Agenten auch die vollständige Form.

  • scripts/... bedeutet ${CLAUDE_SKILL_DIR}/scripts/.... references/... bedeutet ${CLAUDE_SKILL_DIR}/references/....
  • search.py bedeutet python3 "${CLAUDE_PLUGIN_ROOT}/skills/books/scripts/search.py".
  • Buchkarten: ${CLAUDE_PLUGIN_ROOT}/skills/books/cards/.

Der Weg

Arbeite in <client>-scripts/<yyyy-mm-dd>-<slug>/ in dem Ordner, in dem die Person ist, oder dem Ordner, den das Briefing nennt (job/). Jeder Schritt schreibt etwas, sodass eine neu gestartete Sitzung von der letzten Datei fortsetzt.

0. Lesen, zuerst den Kunden. Die Eröffnungsrunde von oben, richtig gemacht: die eigenen Gewinner des Kunden und ihre Zahlen, seine Personas und die Worte seiner Kunden (Bewertungen, Anzeigenkommentare), überall wo seine Notizen hinweisen. „Keine auf Datei“ bedeutet, du hast noch nicht geschaut. Dann alle Kundennotizen oder Profil-Skills, der eigene Ordner des Kunden mit Gewinnern (nur dieser Kunde, siehe examples/README.md), lessons.md, das Briefing. Überprüfe Preise, Angebote und Daten bei ihren Eigentümern. Schreibe job/brief.md: Fakten und Angebote mit Quelle und Datum, wer vor der Kamera steht, was nur diese Marke hat, die eigenen Ideen des Kunden eine pro Zeile, die Antworten aus der Eröffnungsrunde.

1. Diagnose. Lade references/diagnose.md. Beginne mit einer echten Person: ein Name für ihren Typ, ihr Tag, was sie jetzt benutzt, was sie sagen würde, warum sie und nicht die anderen Personas, mit den Beweisen. Dann kläre die Anziehungskraft, was sie jetzt tun, wie bekannt sie sind, wie oft sie es gehört haben, was sie nicht glauben, warum das Angebot existiert und was nur diese Marke hat. Schreibe reasoning.md §1, ein Block pro Slot.

2. Durchsuche die Bücher für diesen Job. Lade references/search.md. Beginne nicht aus dem Gedächtnis, was die Bücher sagen: Führe sechs bis zehn Suchen zu den tatsächlichen Problemen dieses Produkts durch, lies die Notizen mit --show, behalte acht bis zwölf, die für dieses Briefing relevant sind. Schreibe reasoning.md §2: ID, eine Zeile, welcher Slot.

3. Hooks. Lade references/hooks.md. Sechs bis acht pro Anzeige über mindestens vier Arten hinweg, einschließlich einem einfachen und mindestens zwei ungewöhnlichen, die du zögern würdest, dem Kunden zu zeigen. Behalte drei: einen sicheren, einen ungewöhnlichen, einen, der das Angebot nicht nennt. Schreibe reasoning.md §3. Mach die Optionen, auch wenn niemand da ist, um sie zu sehen: wähle und lass die übergangenen im Blatt.

4. Entwurf. Lade references/body-and-close.md, references/offer-and-proof.md und references/pack-format.md. Schreibe job/pack-draft.md. Schreibe reasoning.md §4: pro Anzeige eine Zeile für Hook, Versprechen, Beleg, Körper und Schluss, jede mit ihrer Passage.

5. Prüfung.

python3 "${CLAUDE_SKILL_DIR}/scripts/check_pack.py" job/pack-draft.md --event "Black Friday"
python3 "${CLAUDE_SKILL_DIR}/scripts/cite_check.py" job/reasoning.md

Behebe jede rote Zeile. Gelbe Zeilen sind Ermessensentscheidungen. Speichere die Ausgabe in job/checks.txt.

6. Kritiker. Starte einen neuen Agenten auf dem stärksten verfügbaren Modell mit pack-draft.md, brief.md, references/critic.md, dem vollständigen search.py-Befehl (und für eine Bearbeitung die Footage-Blätter). Nicht reasoning.md, nicht dieser Chat: Er beurteilt die Anzeige gegen den Job im Briefing, nicht die Ausrede. Seine Fragen nennen echte Passagen und er liest ihre Notizen. Er gibt Notizen zurück, niemals eine Neufassung. Speichere als job/critic.md.

7. Umschreiben. Lies die Notiz hinter jeder Passage, die der Kritiker zitiert, bevor du darauf reagierst: Manche IDs stellen sich als etwas anderes heraus, und eine Notiz kann trotzdem in ihrer eigenen Logik richtig sein. Wo das Briefing gewinnt, widersprich schriftlich in reasoning.md §5. Führe Schritt 5 erneut aus. Eine Runde, höchstens zwei. Das Ergebnis ist job/pack.md.

8. Packen.

python3 "${CLAUDE_SKILL_DIR}/scripts/build_pack.py" job/pack.md --pdf

Öffne das PDF und schau dir jede Seite an: nichts abgeschnitten, eine Anzeige pro Seite. Lies alle warning:-Zeilen. Gib in der Antwort eine Zeile pro Anzeige und einen Satz, der die Bücher einmal nennt. Wenn der Kunde ein Log hat, füge eine datierte Zeile hinzu.

Geklärt ist geklärt

Fakten, die die Person geklärt hat, sind geklärt. Niemand will ein Pack, das Dinge als unbestätigt auflistet, oder eine Seite mit kleinen Fragen. Also nicht: Nimm die sinnvollste Lesart, schreibe sie in reasoning.md §0 mit einer Zeile warum, und mach weiter. Setze, was sie bestätigt haben, in die settled:-Zeile des Packs, die der Prüfer respektiert. Wenn eine Zahl wirklich keinen Eigentümer hat, schreibe die Anzeige ohne sie und protokolliere das.

Nur was eine Entscheidung oder einen Kunden ändern würde, wird als eine einfache Zeile in der Antwort angemerkt. Eine Zahl, die du nicht belegen kannst, wird nie erfunden und erscheint auch nie als Frage.

Bearbeiten von bereits vorhandenem Filmmaterial

Manchmal ist der Job Text für bereits vorhandenes Filmmaterial, nicht für einen Dreh. Gleicher Weg, drei Unterschiede. Schritt 0 beginnt mit dem Filmmaterial: Liste die brauchbaren Momente nach Clip und Zeit auf, da das Drehbuch nur versprechen kann, was gefilmt wurde. Schritt 1 fügt eine Filmmaterialprüfung hinzu: Für jede Behauptung nenne den Clip-Moment, der sie zeigt, und schreibe eine Behauptung ohne Aufnahme um oder lass sie weg. Auf der Seite setze mode: edit in den Front Matter: Say Lines halten On-Screen-Wörter, der Schluss ist On-Screen-Text, der Filmabschnitt ist ## Das Filmmaterial. Übergib das Pack an /bb:edit.

Harte Grenzen

  • Ein Kunde pro Job. Nichts von einem anderen Kunden kommt in das Briefing, das Pack oder das Blatt, und keine Informationen eines Kunden gehen in diese Skill.
  • Keine erfundenen Zahlen, Fristen, Lagerbestände oder Bewertungen. Dringlichkeit ist nur das, was wahr ist und einen Grund hat.
  • Buchtexte bleiben draußen. Sag, was ein Buch lehrt, in deinen eigenen Worten und zitiere die ID.
  • Nichts geht an einen Kunden, wird veröffentlicht oder gibt Geld aus dieser Skill aus, ohne das Ja der Person. Das Pack geht an die Person, die dies ausführt; sie sendet es.

Know-how

Wörter pro Sekunde. 2,5 gesprochene Wörter pro Sekunde: 15 s sind etwa 35 Wörter, 20 s etwa 50, 30 s etwa 75, 60 s etwa 150. Aktionen brauchen auch Zeit.

Die Bücher handeln nicht von Reels. Sie sind Print-, Versandhandels-, TV- und Laborstudien. Behandle die Zahlen als das, was die Menschen damals bewegt hat. Hormozis sind seine eigenen Behauptungen; viele von Cialdinis sind Gefälligkeiten, keine Käufe. Nichts darin testet einen stummgeschalteten Feed. Stumme Grammatik, die Kamera als Charakter und Endgags kommen vom Anschauen echter Reels, also schau dort hin: die eigenen Referenzen des Kunden und was immer die Person geschickt hat.

Wo die Bücher streiten. Jede Referenz endet mit den Uneinigkeiten und in welche Richtung wir für ein 15- bis 60-sekündiges Video tendieren. Nenne die Tendenz im Blatt, wenn sie eine Anzeige entscheidet.

Eine Abstimmung ist ein Meinungstest. Kritiker und Juroren bevorzugen clever; Split-Runs tun es oft nicht (caples-0221, caples-0279). Deshalb wird ein einfacher Hook als weitere Option gefilmt, selbst wenn der Kritiker unbeeindruckt ist, und Live-Zahlen entscheiden.

Hook und Halten. Hook-Rate = 3-Sekunden-Aufrufe ÷ Impressionen. Hold-Rate = ThruPlays ÷ 3-Sekunden-Aufrufe. Hook unter etwa 20 %: Nur den Anfang neu schneiden. Hold unter etwa 40 %: Die Mitte neu schneiden. Beide gesund und keine Käufe: Das Angebot oder der Schluss, nicht der Schnitt.

Lade diese, wenn

ReferenzWann
references/diagnose.mdSchritt 1, und wann immer ein Skript flach wirkt und du nicht sagen kannst, warum
references/search.mdSchritt 2, oder wenn eine Suche leer zurückkommt
references/hooks.mdSchritt 3, und für jeden Job „diese Anzeige neu hooken“
references/body-and-close.mdSchritt 4
references/offer-and-proof.mdSchritt 1 für die Glaubenslücke und den Grund des Angebots; Schritt 4
references/pack-format.mdSchritt 4 und Schritt 8
references/critic.mdNur der Kritik-Agent (Schritt 6)
examples/README.mdSchritt 0, um die Gewinner eines Kunden zu finden
evals/judge.mdNur für Blindtests zwischen zwei Packs

Lektionen

lessons.md enthält datierte Aufzählungspunkte aus echten Ergebnissen: die Anzeige, die Zahl mit ihrem Datum, die Passage hinter dem Beat, was versucht wurde. Lies die letzten fünf bei Schritt 0; der Kritiker prüft den Entwurf gegen sie. Dieser Ordner wird bei jedem Update ersetzt, daher gehen die eigenen Lektionen und Gewinner eines Kunden in den Ordner dieses Kunden, und eine Lektion für alle geht über das Repo (CONTRIBUTING.md).

Individual skills in this repo

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

Verwandte Skills