Communitygithub.com

BEKO2210/Firstbrain

Extrae transcripciones de videos de YouTube y genera resúmenes detallados y completos utilizando marcos de análisis inteligentes.

¿Qué es Firstbrain?

Este skill permite extraer la transcripción de cualquier video de YouTube y generar un resumen estructurado y exhaustivo utilizando el marco STAR + R-I-S-E. Está diseñado para profesionales y estudiantes que necesitan analizar contenido educativo, tutoriales o conferencias sin tener que volver a ver el video. El skill verifica la disponibilidad del video, extrae la transcripción mediante la biblioteca Python `youtube-transcript-api` y aplica un prompt de resumen avanzado para producir documentación detallada con secciones, conceptos clave y referencias. Es compatible con Claude Code, Cursor y Codex, y se activa mediante comandos como "resume este video" o "extrae el contenido de este video de YouTube". Su flujo de trabajo guiado incluye validación de URL, verificación de disponibilidad, extracción de transcripción, generación del resumen y formato de salida en Markdown limpio y bien estructurado.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/youtube-summarizer

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

youtube-summarizer

Propósito

Este skill extrae transcripciones de videos de YouTube y genera resúmenes completos y detallados utilizando el marco STAR + R-I-S-E. Valida la disponibilidad del video, extrae la transcripción mediante la biblioteca Python youtube-transcript-api y produce documentación detallada que captura todos los conocimientos, argumentos y puntos clave.

El skill está diseñado para usuarios que necesitan un análisis exhaustivo del contenido y documentación de referencia a partir de videos educativos, conferencias, tutoriales o contenido informativo.

Cuándo usar este skill

Este skill debe usarse cuando:

  • El usuario proporciona una URL de un video de YouTube y desea un resumen detallado.
  • El usuario necesita documentar el contenido del video para consultarlo sin tener que volver a verlo.
  • El usuario desea extraer conocimientos, puntos clave y argumentos de contenido educativo.
  • El usuario necesita transcripciones de videos de YouTube para su análisis.
  • El usuario pide "resumir", "sintetizar" o "extraer contenido" de videos de YouTube.
  • El usuario desea una documentación completa que priorice la exhaustividad sobre la brevedad.

Paso 0: Descubrimiento y configuración

Antes de procesar videos, valida el entorno y las dependencias:

# Verificar si youtube-transcript-api está instalado
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
    echo "⚠️  youtube-transcript-api no encontrado"
    # Ofrecer instalación
fi

# Verificar disponibilidad de Python
if ! command -v python3 &>/dev/null; then
    echo "❌ Python 3 es necesario pero no está instalado"
    exit 1
fi

Preguntar al usuario si falta la dependencia:

youtube-transcript-api es necesario pero no está instalado.

¿Deseas instalarlo ahora?
- [ ] Sí - Instalar con pip (pip install youtube-transcript-api)
- [ ] No - Lo instalaré manualmente

Si el usuario selecciona "Sí":

pip install youtube-transcript-api

Verificar la instalación:

python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api instalado correctamente')"

Flujo de trabajo principal

Directrices de seguimiento del progreso

A lo largo del flujo de trabajo, muestra un indicador visual de progreso antes de cada paso para mantener informado al usuario. El formato del indicador es:

echo "[████░░░░░░░░░░░░░░░░] 20% - Paso 1/5: Validando URL"

Especificaciones de formato:

  • 20 caracteres de ancho (usa █ para lleno, ░ para vacío)
  • Incrementos de porcentaje: Paso 1=20%, Paso 2=40%, Paso 3=60%, Paso 4=80%, Paso 5=100%
  • Contador de pasos que muestra el actual/total (ej., "Paso 3/5")
  • Breve descripción de la fase actual

Mostrar el cuadro de estado inicial antes del Paso 1:

╔══════════════════════════════════════════════════════════════╗
║     📹  RESUMEN DE YOUTUBE - Procesando video               ║
╠══════════════════════════════════════════════════════════════╣
║ → Paso 1: Validando URL                 [EN PROGRESO]       ║
║ ○ Paso 2: Verificando disponibilidad                        ║
║ ○ Paso 3: Extrayendo transcripción                          ║
║ ○ Paso 4: Generando resumen                                 ║
║ ○ Paso 5: Formateando salida                                ║
╠══════════════════════════════════════════════════════════════╣
║ Progreso: ██████░░░░░░░░░░░░░░░░░░░░░░░░  20%               ║
╚══════════════════════════════════════════════════════════════╝

