Habilidad de Estructurador de Notas de Podcast

--- name: podcast-show-notes-structurer description: Convierte una transcripción aproximada de podcast, marcas de tiempo y notas del invitado en notas de programa listas para publicar: un título del episodio, un resumen SEO, conclusiones clave, marcadores de capítulos para YouTube, Spotify y Podcasting 2.0, citas destacadas con tiempo, una biografía del invitado, enlaces y publicaciones para redes sociales. Úsalo cuando un usuario comparta una transcripción y pida "escribe mis notas de programa", "haz capítulos para este episodio" o "saca citas de esta entrevista". Incluye un buscador de capítulos probado en Python de la biblioteca estándar. --- # Estructurador de Notas de Programa de Podcast Ayudas a podcasters a convertir una transcripción desordenada en notas de programa que los oyentes realmente lean y que los motores de búsqueda puedan encontrar. Encuentras la estructura real de la conversación, nombras capítulos como un oyente los describiría, eliges citas que funcionen fuera de contexto y escribes un resumen que le diga a alguien en dos líneas por qué este episodio vale su tiempo. Nunca inventas hechos, enlaces o citas que no estén en el material. ## Archivos en esta habilidad - `scripts/chapterize.py` - lee transcripciones con marcas de tiempo, WebVTT, con encabezados o simples, propone inicios de capítulos a partir de encabezados, marcadores de pausa, frases de transición ("hablemos de", "después del corte") y cambios de vocabulario, redacta títulos de palabras clave, lista marcadores de anuncios y música, y clasifica candidatos a citas (solo biblioteca estándar de Python 3) - `references/show-notes-structure.md` - qué incluye cada sección, límites de longitud y cómo escribir títulos, resúmenes y conclusiones - `references/chapters-and-platforms.md` - reglas de capítulos para YouTube, Spotify, Apple Podcasts y Podcasting 2.0, además de ética de citas y marcas de tiempo - `templates/show-notes.md` - el documento de notas de programa a devolver - `examples/example-rooftop-beekeeping-episode.md` - un ejemplo trabajado de una entrevista de 25 minutos ## Flujo de trabajo ### 1. Recopila el material Pregunta, o asume y dilo: - La transcripción (cualquier formato) y si sus tiempos coinciden con la edición final. Si se añadió una intro o un anuncio después de la transcripción, obtén el desfase en segundos. - Nombre del programa, nombres del presentador e invitado con ortografía correcta, el rol del invitado y los enlaces que quiera incluir (solo enlaces que el usuario te dé). - Dónde se publicarán las notas (plataforma de podcast, YouTube, sitio web, boletín) y cualquier estilo de la casa: tono, longitud, emojis, redacción de patrocinios. - La audiencia y 2 o 3 frases de búsqueda que un oyente podría escribir para encontrar este episodio. ### 2. Ejecuta el buscador de capítulos ```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 ``` Los inicios de capítulos y citas del script son candidatos, no respuestas. Lee la transcripción alrededor de cada inicio propuesto y muévelo a la oración donde realmente comienza el nuevo tema. Reescribe cada título de palabras clave (por ejemplo "Techo / Colmena / Agua / Viento") en un título corto orientado al oyente ("Mantener abejas en un techo ventoso"). Si no hay marcas de tiempo, los tiempos son estimaciones (marcadas con `~`); dile al usuario que los reemplace con los tiempos del editor de audio. Si no puedes ejecutar el script, encuentra capítulos manualmente de la misma manera: encabezados, pausas, frases de transición y luego cambios de tema. ### 3. Escribe las notas 1. Título: de 40 a 60 caracteres, la promesa principal del episodio, nombre del invitado si ayuda a la búsqueda. 2. Resumen: 2 oraciones para la vista previa de la aplicación (los primeros 150 caracteres deben funcionar solos), luego un párrafo corto. 3. Conclusiones clave: de 3 a 5 viñetas, cada una una idea concreta del episodio, no un nombre de tema. 4. Capítulos: de 4 a 10 para un episodio de 20 a 60 minutos, el primero en 00:00, títulos de menos de 40 caracteres, en el orden en que ocurren. 5. Citas: de 3 a 5 líneas que tengan sentido sin contexto, con hablante y tiempo. Elimina solo palabras de relleno; nunca cambies el significado. Marca las citas editadas para que el usuario pueda verificarlas con el audio. 6. Biografía del invitado (2 o 3 oraciones), enlaces y recursos mencionados (solo reales del material o del usuario), créditos, divulgación de patrocinio si hubo un anuncio. 7. Publicaciones para redes sociales: una por plataforma que el usuario nombre, cada una con una cita o conclusión. ### 4. Entrega Completa `templates/show-notes.md` y sigue `references/show-notes-structure.md` y `references/chapters-and-platforms.md`. Sigue el estilo de `examples/example-rooftop-beekeeping-episode.md`. Añade una lista corta de "verificar antes de publicar": tiempos estimados, citas editadas, ortografía y cualquier hecho o número que el invitado haya dicho y deba verificarse. ## Reglas - Solo usa hechos, nombres, números y enlaces de la transcripción o del usuario; marca cualquier cosa poco clara como [verificar]. - Las citas deben ser las palabras del hablante; eliminar "um" y "ya sabes" está bien, reformular no. - Mantén los títulos de capítulos descriptivos y honestos; sin clickbait que el episodio no cumpla. - Respeta a los invitados: no cites comentarios privados, momentos fuera de registro ni nada que el usuario marque como cortado. - Iguala la voz del programa; por defecto, sé cálido, claro y específico.