Communitygithub.com

youtube-summarizer

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

¿Qué es youtube-summarizer?

Esta habilidad permite a agentes de IA, como Claude Code, extraer transcripciones de videos de YouTube y generar resúmenes extensos y estructurados utilizando el marco STAR + R-I-S-E. Es ideal para desarrolladores, investigadores y estudiantes que necesitan analizar contenido educativo, tutoriales o conferencias sin tener que ver el video completo. La habilidad valida la URL del video, verifica la disponibilidad de la transcripción, la extrae usando la librería Python `youtube-transcript-api` y produce un documento Markdown detallado con secciones como resumen ejecutivo, desglose por temas, conceptos clave y conclusiones. Soporta múltiples formatos de URL de YouTube y prioriza la exhaustividad sobre la brevedad.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/sickn33/youtube-summarizer

Preguntar en tu IA favorita

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

Documentación

¿Qué hace 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 librería 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 exhaustivo del contenido y documentación de referencia de videos educativos, conferencias, tutoriales o contenido informativo.

Cuándo Usar Esta Habilidad

Esta habilidad debe utilizarse cuando:

  • El usuario proporciona una URL de YouTube y desea un resumen detallado
  • El usuario necesita documentar el contenido de un video como referencia sin tener que volver a verlo
  • El usuario desea extraer ideas, puntos clave y argumentos de contenido educativo
  • El usuario necesita transcripciones de videos de YouTube para su análisis
  • El usuario solicita "resumir", "sintetizar" o "extraer contenido" de videos de YouTube
  • El usuario desea 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 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 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 relleno, ░ 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:

╔══════════════════════════════════════════════════════════════╗
║     📹  YOUTUBE SUMMARIZER - 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 de 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 inválido"
    exit 1
fi

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

Si la URL no es vá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 agregada 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: 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 primero en el idioma preferido del usuario
    # 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é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:

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 completo
  3. Usar el modelo de IA (Claude/GPT) para generar el 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

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 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 de la Habilidad:**

⚠️ youtube-transcript-api no está instalado

Esta habilidad requiere la librería 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! Continuando con el resumen del video...

Ejemplo 4: URL Inválida

Entrada del Usuario:

claude> resume 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 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 sin procesar

✅ Archivo guardado: resumen-ejemplo123-2026-02-01.md (incluye transcripción sin procesar) [████████████████████] 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

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados