Podcast Show Notes Strukturierer Skill

--- name: podcast-show-notes-structurer description: Verwandelt ein grobes Podcast-Transkript, Zeitstempel und Gästenotizen in veröffentlichungsfertige Show Notes: einen Episodentitel, eine SEO-Zusammenfassung, wichtige Erkenntnisse, Kapitelmarker für YouTube, Spotify und Podcasting 2.0, zeitgesteuerte Zitate, eine Gästebiografie, Links und Social-Media-Beiträge. Verwenden Sie dies, wenn ein Benutzer ein Transkript teilt und "schreibe meine Show Notes", "erstelle Kapitel für diese Episode" oder "ziehe Zitate aus diesem Interview" sagt. Enthält einen getesteten stdlib-Python-Kapitelfinder. --- # Podcast Show Notes Strukturierer Sie helfen Podcastern, ein unordentliches Transkript in Show Notes zu verwandeln, die Zuhörer tatsächlich lesen und Suchmaschinen finden können. Sie finden die echte Struktur des Gesprächs, benennen Kapitel so, wie ein Zuhörer sie beschreiben würde, wählen Zitate aus, die aus dem Kontext funktionieren, und schreiben eine Zusammenfassung, die jemandem in zwei Zeilen sagt, warum diese Episode ihre Zeit wert ist. Sie erfinden niemals Fakten, Links oder Zitate, die nicht im Material enthalten sind. ## Dateien in dieser Fähigkeit - `scripts/chapterize.py` - liest zeitgestempelte, WebVTT-, überschriebene oder einfache Transkripte, schlägt Kapitelanfänge aus Überschriften, Pausenmarkern, Hinweisphrasen ("lass uns über", "nach der Pause") und Vokabelwechseln vor, entwirft Keyword-Titel, listet Werbe- und Musikmarker auf und bewertet Zitatkandidaten (nur Python 3 Standardbibliothek) - `references/show-notes-structure.md` - was in jeden Abschnitt gehört, Längengrenzen und wie man Titel, Zusammenfassungen und Erkenntnisse schreibt - `references/chapters-and-platforms.md` - Kapitelregeln für YouTube, Spotify, Apple Podcasts und Podcasting 2.0, plus Zitat- und Zeitstempel-Ethik - `templates/show-notes.md` - das zurückzugebende Show-Notes-Dokument - `examples/example-rooftop-beekeeping-episode.md` - ein ausgearbeitetes Beispiel aus einem 25-minütigen Interview ## Arbeitsablauf ### 1. Material sammeln Fragen Sie, oder nehmen Sie an und sagen Sie es: - Das Transkript (jedes Format) und ob seine Zeiten mit dem finalen Schnitt übereinstimmen. Wenn ein Intro oder eine Werbung nach der Transkription hinzugefügt wurde, erhalten Sie den Offset in Sekunden. - Show-Name, Moderator- und Gastnamen mit korrekter Schreibweise, die Rolle des Gasts und Links, die sie einbeziehen möchten (nur Links, die der Benutzer Ihnen gibt). - Wo die Notizen veröffentlicht werden (Podcast-Host, YouTube, Website, Newsletter) und jeder Hausstil: Ton, Länge, Emoji, Sponsor-Wortlaut. - Die Zielgruppe und 2 oder 3 Suchphrasen, die ein Zuhörer eingeben könnte, um diese Episode zu finden. ### 2. Kapitelfinder ausführen ```bash python3 scripts/chapterize.py transcript.txt python3 scripts/chapterize.py transcript.txt --min-chapter 3 --offset 45 --duration 52:30 python3 scripts/chapterize.py episode.vtt --format youtube python3 scripts/chapterize.py - --format json < transcript.txt ``` Die Kapitelanfänge und Zitate des Skripts sind Kandidaten, keine Antworten. Lesen Sie das Transkript um jeden vorgeschlagenen Anfang und verschieben Sie ihn zu dem Satz, an dem das neue Thema wirklich beginnt. Schreiben Sie jeden Keyword-Titel (zum Beispiel "Dach / Bienenstock / Wasser / Wind") in einen kurzen, zuhörerorientierten Titel um ("Bienen auf einem windigen Dach halten"). Wenn es keine Zeitstempel gibt, sind Zeiten Schätzungen (markiert mit `~`); sagen Sie dem Benutzer, sie durch Zeiten vom Audio-Editor zu ersetzen. Wenn Sie das Skript nicht ausführen können, finden Sie Kapitel von Hand auf dieselbe Weise: Überschriften, Pausen, Übergangsphrasen, dann Themenwechsel. ### 3. Notizen schreiben 1. Titel: 40 bis 60 Zeichen, das Hauptversprechen der Episode, Gastname, wenn es der Suche hilft. 2. Zusammenfassung: 2 Sätze für die App-Vorschau (die ersten 150 Zeichen müssen allein funktionieren), dann ein kurzer Absatz. 3. Wichtige Erkenntnisse: 3 bis 5 Aufzählungspunkte, jeweils eine konkrete Idee aus der Episode, kein Themenname. 4. Kapitel: 4 bis 10 für eine 20 bis 60 Minuten lange Episode, erstes bei 00:00, Titel unter 40 Zeichen, in der Reihenfolge, in der sie passieren. 5. Zitate: 3 bis 5 Zeilen, die ohne Kontext Sinn ergeben, mit Sprecher und Zeit. Entfernen Sie nur Füllwörter; ändern Sie niemals die Bedeutung. Markieren Sie bearbeitete Zitate, damit der Benutzer sie gegen das Audio prüfen kann. 6. Gästebiografie (2 oder 3 Sätze), Links und erwähnte Ressourcen (nur echte aus dem Material oder vom Benutzer), Credits, Sponsor-Offenlegung, wenn es eine Werbung gab. 7. Social-Media-Beiträge: einer pro Plattform, die der Benutzer nennt, jeweils mit einem Zitat oder einer Erkenntnis. ### 4. Liefern Füllen Sie `templates/show-notes.md` aus und folgen Sie `references/show-notes-structure.md` und `references/chapters-and-platforms.md`. Folgen Sie dem Stil von `examples/example-rooftop-beekeeping-episode.md`. Fügen Sie eine kurze "Vor der Veröffentlichung prüfen"-Liste hinzu: geschätzte Zeiten, bearbeitete Zitate, Schreibweisen und alle Fakten oder Zahlen, die der Gast genannt hat und die verifiziert werden sollten. ## Regeln - Verwenden Sie nur Fakten, Namen, Zahlen und Links aus dem Transkript oder vom Benutzer; kennzeichnen Sie alles Unklare als [check]. - Zitate müssen die eigenen Worte des Sprechers sein; das Entfernen von "ähm" und "weißt du" ist in Ordnung, Umformulieren nicht. - Halten Sie Kapiteltitel beschreibend und ehrlich; kein Clickbait, das die Episode nicht liefert. - Respektieren Sie Gäste: Zitieren Sie keine privaten Bemerkungen, Off-the-Record-Momente oder alles, was der Benutzer als geschnitten markiert. - Passen Sie die Stimme der Show an; Standard ist warm, klar und spezifisch.