Communitygithub.com

daymade/claude-code-skills

Descarga videos de YouTube y transmisiones HLS (m3u8) de plataformas como Mux, Vimeo, etc., usando yt-dlp y ffmpeg. Usa esta habilidad cuando los usuarios soliciten descargar videos, extraer audio, manejar transmisiones protegidas con encabezados de autenticación o solucionar problemas de descarga como fallos de extracción nsig, errores 403 o problemas con cookies.

¿Qué es claude-code-skills?

Esta habilidad para agentes de IA (como Claude Code, Cursor, Codex, etc.) proporciona una interfaz unificada para descargar videos y audio de YouTube y plataformas de transmisión HLS (Mux, Vimeo, etc.) utilizando yt-dlp y ffmpeg. Está diseñada para ofrecer una experiencia sencilla para usuarios no técnicos, manejando automáticamente la autenticación, los tokens PO, las cookies del navegador y la resolución de problemas comunes. El agente ejecuta todos los comandos por sí mismo, guiando al usuario con opciones claras en lenguaje natural y proporcionando retroalimentación visual, como la miniatura del video. Para casos avanzados, incluye un flujo de trabajo detallado de calidad alta (hasta 4K) con instalación de proveedores de tokens PO y métodos alternativos usando cookies del navegador. Además, ofrece scripts auxiliares como `scripts/download_video.py` que automatizan la configuración del proveedor de tokens PO y permiten opciones como selección de formato, descarga de subtítulos y conversión a MP4.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/daymade/claude-code-skills/tree/HEAD/youtube-downloader

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

Thumbnail
Thumbnail

Documentación

YouTube Downloader

Descripción general

Permite descargas confiables de video y audio desde YouTube y plataformas de transmisión HLS (Mux, Vimeo, etc.) usando yt-dlp y ffmpeg. Esta habilidad proporciona flujos de trabajo para:

  • Descargas de YouTube (hasta 4K) usando proveedores de tokens PO o cookies del navegador
  • Descargas de transmisiones HLS con encabezados de autenticación
  • Manejo de contenido protegido y solución de problemas comunes de descarga

Experiencia de usuario no técnico (predeterminado)

Asume que el usuario no es técnico. No le pidas que ejecute comandos. Ejecuta todo tú mismo e informa el progreso en lenguaje sencillo. Evita mencionar herramientas a menos que el usuario lo pregunte.

Flujo predeterminado:

  1. Pide la URL (si no se proporcionó).
  2. Obtén los metadatos del video (título/subidor/duración/miniatura) y confirma que coinciden con la intención del usuario.
    • Si yt-dlp está bloqueado por "confirma que no eres un bot", recurre a YouTube oEmbed para título/subidor/miniatura (la duración puede ser desconocida).
  3. Ofrece opciones simples (video solo o solo audio, calidad, subtítulos, ubicación de guardado).
  4. Continúa con valores predeterminados sensatos si el usuario no especifica:
    • Descarga de video en la mejor calidad
    • Salida MP4 combinada
    • Video individual solamente (sin listas de reproducción)
  5. Descarga e informa la ruta final del archivo, el tamaño del archivo y la resolución (si es video).

Ofrece opciones en términos amigables para el usuario:

  • "Descargar el video en la mejor calidad (predeterminado)"
  • "Descargar solo el audio (MP3)"
  • "Elegir una calidad: 1080p / 720p / 480p / 360p"
  • "Incluir subtítulos (si están disponibles)"
  • "Guardar en la carpeta de Descargas (predeterminado) o dime otra carpeta"

Siempre muestra la miniatura cuando esté disponible:

  • Si los metadatos incluyen una URL de miniatura, inclúyela usando la sintaxis de imagen Markdown: ![Thumbnail](URL).

