Communitygithub.com

minkhant1996/soemind-forge

Schreibe Hooks, Skripte und Captions mit bewährten Frameworks – für Skripte, Werbetexte, Post-Captions und Hashtags.

Was ist soemind-forge?

Dieses Skill generiert kreative Copy-Formate (Hooks, Skripte, Captions) mithilfe von Direct-Response-Frameworks und ist speziell für Social-Media-Inhalte optimiert. Es wird über eine CLI angesteuert (`node workflows/cli.cjs`) und ist plattformübergreifend nutzbar – auf TikTok, Instagram, YouTube und Facebook. Der Skill analysiert zunächst vorhandene Referenztexte aus dem Projekt (z. B. `brand.md`, `style-references`), um einen konsistenten Ton und Stil zu gewährleisten. Danach generiert er automatisch mehrere Hook-Varianten, wählt auf Wunsch ein Framework (PAS, AIDA, BAB u. a.) für das Skript und erstellt plattformspezifische Captions inkl. Hashtags. Alle Ergebnisse werden als strukturierte CLI-Ergebnisse ausgegeben, die entweder direkt übernommen oder in nachgelagerte Skills (Voiceover, Storyboard, Video) weitergeleitet werden können. Das Skill vermeidet das Erfinden von Statistiken/Testimonials und besteht immer auf Benutzerbestätigung vor der finalen Übernahme.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/minkhant1996/soemind-forge/tree/HEAD/skills/write-copy

In Ihrer bevorzugten KI fragen

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

Dokumentation

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:

  1. Registry nach gespeicherten Copy-Beispielen durchsuchen:
    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
    
    Gefunden → Muster extrahieren (Satzlänge, Emoji-Nutzung, Hashtag-Stil, CTA-Formulierung, Formalität) und in allem unten Geschriebenen SPIEGELN.
  2. 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.md und 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.
  3. Wenn Beispiele existieren, in prompts.txt notieren, 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:

FrameworkAm besten geeignet für
hook-retain-rewardKurzvideo (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-solutionTestimonials / 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).

Verwandte Skills