Paso 1: Validar URL de YouTube

Objetivo: Extraer el ID del video y validar el formato de la URL.

Formatos de URL compatibles:

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://m.youtube.com/watch?v=VIDEO_ID

Acciones:

# Extraer el ID del video usando expresiones regulares o análisis de URL
URL="$USER_PROVIDED_URL"

# Patrón 1: youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# Patrón 2: youtu.be/VIDEO_ID  
elif echo "$URL" | grep -qE 'youtu\.be/'; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
    echo "❌ Formato de URL de YouTube no válido"
    exit 1
fi

echo "📹 ID del video extraído: $VIDEO_ID"

Si la URL no es válida:

❌ URL de YouTube no válida

Por favor, proporciona una URL de YouTube válida en uno de estos formatos:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

Ejemplo: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Paso 2: Verificar disponibilidad del video y la transcripción

Progreso:

echo "[████████░░░░░░░░░░░░] 40% - Paso 2/5: Verificando disponibilidad"

Objetivo: Verificar que el video existe y que la transcripción es accesible.

Acciones:

from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys

video_id = sys.argv[1]

try:
    # Obtener lista de transcripciones disponibles
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print(f"✅ Video accesible: {video_id}")
    print("📝 Transcripciones disponibles:")
    
    for transcript in transcript_list:
        print(f"  - {transcript.language} ({transcript.language_code})")
        if transcript.is_generated:
            print("    [Generada automáticamente]")
    
except TranscriptsDisabled:
    print(f"❌ Las transcripciones están deshabilitadas para el video {video_id}")
    sys.exit(1)
    
except NoTranscriptFound:
    print(f"❌ No se encontró transcripción para el video {video_id}")
    sys.exit(1)
    
except Exception as e:
    print(f"❌ Error al acceder al video: {e}")
    sys.exit(1)

Manejo de errores:

ErrorMensajeAcción
Video no encontrado"❌ El video no existe o es privado"Pedir al usuario que verifique la URL
Transcripciones deshabilitadas"❌ Las transcripciones están deshabilitadas para este video"No se puede continuar
No hay transcripción disponible"❌ No se encontró transcripción (no generada automáticamente ni añadida manualmente)"No se puede continuar
Video privado/restringido"❌ El video es privado o está restringido"Pedir un video público

Paso 3: Extraer transcripción

Progreso:

echo "[████████████░░░░░░░░] 60% - Paso 3/5: Extrayendo transcripción"

Objetivo: Recuperar la transcripción en el idioma preferido.

Acciones:

from youtube_transcript_api import YouTubeTranscriptApi

video_id = "VIDEO_ID"

try:
    # Intentar obtener la transcripción en el idioma preferido del usuario primero
    # Recurrir al inglés si no está disponible
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id, 
        languages=['pt', 'en']  # Preferir portugués, recurrir al inglés
    )
    
    # Combinar segmentos de la transcripción en un texto completo
    full_text = " ".join([entry['text'] for entry in transcript])
    
    # Obtener metadatos del video
    from youtube_transcript_api import YouTubeTranscriptApi
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print("✅ Transcripción extraída correctamente")
    print(f"📊 Longitud de la transcripción: {len(full_text)} caracteres")
    
    # Guardar en archivo temporal para procesamiento
    with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
        f.write(full_text)
    
except Exception as e:
    print(f"❌ Error al extraer la transcripción: {e}")
    exit(1)

Procesamiento de la transcripción:

  • Combinar todos los segmentos de la transcripción en un texto coherente
  • Preservar la puntuación y el formato cuando esté disponible
  • Eliminar segmentos duplicados o superpuestos (si son artefactos de la generación automática)
  • Almacenar en un archivo temporal para su análisis

Paso 4: Generar resumen completo

Progreso:

echo "[████████████████░░░░] 80% - Paso 4/5: Generando resumen"

Objetivo: Aplicar el prompt mejorado STAR + R-I-S-E para crear un resumen detallado.

Prompt aplicado:

Usar el prompt mejorado de la Fase 2 (marco STAR + R-I-S-E) con la transcripción extraída como entrada.