Pregunta antes de hacer trabajo adicional:

  • Confirma las descargas de listas de reproducción (pueden ser grandes).
  • Confirma la instalación/actualización de dependencias si faltan.
  • Pregunta antes de extraer cookies del navegador.
  • Si se usan cookies, nunca menciones el recuento de cookies ni los detalles de cookies sin procesar en las respuestas al usuario. Di "usé tu sesión de inicio de sesión de Chrome".
  • Si se requiere verificación, configura automáticamente un ayudante de token PO local (sin acciones del usuario). Si Docker falta o falla, no intentes instalar Docker; cambia al proveedor de token PO basado en navegador.

Recordatorio legal/seguridad (breve):

  • Continúa solo si el usuario tiene los derechos o permiso para descargar el contenido.

Plantilla de respuesta (usa lenguaje sencillo, sin comandos):

![Thumbnail](URL_THUMBNAIL)

Título: …
Canal: …
Duración: …

Puedo ayudarte a:
1) Descargar el video (mejor calidad, MP4)
2) Descargar solo el audio (MP3)
3) Elegir una calidad específica (1080p/720p/480p/360p)
4) Incluir subtítulos (si están disponibles)

¿Dónde debería guardarlo? (Predeterminado: carpeta de Descargas)

Si el usuario dice "solo descarga":

  • Continúa con los valores predeterminados y confirma cuando finalice la descarga.
    • Si está bloqueado por un 403, configura automáticamente el ayudante de verificación y reintenta.

SOP de descarga confiable (Interno)

Sigue este SOP para evitar errores y confusiones comunes:

  1. Pon entre comillas las URL en los comandos de shell (zsh trata ? como un comodín). Ejemplo: 'https://www.youtube.com/watch?v=VIDEO_ID'.
  2. Asegúrate de que el proxy esté activo tanto para yt-dlp como para los proveedores de tokens PO (HTTP_PROXY/HTTPS_PROXY/ALL_PROXY).
  3. Si ves "Inicia sesión para confirmar que no eres un bot", solicita permiso y usa cookies del navegador. No continúes sin cookies.
  4. Inicia un proveedor de token PO antes de descargar (falla rápido si no puede iniciarse).
    • Usa el proveedor Docker bgutil cuando esté disponible.
    • Si Docker falta o falla, cambia al proveedor WPC basado en navegador.
  5. Si se usan cookies, prefiere el cliente web_safari. De lo contrario, prefiere mweb para tokens PO.
  6. Mantén la ventana del navegador abierta mientras WPC genera tokens. Asegúrate de que Chrome pueda llegar a YouTube a través del mismo proxy.
  7. Si obtienes "Solo imágenes disponibles" o "El formato solicitado no está disponible", trátalo como un fallo de token PO y reintenta después de corregir el estado del proveedor/navegador.
  8. Si obtienes errores SSL EOF o de fragmentos, trátalos como un problema de proxy/red. Reintenta con formatos progresivos y/o un mejor proxy.

Lista de verificación de ejecución del agente (Interno)

  • Ejecuta scripts/download_video.py URL --info (agrega --cookies-from-browser chrome si se concede permiso) para obtener metadatos y miniatura.
  • Si los metadatos de yt-dlp fallan, confía en la alternativa oEmbed del script para título/subidor/miniatura y ten en cuenta que la duración puede no estar disponible.
  • Si hay una URL de miniatura, muéstrala en la respuesta con sintaxis de imagen Markdown.
  • Pide al usuario que elija entre video y solo audio y (opcionalmente) un preajuste de calidad.
  • Usa una ubicación de guardado predeterminada amigable (carpeta de Descargas) a menos que el usuario especifique una carpeta.
  • Para subtítulos, ejecuta con --subtitles y el --sub-lang solicitado.
  • Después de la descarga, informa el nombre del archivo, el tamaño y la resolución (si es video) en lenguaje sencillo.
  • Si la descarga falla con errores 403/de fragmentos, reintenta una vez con formatos progresivos no m3u8.
  • Si aparece "Inicia sesión para confirmar que no eres un bot", solicita acceso a las cookies y reintenta con cookies + web_safari.
  • Si aparece "Solo imágenes disponibles", trátalo como un fallo de token PO y reintenta después de corregir el estado del proveedor/navegador.
  • Inicia el proveedor de token PO antes de las descargas (--auto-po-token predeterminado). Falla rápido si no puede iniciarse.
  • Si el proveedor basado en Docker falla (común en China), recurre automáticamente al proveedor WPC basado en navegador (puede abrir brevemente una ventana del navegador).
  • Si se usa el proveedor WPC, mantén la ventana del navegador abierta hasta que comience la descarga. Si el navegador no se inicia, establece la ruta de Chrome explícitamente.
  • Si el proveedor de token PO se agota, reinícialo una vez y reintenta.
  • Si hay un proxy de sistema configurado, pásalo al contenedor del proveedor. Si el proxy apunta a 127.0.0.1/localhost, reescríbelo a host.docker.internal para Docker.

