Communitygithub.com

Resumidor de YouTube

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

¿Qué es Resumidor de YouTube?

Esta habilidad está diseñada para extraer transcripciones de videos de YouTube y generar resúmenes exhaustivos 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 todas las ideas, argumentos y puntos clave. Es especialmente útil para analizar contenido educativo, conferencias, tutoriales o cualquier video informativo que requiera un análisis profundo y referencias documentadas, priorizando la integridad sobre la brevedad. Compatible con Claude Code y otras plataformas de agentes de IA que ejecutan comandos Python y shell. El flujo de trabajo incluye cinco pasos: validación de URL, verificación de disponibilidad del video y transcripción, extracción de la transcripción (con preferencia por portugués e inglés), generación del resumen estructurado y presentación del resultado en Markdown limpio. El usuario puede instalar la dependencia faltante directamente desde el flujo si es necesario.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/youtube-summarizer

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Resumidor de YouTube?

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 todas las ideas, argumentos y puntos clave.

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

Cuándo usar esta habilidad

Esta habilidad debe usarse cuando:

  • El usuario proporciona una URL 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 quiere extraer ideas, 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 documentación completa que priorice la integridad 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 instalar
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

Pautas 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 completado, ░ 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 actual/total (ej. "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 el ID del video usando regex o análisis de URL
URL="$URL_PROVIDED_BY_USER"

# 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 inválido"
    exit 1
fi

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

Si la URL es inválida:

❌ URL de YouTube invá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 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"Preguntar 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"Solicitar un video público

Paso 3: Extraer transcripción

Progreso:

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

Objetivo: Obtener 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
  • Conservar la puntuación y el formato cuando esté disponible
  • Eliminar segmentos duplicados o superpuestos (si son artefactos de generación automática)
  • Almacenar en 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
    • 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 destacados

Leer "$TRANSCRIPT_FILE"  # Leer la 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 clave]

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. Procediendo con el resumen del video...

Ejemplo 4: URL inválida

Entrada del usuario:

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

Respuesta de la habilidad:

❌ Formato de URL de YouTube invá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 proporciona 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 todo, 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 completado


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

## Limitaciones
- Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No consideres 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.

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

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.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

Skills relacionados