Copy schreiben (Hooks · Skript · Caption)
Der kreative Engpass liegt nicht in der Medienerstellung – es ist das Wissen, was man sagen soll. Dieses Skill generiert Hooks, Skripte und Captions mit bewährten Direct-Response-Frameworks und lässt den Benutzer dann auswählen und verfeinern. Angetrieben durch Workflow-Befehle – rufe die CLI auf, schreibe kein Skript:
node workflows/cli.cjs generateHooks '<json-args>' # auch: generateScript, generateCaption
Die unten gezeigten TypeScript-Signaturen dokumentieren die Argumente jedes Befehls – übersetze sie in node workflows/cli.cjs <command> '<json-args>', füge sie nicht in eine neue Datei ein.
Ziehe zuerst den Kontext aus dem Projekt, wenn vorhanden (project.md Zielgruppe/Schmerzpunkte/Angebot; brand.md Ton/Beschränkungen), damit die Copy markenkonform ist und niemals gegen die restrictions verstößt.
SCHRITT 0: Vor dem Schreiben Referenz-Copy prüfen
Stimmigkeit kommt von Beispielen, nicht von Adjektiven. Bevor Hooks, Skripte oder Captions generiert werden:
- Registry nach gespeicherten Copy-Beispielen durchsuchen:
Gefunden → Muster extrahieren (Satzlänge, Emoji-Nutzung, Hashtag-Stil, CTA-Formulierung, Formalität) und in allem unten Geschriebenen SPIEGELN.node workflows/cli.cjs resolveAsset '["{name}","style-copy"]' # eine style_references-ID mit Copy-Beispielen cat projects/{name}/assets/style/copy-examples.md 2>/dev/null cat projects/{name}/style-samples/caption-examples/*.md 2>/dev/null # Benutzerinbox - Nichts gespeichert → einmal fragen:
„Hast du vergangene Beiträge, Captions oder Skripte, die gut funktioniert haben – oder Profile, deren Copy-Stil du magst? Füge 1–3 Beispiele ein (oder „keine“ – ich orientiere mich an brand.md).“
- Beispiele gegeben → speichern in
projects/{name}/assets/style/copy-examples.mdund registrieren (registerAsset '["{name}","style_references",...]'), damit zukünftige Stücke sie wiederverwenden. - „keine“ → von
brand.md-Ton ausgehen und angeben, welche Ton-Annahmen getroffen wurden.
- Beispiele gegeben → speichern in
- Wenn Beispiele existieren, in
prompts.txtnotieren, auf welches Referenz-Beispiel die Copy abgestimmt wurde.
SCHRITT 1: Hooks (den Blickwinkel wählen, bevor das Ganze geschrieben wird)
Eine Streuung von Hooks über verschiedene Blickwinkel generieren und den Benutzer 1–2 auswählen lassen, um darauf aufzubauen.
node workflows/cli.cjs generateHooks '{"topic":"KI-Lernplan-App","audience":"Uni-Studenten bei der Prüfungsvorbereitung","painPoint":"keine Ahnung, wo ich mit dem Lernen anfangen soll","platform":"tiktok","count":8}'
# h.data.hooks: [{ text, angle }] — angles: problem | curiosity | result | contrarian | question | stat | story
Nach Blickwinkeln gruppiert anzeigen und fragen, welche verwendet werden sollen. Nicht automatisch auswählen – der Hook entscheidet über das gesamte Stück.
SCHRITT 2: Skript (framework-gesteuert, auf Dauer abgestimmt)
Sobald ein Hook ausgewählt ist, das Skript mit einem Framework schreiben, das zum Ziel passt:
| Framework | Am besten geeignet für |
|---|---|
hook-retain-reward | Kurzvideo (TikTok/Reels/Shorts) – Standard |
PAS (Problem-Agitate-Solution) | Schmerzorientierte Anzeigen |
AIDA (Attention-Interest-Desire-Action) | Klassisches Direct Response |
BAB (Before-After-Bridge) | Transformation / Ergebnisse |
star-story-solution | Testimonials / Gründergeschichte |
# hook: den ausgewählten Hook-Text von generateHooks übergeben
node workflows/cli.cjs generateScript '{"brief":"KI-Lernplan-App, die einen Lernplan in 60 Sekunden erstellt","framework":"PAS","platform":"tiktok","durationSeconds":30,"hook":"<ausgewählter Hook-Text>","cta":"Kostenlos testen – Link in Bio"}'
# s.data: { framework, sections:[{label, voiceover, visual}], wordCount, estimatedDurationSeconds }
Das Skript als beschriftete Abschnitte (Voiceover + visueller Hinweis) und die geschätzte Dauer anzeigen.
Hinweis geben, wenn estimatedDurationSeconds weit vom Ziel entfernt ist, damit der Benutzer kürzen/erweitern kann.
Dieser voiceover-Text fließt direkt in generateVoiceover() und die szenenweisen visual-Hinweise in generateStoryboard() / das Video-Skill.
SCHRITT 3: Caption (veröffentlichungsbereit, pro Plattform)
Die letzte Meile – der Beitragstext + Hashtags, die tatsächlich mit dem Video/Bild ausgeliefert werden.
node workflows/cli.cjs generateCaption '{"topic":"KI-Lernplan-App","platform":"instagram","tone":"freundlich, selbstbewusst","cta":"Link in Bio","count":3}' # platform: tiktok | instagram | youtube | facebook
# c.data.captions: [{ text, hashtags:[] }]
Plattformspezifische Varianten generieren, falls das Stück crossgepostet wird (jede Plattform hat andere Längen- und Hashtag-Konventionen). Die ausgewählte Caption neben dem Output speichern, z. B. projects/{name}/output-contents/.../caption.md.
Wie es zusammenhängt
generateHooks → pick → generateScript → { voiceover → generateVoiceover,
visual cues → generateStoryboard → video }
→ generateCaption → caption.md
Immer vorschlagen und bestätigen – Optionen präsentieren, eine mit Begründung empfehlen, den Benutzer bearbeiten lassen. Niemals Statistiken/Testimonials erfinden (nur echte aus project.md holen).