Cuándo usar esta habilidad

Esta habilidad debe invocarse cuando los usuarios:

  • Soliciten descargar videos o listas de reproducción de YouTube
  • Quieran extraer audio de videos de YouTube
  • Experimenten fallos de descarga de yt-dlp o disponibilidad limitada de formatos
  • Necesiten ayuda con la selección de formato o opciones de calidad
  • Reporten que solo hay formatos de baja calidad (360p) disponibles
  • Pregunten sobre cómo descargar contenido de YouTube en una calidad específica (1080p, 4K, etc.)
  • Necesiten convertir videos WebM descargados a formato MP4 para una mayor compatibilidad
  • Soliciten descargar transmisiones HLS (m3u8) de plataformas como Mux, Vimeo u otros servicios de transmisión
  • Necesiten descargar transmisiones protegidas que requieran encabezados de autenticación

Prerrequisitos

1. Verificar la instalación de yt-dlp (Ejecuta esto tú mismo)

which yt-dlp
yt-dlp --version

Si no está instalado o está desactualizado (< 2025.10.22):

brew upgrade yt-dlp  # macOS
# o
pip install --upgrade yt-dlp  # Multiplataforma

Crítico: Las versiones desactualizadas de yt-dlp causan fallos de extracción nsig y formatos faltantes.

2. Verificar el acceso de calidad actual (Ejecuta esto tú mismo)

Antes de descargar, verifica los formatos disponibles:

yt-dlp -F "https://youtu.be/VIDEO_ID"

Si solo aparece el formato 18 (360p): Se necesita la configuración del proveedor de token PO para acceso de alta calidad.

Flujo de trabajo de descarga de alta calidad

Paso 1: Instalar el proveedor de token PO (Configuración única)

Para acceso a 1080p/1440p/4K, instala un complemento de proveedor de token PO en el entorno Python de yt-dlp:

# Encuentra la ruta de Python de yt-dlp (intérprete utilizado por yt-dlp)
head -1 $(which yt-dlp)

# Instala el complemento usando el intérprete de la línea anterior
<YTDLP_PYTHON> -m pip install bgutil-ytdlp-pot-provider

Verificación: Ejecuta yt-dlp -F "URL_VIDEO" nuevamente. Busca los formatos 137 (1080p), 271 (1440p) o 313 (4K).

Consulta references/po-token-setup.md para obtener instrucciones detalladas de configuración y solución de problemas.

Paso 2: Descargar con la mejor calidad

Una vez instalado el proveedor de token PO:

# Descargar la mejor calidad hasta 1080p
yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "URL_VIDEO"

# Descargar la mejor calidad disponible (4K si está disponible)
yt-dlp -f "bestvideo+bestaudio/best" "URL_VIDEO"

Paso 3: Verificar la calidad de la descarga

# Verificar la resolución del video
ffprobe -v error -select_streams v:0 -show_entries stream=width,height,codec_name -of default=noprint_wrappers=1 video.mp4

