pawangai/caption-writer

Caption Writer

Schreibt Captions zum Kopieren und Hochladen – eine Version pro Plattform (nicht eine einzige überall hin kopierte Caption). Sie sind der Autor; das Skript scripts/captions.py prüft Limits und grundlegende Qualität und erstellt dann die Ergebnisdatei.

Arbeitsablauf

1. Eingaben sammeln.
   • Inhalt: Thema, Typ (Karussell, Reel, Foto, Story, Testimonial, Werbung) und ggf. Inhalt (Karusselltexte, Reel-Skript, Hook). Wenn der Nutzer den Inhaltstext angibt, muss die Caption damit konsistent sein und nicht den gesamten Slide-Inhalt wiederholen.
   • Zielplattformen. Falls nicht genannt, einmal nachfragen; wenn der Nutzer es schnell mag, Instagram und TikTok verwenden.
   • Ziel (Bildung, Speichern/Teilen, Beratung, Verkauf), Marken-CTA und Markenstimme (bei vorhandenem Brand Lock / Voice Lock verwenden; andernfalls aus dem Inhalt ableiten und die Annahmen nennen).
2. Pro Plattform schreiben gemäß references/caption-guide.md: Hook in der ersten Zeile, 2–3 Sätze mit Mehrwert, CTA, Hashtags. Jede Plattform hat einen anderen Blickwinkel und eine andere Länge.
3. Daten, die vom Nutzer kommen müssen (Kundenzitate, Namen, Preise, Aktionsdaten, Nummern, Metriken): nicht erfinden. Verwende [SELBST EINFÜGEN: Hinweis] oder frage in einer einzigen kurzen Nachricht danach.
4. captions.json schreiben (python scripts/captions.py --example für das Schema) und dann python scripts/captions.py render captions.json /mnt/user-data/outputs/caption_<thema>.md ausführen.
   • Korrigiere alle Fehler (Limits überschritten, leere Caption, geschweifte Klammern, falsches Hashtag-Format).
   • Lies die Warnungen und korrigiere sinnvolle: Hook zu lang, Anzahl Hashtags, nicht anklickbare Links (in „Link in Bio“ ändern), übertriebene Behauptungen, fehlender CTA, plattformübergreifend ähnliche Captions. Warnungen dürfen mit Begründung stehen bleiben, aber die Begründung muss genannt werden.
5. Abgeben. Ein oder zwei Plattformen: Caption direkt in der Antwort in einem Codeblock anzeigen. Drei oder mehr Plattformen: .md-Datei speichern und present_files aufrufen. Liste der verbleibenden [SELBST EINFÜGEN]-Marker und wichtige Hinweise (z. B. Link in Bio) beifügen.

Prinzipien

• Hook zuerst. Die erste Zeile muss die Leute zum Anhalten bringen, bevor „mehr anzeigen“ erscheint (Instagram ca. 125 Zeichen, LinkedIn ca. 140). Für die Hauptplattform 2 alternative Hooks bereitstellen.
• Anpassen, nicht kopieren. Instagram: warm und prägnant; TikTok: sehr kurz, folgt dem Video; LinkedIn: professionell und strukturiert; X: eine Aussage; Pinterest: von Leuten gesuchte Keywords; YouTube Shorts: klarer Titel. Das Skript markiert Captions, die zu >85 % ähnlich sind.
• Sanfter, einzelner CTA. Ein Hauptaufruf pro Caption (Speichern, Teilen, Kommentieren, Beratung). Auf Instagram und TikTok sind Links in Captions nicht anklickbar, daher auf „Link in Bio“ verweisen.
• Wenige und relevante Hashtags (ca. 3–5 bei Instagram, TikTok, LinkedIn; 0–2 bei X und Facebook). Mische 1–2 breite mit spezifischen Nischen-Hashtags. Bei TikTok zählen Hashtags zum Zeichenlimit.
• Alt-Text für Bilder/Karussells: ein Satz, der den visuellen Inhalt beschreibt, ohne „Bild von“.
• Nicht erfinden und nicht übertreiben: keine „Garantie“, „sicher“, „100 %“, Ergebniszahlen oder nicht vom Nutzer bereitgestellte Testimonials.
• Zeichenlimits können sich ändern. Die Zahlen im Skript sind konservative Sicherheitslimits aus öffentlichen, nicht einheitlichen Quellen (z. B. TikTok angeblich 2.200 oder 4.000, Pinterest 500 oder 800). Wenn der Nutzer nach den aktuellen Limits fragt, in offiziellen Quellen der Plattformen nachschlagen.

Dateien

• scripts/captions.py – render, check, --example, --limits
• references/caption-guide.md – Caption-Struktur, Hook-Formel, plattformspezifische Regeln, Alt-Text, Beispiele nach Inhaltstyp