Communitygithub.com

Resumidor de YouTube (Summarizer)

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

¿Qué es Resumidor de YouTube (Summarizer)?

Esta habilidad (skill) está diseñada para extraer transcripciones de videos de YouTube y producir resúmenes extensos y estructurados utilizando el marco STAR + R-I-S-E. Es ideal para desarrolladores, estudiantes o profesionales que necesitan analizar contenido educativo, tutoriales o conferencias sin tener que volver a ver el video. La habilidad valida la disponibilidad del video, verifica que la transcripción sea accesible y la extrae mediante la biblioteca Python `youtube-transcript-api`. Luego, aplica un prompt de resumen potente para generar una salida en Markdown que incluye metadatos del video, un desglose detallado sección por sección, conceptos clave y terminología. Soporta múltiples formatos de URL de YouTube, maneja errores comunes como transcripciones deshabilitadas o videos privados, y ofrece la opción de guardar tanto el resumen como la transcripción cruda. La habilidad está optimizada para agentes de IA como Claude, Cursor o Codex, y sigue un flujo de trabajo paso a paso con indicadores de progreso visuales para mantener al usuario informado.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/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

Esta habilidad 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 usando la biblioteca Python youtube-transcript-api y produce documentación detallada que captura todos los conocimientos, argumentos y puntos clave.

La habilidad está diseñada para usuarios que necesitan un análisis exhaustivo del contenido y documentación de referencia de videos educativos, conferencias, tutoriales o contenido informativo.

Cuándo usar esta habilidad

Esta habilidad debe usarse cuando:

  • El usuario proporciona una URL de 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 para el seguimiento del progreso

A lo largo del flujo de trabajo, muestra un indicador de progreso visual 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 (por ejemplo, "Paso 3/5")
  • Breve descripción de la fase actual

Mostrar el cuadro de estado inicial antes del Paso 1:

╔══════════════════════════════════════════════════════════════╗
║     📹  RESUMIDOR 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 admitidos:

  • 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 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

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"Pide al usuario verificar 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 está generada automáticamente ni añadida manualmente)"No se puede continuar
Video privado/restringido"❌ El video es privado o está restringido"Pide 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 transcripción en 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 transcripción: {e}")
    exit(1)

Procesamiento de la transcripción:

  • Combinar todos los segmentos de la transcripción en un texto coherente
  • Conservar la puntuación y el formato cuando estén disponibles
  • Eliminar segmentos duplicados o superpuestos (si son artefactos de 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:

Utilizar 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 completo
  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
    • Conclusiones y puntos clave
    • 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 completa en Markdown
# 4. Estructurará con encabezados, listas y resaltados

Read "$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 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 de la habilidad:

⚠️  youtube-transcript-api no instalado

Esta habilidad requiere la biblioteca Python 'youtube-transcript-api'.

¿Deseas que la instale ahora?
- [ ] Sí - Instalar con pip
- [ ] No - Lo instalaré manualmente

El usuario selecciona "Sí":

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

✅ Instalación completa. Continuando 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 de la habilidad:

❌ 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

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 para principiantes y 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 original

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

¡Bienvenido a este tutorial completo sobre los fundamentos del 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

Limitaciones

  • Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de la validación específica del entorno, pruebas o revisión de expertos.
  • Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

Individual skills in this repo

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

AbobakrDiara61/railway-system

Best practices for Remotion - Video creation in React

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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