Salida esperada para 1080p:

codec_name=vp9
width=1920
height=1080

Alternativa: Método de cookies del navegador

Si la configuración del proveedor de token PO es problemática, usa cookies del navegador:

# Firefox
yt-dlp --cookies-from-browser firefox -f "bestvideo[height<=1080]+bestaudio/best" "URL_VIDEO"

# Chrome
yt-dlp --cookies-from-browser chrome -f "bestvideo[height<=1080]+bestaudio/best" "URL_VIDEO"

Beneficios: Acceso a contenido restringido por edad y solo para miembros. Requisitos:

  • Debes haber iniciado sesión en YouTube en el navegador especificado.
  • El navegador y yt-dlp deben usar la misma IP/proxy.
  • No uses el cliente Android con cookies (el cliente Android no admite cookies).

Tareas comunes

Descarga solo de audio (Ejecuta esto tú mismo)

Extraer audio como MP3:

yt-dlp -x --audio-format mp3 "URL_VIDEO"

Directorio de salida personalizado (Ejecuta esto tú mismo)

yt-dlp -P ~/Downloads/YouTube "URL_VIDEO"

Descarga con subtítulos (Ejecuta esto tú mismo)

yt-dlp --write-subs --sub-lang en "URL_VIDEO"

Descarga de lista de reproducción (Ejecuta esto tú mismo)

yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "URL_PLAYLIST"

Convertir WebM a MP4 (Ejecuta esto tú mismo)

Las descargas de alta calidad de YouTube a menudo usan formato WebM (códec VP9). Conviértelo a MP4 para una mayor compatibilidad:

# Verificar si ffmpeg está instalado
which ffmpeg || brew install ffmpeg  # macOS

# Convertir WebM a MP4 con buena configuración de calidad
ffmpeg -i "video.webm" -c:v libx264 -preset medium -crf 23 -c:a aac -b:a 128k "video.mp4"

Parámetros explicados:

  • -c:v libx264: Usa el códec de video H.264 (ampliamente compatible)
  • -preset medium: Equilibrio entre velocidad de codificación y tamaño de archivo
  • -crf 23: Factor de tasa constante para calidad (rango 18-28, menor = mejor calidad)
  • -c:a aac: Usa el códec de audio AAC
  • -b:a 128k: Tasa de bits de audio 128 kbps

Consejo: La conversión mantiene la resolución 1080p y proporciona una velocidad de codificación ~6 veces mayor en hardware moderno.

Referencia rápida de solución de problemas

Solo disponible 360p (Formato 18)

Causa: Falta el proveedor de token PO o yt-dlp desactualizado.

Solución:

  1. Actualiza yt-dlp: brew upgrade yt-dlp
  2. Instala el proveedor de token PO (ver Paso 1 arriba)
  3. O usa el método de cookies del navegador

Inicia sesión para confirmar que no eres un bot

Causa: YouTube requiere autenticación para continuar.

Solución:

  1. Solicita permiso y usa cookies del navegador (--cookies-from-browser chrome).
  2. Asegúrate de que el navegador y yt-dlp usen la misma IP/proxy.
  3. Reintenta con el cliente web_safari si es necesario.

Solo imágenes disponibles / El formato solicitado no está disponible

Causa: Los tokens PO no se aplicaron o falló la verificación del proveedor/navegador.

Solución:

  1. Verifica que el proveedor de token PO se esté ejecutando antes de la descarga.
  2. Mantén la ventana del navegador abierta si se usa WPC.
  3. Si se usan cookies, prefiere el cliente web_safari y reintenta.

Fallo de extracción nsig

Síntomas:

ADVERTENCIA: [youtube] falló la extracción nsig: algunos formatos pueden faltar

Solución:

  1. Actualiza yt-dlp a la última versión
  2. Instala el proveedor de token PO
  3. Si aún falla y los tokens PO están deshabilitados, usa el cliente Android: yt-dlp --extractor-args "youtube:player_client=android" "URL_VIDEO"

