youtube-downloader
por ComposioHQyoutube-downloader es una skill de File Automation para guardar videos individuales de YouTube o extraer audio MP3 mediante un wrapper de Python para yt-dlp. Admite selección de calidad, formatos mp4/webm/mkv, modo de solo audio y carpetas de salida personalizadas.
Esta skill obtiene 74/100, lo que significa que es aceptable para aparecer en el directorio, aunque conviene presentarla como una utilidad práctica y de alcance limitado, con advertencias de adopción. Los usuarios del directorio tienen suficiente información para entender cuándo instalarla y cómo la llamaría un agente, aunque el manejo de dependencias, la orientación sobre políticas y derechos, y la documentación de casos límite son limitados.
- Activador y alcance claros: el frontmatter indica a los agentes que lo usen cuando los usuarios pidan descargar, guardar o capturar videos de YouTube.
- Incluye un script ejecutable, un comando de inicio rápido, una ruta de salida predeterminada y ejemplos para opciones de calidad, formato, solo audio y directorio de salida personalizado.
- Aporta más valor operativo que un prompt genérico porque el script encapsula comandos de yt-dlp y ofrece flags de CLI sencillos para las opciones de descarga más habituales.
- No incluye comando de instalación ni notas de dependencias en SKILL.md; el script instala yt-dlp automáticamente con pip usando --break-system-packages, algo que puede no ser adecuado en algunos entornos.
- La documentación no menciona los términos de YouTube, derechos de autor, autenticación, listas de reproducción, errores ni otros casos límite, por lo que los agentes pueden necesitar criterio adicional para descargas que no sean simples.
Descripción general de youtube-downloader skill
Qué hace youtube-downloader skill
La youtube-downloader skill es una skill de File Automation para guardar videos de YouTube o extraer audio MP3 mediante un pequeño wrapper en Python sobre yt-dlp. Es ideal para usuarios que quieren que un agente gestione una solicitud de descarga concreta con opciones claras: URL de origen, carpeta de salida, calidad de video, formato contenedor o modo solo audio.
Usuarios y tareas para los que encaja mejor
Usa esta skill cuando necesites una salida repetible en archivos locales, no una explicación conversacional sobre cómo funcionan las descargas. Encaja en flujos como archivar videos permitidos, preparar archivos para revisión sin conexión, guardar clips de referencia para trabajo interno o extraer audio de un video que tienes derecho a descargar. Es especialmente útil cuando el agente puede ejecutar comandos de shell y escribir en /mnt/user-data/outputs/ o en otro directorio especificado.
Capacidades clave y límites
La skill admite ajustes de calidad best, 1080p, 720p, 480p, 360p y worst; formatos de video mp4, webm y mkv; y extracción de audio MP3 con --audio-only. No es un gestor de listas de reproducción, editor de metadatos, flujo de trabajo para subtítulos ni organizador de bibliotecas multimedia. El script llama a yt-dlp con --no-playlist, así que conviene esperar una URL de video por ejecución, salvo que modifiques la implementación.
Consideraciones antes de adoptarla
El principal valor frente a un prompt genérico es que la skill ya incluye comandos ejecutables y un helper scripts/download_video.py. El principal obstáculo es el entorno de ejecución: Python debe estar disponible, las descargas deben estar permitidas y yt-dlp debe estar instalado o poder instalarse mediante el script. La extracción de audio también puede depender de herramientas multimedia como ffmpeg, según el entorno y el comportamiento de yt-dlp.
Cómo usar youtube-downloader skill
Contexto de instalación de youtube-downloader
Instala la skill desde la ruta del repositorio:
npx skills add ComposioHQ/awesome-claude-skills --skill video-downloader
Después, revisa primero los dos archivos importantes: SKILL.md para ver las opciones admitidas y scripts/download_video.py para entender el comportamiento real de ejecución. El script es la fuente de verdad para los valores predeterminados: ruta de salida /mnt/user-data/outputs, calidad predeterminada best, formato predeterminado mp4 y salida MP3 cuando se activa el modo solo audio.
Datos que necesita la skill
Una buena solicitud de uso de youtube-downloader debe incluir:
- La URL exacta de YouTube
- Si quieres video o solo audio
- La calidad preferida, como
720pobest - El formato de video preferido, como
mp4owebm - El directorio de salida si el valor predeterminado no es aceptable
- Cualquier restricción legal u operativa, como “descarga solo este video”
Prompt mínimo:
Download this YouTube video as MP4 in best quality:
https://www.youtube.com/watch?v=VIDEO_ID
Prompt más sólido:
Use the youtube-downloader skill to download only this single video:
https://www.youtube.com/watch?v=VIDEO_ID. Save it asmp4, target720p, and put the result in/mnt/user-data/outputs/project-a/. If the requested quality is unavailable, use the closest lower quality and tell me the final file path.
Comandos prácticos y flujo de trabajo
El patrón de comando directo es:
python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
Variantes habituales:
python scripts/download_video.py "URL" -q 1080p -f mp4
python scripts/download_video.py "URL" -q 720p -f webm -o /mnt/user-data/outputs/videos
python scripts/download_video.py "URL" -a -o /mnt/user-data/outputs/audio
Un flujo fiable es: confirmar la URL, elegir el tipo de salida, ejecutar una descarga, verificar la ruta del archivo creado y ajustar la calidad o el formato solo si la salida es demasiado grande, incompatible o no está disponible.
Consejos para obtener mejores resultados en File Automation
Para usar youtube-downloader en File Automation, evita solicitudes vagas como “baja ese video”. Proporciona la URL y el resultado esperado en un solo mensaje. Si la compatibilidad importa, elige mp4; si importa el tamaño del archivo, usa 720p, 480p o solo audio. Si el entorno está restringido, pide al agente que compruebe yt-dlp --version antes de descargar, para detectar pronto los fallos de dependencias.
FAQ de youtube-downloader skill
¿Es mejor que pedirle a una IA que descargue un video?
Sí, cuando la ejecución de herramientas está disponible. Un prompt genérico puede explicar yt-dlp; esta skill le da al agente un script concreto, flags aceptados y una ubicación de salida predeterminada. Eso reduce las conjeturas y hace que el uso de youtube-downloader sea más consistente en solicitudes repetidas.
¿Qué añade realmente la instalación de youtube-downloader?
La instalación añade las instrucciones de la skill y el script auxiliar en scripts/download_video.py. El script comprueba si existe yt-dlp e intenta instalarlo con Python pip si falta. No incluye contenido de YouTube, no evita controles de acceso ni sustituye la necesidad de un entorno de línea de comandos funcional.
¿Pueden usar esta skill los principiantes?
Sí, si pueden proporcionar una URL válida de YouTube y elegir opciones simples como mp4 y 720p. Los principiantes deberían empezar con el comando predeterminado y añadir -q, -f, -a u -o solo cuando sepan qué quieren cambiar.
¿Cuándo no debería usarla?
No uses esta skill para contenido que no tienes permiso de descargar, para contenido protegido por DRM o restringido, ni para flujos que requieran listas de reproducción, subtítulos, colas masivas, plantillas de nombres o posprocesamiento. En esos casos, trátala como un script inicial, no como un sistema completo de automatización multimedia.
Cómo mejorar youtube-downloader skill
Mejora los prompts de youtube-downloader
Los mejores prompts producen mejor automatización. Incluye el resultado deseado, no solo la acción:
Download the video at
URLasmp4in720p, save it to/mnt/user-data/outputs/client-review/, and report the final filename and size.
Esto ayuda al agente a seleccionar los flags adecuados y verificar la salida, en lugar de limitarse a ejecutar el valor predeterminado.
Gestiona los modos de fallo habituales
Los fallos probables incluyen que la calidad solicitada no esté disponible, que falte yt-dlp, que falte ffmpeg para extraer MP3, acceso de red bloqueado, URLs no válidas y errores de permisos de escritura en el directorio de salida. Pide al agente que muestre el comando exacto y el mensaje de error cuando falle una descarga; eso acelera la iteración mucho más que repetir la misma solicitud vaga.
Añade controles de salida más sólidos
Si planeas usar esta skill con frecuencia, considera mejorar scripts/download_video.py con plantillas de nombre de archivo, protección contra sobrescritura, comprobaciones de existencia de archivos, límites de duración y una salida de éxito más clara. Estos cambios importan porque a los usuarios normalmente les preocupa menos que la “descarga haya empezado” y más dónde quedó el archivo, si se puede reproducir y si coincide con la calidad solicitada.
Itera después de la primera salida
Después de la primera ejecución, revisa la ruta del archivo, la extensión, el tamaño y la compatibilidad de reproducción. Si el archivo es demasiado grande, vuelve a ejecutar con 720p o 480p. Si se va a compartir ampliamente, prefiere mp4. Si solo se necesita voz o música, vuelve a ejecutar con --audio-only. Así, la guía de youtube-downloader sigue siendo práctica: empieza con un archivo correcto y luego optimiza formato y calidad.