Acciones:

  1. Cargar el texto completo de la transcripción
  2. Aplicar el prompt de resumen exhaustivo
  3. Usar el modelo de IA (Claude/GPT) para generar un resumen estructurado
  4. Asegurar que la salida siga la estructura definida:
    • Encabezado con metadatos del video
    • Síntesis ejecutiva
    • Desglose detallado sección por sección
    • Ideas clave y conclusiones
    • Conceptos y terminología
    • Recursos y referencias

Implementación:

# Usar el archivo de transcripción como entrada para el prompt de IA
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"

# El agente de IA:
# 1. Leerá la transcripción
# 2. Aplicará el marco de resumen STAR + R-I-S-E
# 3. Generará una salida Markdown completa
# 4. Estructurará con encabezados, listas y resaltados

Leer "$TRANSCRIPT_FILE"  # Leer transcripción en el contexto

Luego aplicar el prompt de resumen completo (de la versión mejorada en la Fase 2).

Paso 5: Formatear y presentar la salida

Progreso:

echo "[████████████████████] 100% - Paso 5/5: Formateando salida"

Objetivo: Entregar el resumen en Markdown limpio y bien estructurado.

Estructura de la salida:

# [Título del video]

**Canal:** [Nombre del canal]  
**Duración:** [Duración]  
**URL:** [https://youtube.com/watch?v=VIDEO_ID]  
**Fecha de publicación:** [Fecha si está disponible]


## 📝 Resumen detallado

### [Tema 1]

[Explicación completa con ejemplos, datos, citas...]

#### [Subtema 1.1]

[Desglose detallado...]

### [Tema 2]

[Análisis detallado continuado...]


## 📚 Conceptos y terminología

- **[Término 1]:** [Definición y contexto]
- **[Término 2]:** [Definición y contexto]


## 📌 Conclusión

[Síntesis final y conclusiones]


### **Ejemplo 2: Dependencia faltante**

**Entrada del usuario:**

claude> resume este video de youtube https://youtu.be/abc123


**Respuesta del skill:**

⚠️ youtube-transcript-api no instalado

Este skill requiere la biblioteca Python 'youtube-transcript-api'.

¿Deseas que la instale ahora?

  • Sí - Instalar con pip
  • No - Lo instalaré manualmente

**El usuario selecciona "Sí":**

```bash
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1

✅ Instalación completa. Procediendo con el resumen del video...

Ejemplo 4: URL no válida

Entrada del usuario:

claude> resume el video de youtube www.youtube.com/some-video

Respuesta del skill:

❌ Formato de URL de YouTube no válido

Ejemplos de formato esperado:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

Por favor, proporciona una URL de video de YouTube válida.

📊 Resumen ejecutivo

Este video ofrece una introducción completa a los conceptos fundamentales de la Inteligencia Artificial (IA), diseñada tanto para principiantes como para profesionales que desean comprender los fundamentos técnicos y las aplicaciones prácticas de la IA moderna. El instructor cubre desde definiciones básicas hasta algoritmos de aprendizaje automático, utilizando ejemplos prácticos y visualizaciones para facilitar la comprensión.

[... resumen detallado continuado ...]


**Opciones de guardado:**

¿Qué te gustaría guardar? → Resumen + transcripción sin procesar

✅ Archivo guardado: resumen-ejemplo123-2026-02-01.md (incluye transcripción sin procesar) [████████████████████] 100% - ✓ ¡Procesamiento completo!



Bienvenido a este tutorial completo sobre fundamentos de aprendizaje automático. En el video de hoy, exploraremos los conceptos centrales que impulsan los sistemas modernos de IA...

Versión: 1.2.0 Última actualización: 2026-02-02 Mantenido por: Eric Andrade

Conexiones

  • Dominio: [[Design & Kreativitaet]]
  • Categoría: [[Video & Audio Produktion]]
  • Archivos:
    • scripts/extract-transcript.py
    • scripts/install-dependencies.sh
  • Navegación: [[Skills Übersicht]], [[Home]]

Individual skills in this repo

This repo contains 18 individual skills — each has its own dedicated page.

BEKO2210/Firstbrain

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

BEKO2210/Firstbrain

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

BEKO2210/Firstbrain

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

BEKO2210/Firstbrain

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

BEKO2210/Firstbrain

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

BEKO2210/Firstbrain

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

BEKO2210/Firstbrain

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

BEKO2210/Firstbrain

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

BEKO2210/Firstbrain

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

BEKO2210/Firstbrain

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Skills relacionados