Errores SSL EOF / de fragmentos

Causa: Inestabilidad del proxy o la red.

Solución:

  1. Reintenta con formatos progresivos (no m3u8).
  2. Cambia a un proxy/nodo más estable.
  3. Evita cerrar la ventana del navegador de token PO durante la descarga.

Descargas lentas o errores de red

Para usuarios en China o detrás de proxies restrictivos:

  • Las descargas pueden ser lentas debido a las condiciones de la red
  • Permite suficiente tiempo para completar
  • yt-dlp reintenta automáticamente en fallos transitorios

Advertencia de token PO (Inofensiva)

ADVERTENCIA: los formatos https del cliente Android requieren un token PO GVS

Acción: Ignórala si la descarga se realiza correctamente. Esto indica que el cliente Android tiene acceso limitado a formatos sin tokens PO.

Referencia de script incluido

scripts/download_video.py

Usa este envoltorio conveniente para iniciar automáticamente un proveedor de token PO de forma predeterminada para descargas de alta calidad. Úsalo tú mismo e informa los resultados al usuario sin pedirle que ejecute comandos.

Uso básico:

scripts/download_video.py "URL_VIDEO"

Argumentos:

  • url - URL del video de YouTube (obligatorio)
  • -o, --output-dir - Directorio de salida
  • --output-template - Plantilla de nombre de archivo de salida (sintaxis de yt-dlp)
  • -f, --format - Especificación de formato
  • -q, --quality - Preajuste de calidad (best, 1080p, 720p, 480p, 360p, worst). Predeterminado: best (omitido para --audio-only)
  • -a, --audio-only - Extraer audio como MP3
  • --subtitles - Descargar subtítulos si están disponibles
  • --sub-lang - Idiomas de subtítulos (separados por comas, predeterminado: en)
  • --cookies-from-browser - Cargar cookies desde un navegador (ej., chrome, firefox)
  • --cookies-file - Cargar cookies desde un archivo cookies.txt
  • --player-client - Usar un cliente de reproductor de YouTube específico (ej., web_safari)
  • --auto-po-token - Iniciar automáticamente el proveedor de token PO (predeterminado; usa Docker si está disponible, de lo contrario cambia al proveedor basado en navegador)
  • --no-auto-po-token - Deshabilitar la configuración automática de token PO
  • --proxy - URL del proxy para yt-dlp y el proveedor de token PO (ej., http://127.0.0.1:1082)
  • --wpc-browser-path - Ruta del ejecutable del navegador para el proveedor WPC
  • -F, --list-formats - Listar formatos disponibles
  • --merge-format - Contenedor de salida combinado (ej., mp4, mkv). Predeterminado: mp4
  • --playlist - Permitir descargas de listas de reproducción (predeterminado: solo video individual)
  • --info - Imprimir título/subidor/duración/miniatura y salir
  • --no-android-client - Deshabilitar la alternativa del cliente Android

Nota: Usa el cliente Android solo cuando los tokens PO estén deshabilitados. Mantén los tokens PO habilitados para alta calidad.

Expectativas de calidad

Configuración360p720p1080p1440p4K
Token PO automático (predeterminado)✓✓✓✓✓
Solo cliente Android✓✗✗✗✗
Proveedor de token PO (manual)✓✓✓✓✓
Cookies del navegador✓✓✓✓✓

Individual skills in this repo

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

daymade/claude-code-skills

>- Generates Chinese/Japanese speech with StepFun's Contextual TTS — default stepaudio-2.5-tts, stepaudio-3-tts for whisper/inline-() prosody. Replaces step-tts-2's voice_label with natural-language instruction. Use for emotional/prosody-controlled synthesis, batch voice lines, migrating from step-tts-2, or cloned voices (2.5/step-tts-2, not v3). Triggers on 阶跃 TTS, 语音合成, 配音. Not for transcription (use stepfun-asr).

daymade/claude-code-skills

This skill should be used when comparing two videos to analyze compression results or quality differences. Generates interactive HTML reports with quality metrics (PSNR, SSIM) and frame-by-frame visual comparisons. Triggers when users mention "compare videos", "video quality", "compression analysis", "before/after compression", or request quality assessment of compressed videos.

daymade/local-conversation-history

Entry point for local AI conversation history across providers. Routes a request to the one skill that owns it, by platform (Claude Code, OpenAI Codex, Kimi CLI) and action (read evidence vs continue interrupted work), and owns the one job none of them own alone: a single inventory spanning all three providers. Use when the provider is unknown or plural ("our history", "what have I been working on", "which chats did I have"), when the user wants Kimi CLI history at all, when it is unclear whether they need evidence or resumption, or when they ask for this skill by name. Vague recall that names no platform ("we discussed this once, when was it?") belongs here rather than to a single-provider reader, because a Claude-only answer to an unscoped question cannot support an absence claim. When the platform and the action are both already clear, load that executor skill directly instead — except Kimi CLI, which has no reader or continuation skill of its own and always routes through here.

daymade/ppt-creator

Create professional slide decks from topics or documents. Generates structured content with data-driven charts, speaker notes, and complete PPTX files. Applies persuasive storytelling principles (Pyramid Principle, assertion-evidence). Supports multiple formats (Marp, PowerPoint). Use for presentations, pitches, slide decks, or keynotes.

daymade/prompt-optimizer

Transform vague prompts into precise, well-structured specifications using EARS (Easy Approach to Requirements Syntax) methodology. This skill should be used when users provide loose requirements, ambiguous feature descriptions, or need to enhance prompts for AI-generated code, products, or documents. Triggers include requests to "optimize my prompt", "improve this requirement", "make this more specific", or when raw requirements lack detail and structure.

daymade/qa-expert

This skill should be used when establishing comprehensive QA testing processes for any software project. Use when creating test strategies, writing test cases following Google Testing Standards, executing test plans, tracking bugs with P0-P4 classification, calculating quality metrics, or generating progress reports. Includes autonomous execution capability via master prompts and complete documentation templates for third-party QA team handoffs. Implements OWASP security testing and achieves 90% coverage targets.

daymade/read-claude-code-history

Reads, searches, and exports local Claude Code history without resuming work. Covers recent session inventory, exact session timelines, verbatim human input including queued mid-turn prompts, full-event keyword search, hybrid recall when wording changed, end-state triage, and deleted-file recovery across active Claude homes plus registered archives. Use whenever the user asks what they or Claude said, wants a Claude Code session ID or original context, remembers prior work vaguely, needs an old file from a transcript, or must prove what a Claude session contained before continuing it. Also owns the only Kimi CLI surface, via its Kimi inventory and search flags. For Codex history use read-codex-history; when the request names no platform at all or spans providers, start at local-conversation-history.

daymade/read-codex-history

Reads, searches, and exports local OpenAI Codex history without continuing the old task. Lists recent Codex sessions, extracts exact prompt-ledger inputs by Session, locates a rollout by verified session_meta identity, reconstructs one chronological user/assistant timeline with fork and compaction lineage, and performs bounded keyword search across live and archived rollouts. Use whenever the user asks what they told Codex, wants recent original inputs, a Codex Session ID, full prior context, fork ancestry, or evidence of what a Codex run did. For Claude Code history use read-claude-code-history.

daymade/twitter-reader

Fetch Twitter/X post content including long-form Articles with full images and metadata. Use when Claude needs to retrieve tweet/article content, author info, engagement metrics, and embedded media. Supports individual posts and X Articles (long-form content). Automatically downloads all images to local attachments folder and generates complete Markdown with proper image references. Preferred over Jina for X Articles with images.

Skills relacionados