Communitygithub.com

daymade/claude-code-skills

Baixe vídeos do YouTube e streams HLS (m3u8) de plataformas como Mux, Vimeo, etc. usando yt-dlp e ffmpeg. Utilize esta habilidade quando os usuários solicitarem download de vídeos, extração de áudio, manipulação de streams protegidos com cabeçalhos de autenticação ou solução de problemas de download como falhas de extração nsig, erros 403 ou problemas de extração de cookies.

O que é claude-code-skills?

Esta habilidade permite que agentes de IA baixem vídeos e áudio de forma confiável do YouTube e plataformas de streaming HLS (como Mux, Vimeo) usando yt-dlp e ffmpeg. Ela é projetada para lidar com conteúdo protegido, oferece suporte a downloads de alta qualidade (até 4K) e soluciona falhas comuns de download, como erros 403, falhas de extração nsig ou problemas de cookies. A habilidade usa um fluxo de trabalho padrão que pergunta ao usuário pela URL, busca metadados, oferece opções de qualidade e formato, e baixa o arquivo — tudo sem exigir que o usuário execute comandos complexos. Para downloads de alta qualidade, ela configura automaticamente um provedor de tokens PO (via Docker ou navegador) ou usa cookies do navegador para contornar restrições do YouTube. A habilidade também inclui um script wrapper conveniente (`scripts/download_video.py`) que integra todas essas funcionalidades, tornando-a ideal para assistentes de IA que precisam executar downloads de forma autônoma em nome do usuário.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

Thumbnail
Thumbnail

Documentação

YouTube Downloader

Visão Geral

Permite downloads confiáveis de vídeo e áudio do YouTube e plataformas de streaming HLS (Mux, Vimeo, etc.) usando yt-dlp e ffmpeg. Esta habilidade fornece fluxos de trabalho para:

  • Downloads do YouTube (até 4K) usando provedores de token PO ou cookies do navegador
  • Downloads de streams HLS com cabeçalhos de autenticação
  • Manipulação de conteúdo protegido e solução de problemas comuns de download

Experiência do Usuário Não Técnico (Padrão)

Presuma que o usuário não é técnico. Não peça para ele executar comandos. Execute tudo você mesmo e relate o progresso em linguagem simples. Evite mencionar ferramentas a menos que o usuário pergunte.

Fluxo padrão:

  1. Peça a URL (se não for fornecida).
  2. Busque os metadados do vídeo (título/canal/duração/miniatura) e confirme se correspondem à intenção do usuário.
    • Se o yt-dlp for bloqueado com “confirme que você não é um robô”, use o fallback do oEmbed do YouTube para título/canal/miniatura (a duração pode ser desconhecida).
  3. Ofereça opções simples (vídeo vs. somente áudio, qualidade, legendas, local de salvamento).
  4. Prossiga com padrões sensatos se o usuário não especificar:
    • Download de vídeo na melhor qualidade
    • Saída mesclada em MP4
    • Vídeo único apenas (sem playlists)
  5. Baixe e informe o caminho final do arquivo, tamanho e resolução (se for vídeo).

Ofereça opções em termos amigáveis:

  • “Baixar o vídeo na melhor qualidade (padrão)”
  • “Baixar apenas o áudio (MP3)”
  • “Escolha uma qualidade: 1080p / 720p / 480p / 360p”
  • “Incluir legendas (se disponíveis)”
  • “Salvar na pasta Downloads (padrão) ou me informe outra pasta”

Sempre renderize a miniatura quando disponível:

  • Se os metadados incluírem uma URL de miniatura, inclua-a usando a sintaxe de imagem Markdown: ![Thumbnail](URL).

Pergunte antes de fazer trabalho extra:

  • Confirme downloads de playlists (podem ser grandes).
  • Confirme a instalação/atualização de dependências se estiverem faltando.
  • Pergunte antes de extrair cookies do navegador.
  • Ao usar cookies, nunca mencione contagens de cookies ou detalhes brutos de cookies nas respostas para o usuário. Diga “usei sua sessão de login do Chrome”.
  • Se for necessária verificação, configure automaticamente um auxiliar de token PO local (nenhuma ação do usuário). Se o Docker estiver faltando ou falhar, não tente instalar o Docker — mude para o provedor de token PO baseado em navegador.

Lembrete legal/segurança (breve):

  • Prossiga somente se o usuário tiver os direitos ou permissão para baixar o conteúdo.

Modelo de resposta (use linguagem simples, sem comandos):

![Thumbnail](URL_DA_MINIATURA)

Título: …
Canal: …
Duração: …

Posso ajudar você a:
1) Baixar o vídeo (melhor qualidade, MP4)
2) Baixar apenas o áudio (MP3)
3) Escolher uma qualidade específica (1080p/720p/480p/360p)
4) Incluir legendas (se disponíveis)

Onde devo salvar? (Padrão: pasta Downloads)

Se o usuário disser “apenas baixe”:

  • Prossiga com os padrões e confirme quando o download terminar.
    • Se for bloqueado por um erro 403, configure automaticamente o auxiliar de verificação e tente novamente.

SOP de Download Confiável (Interno)

Siga este SOP para evitar falhas e confusões comuns:

  1. Coloque URLs entre aspas em comandos de shell (o zsh trata ? como um glob). Exemplo: 'https://www.youtube.com/watch?v=VIDEO_ID'.
  2. Certifique-se de que o proxy está ativo para yt-dlp e provedores de token PO (HTTP_PROXY/HTTPS_PROXY/ALL_PROXY).
  3. Se você vir “Faça login para confirmar que você não é um robô”, solicite permissão e use cookies do navegador. Não prossiga sem cookies.
  4. Inicie um provedor de token PO antes de baixar (falhe rápido se ele não puder iniciar).
    • Use o provedor Docker bgutil quando disponível.
    • Se o Docker estiver faltando ou falhar, mude para o provedor WPC baseado em navegador.
  5. Se cookies estiverem em uso, prefira o cliente de player web_safari. Caso contrário, prefira mweb para tokens PO.
  6. Mantenha a janela do navegador aberta enquanto o WPC estiver gerando tokens. Certifique-se de que o Chrome possa acessar o YouTube através do mesmo proxy.
  7. Se você obtiver “Apenas imagens estão disponíveis” ou “O formato solicitado não está disponível”, trate como uma falha de token PO e tente novamente após corrigir o estado do provedor/navegador.
  8. Se você obtiver erros de SSL EOF ou fragmento, trate como um problema de proxy/rede. Tente novamente com formatos progressivos e/ou um proxy melhor.

Lista de Verificação de Execução do Agente (Interno)

  • Execute scripts/download_video.py URL --info (adicione --cookies-from-browser chrome se a permissão for concedida) para buscar metadados e miniatura.
  • Se os metadados do yt-dlp falharem, use o fallback oEmbed do script para título/canal/miniatura e observe que a duração pode não estar disponível.
  • Se uma URL de miniatura estiver presente, renderize-a na resposta com a sintaxe de imagem Markdown.
  • Peça ao usuário para escolher entre vídeo e somente áudio e (opcionalmente) uma predefinição de qualidade.
  • Use um local de salvamento padrão amigável (pasta Downloads), a menos que o usuário especifique uma pasta.
  • Para legendas, execute com --subtitles e o --sub-lang solicitado.
  • Após o download, informe o nome do arquivo, tamanho e resolução (se for vídeo) em linguagem simples.
  • Se o download falhar com erros 403/fragmento, tente novamente uma vez com formatos progressivos não-m3u8.
  • Se “Faça login para confirmar que você não é um robô” aparecer, solicite acesso aos cookies e tente novamente com cookies + web_safari.
  • Se “Apenas imagens estão disponíveis” aparecer, trate como falha de token PO e tente novamente após corrigir o estado do provedor/navegador.
  • Inicie o provedor de token PO antes dos downloads (--auto-po-token padrão). Falhe rápido se ele não puder iniciar.
  • Se o provedor baseado em Docker falhar (comum na China), use automaticamente o provedor WPC baseado em navegador (ele pode abrir brevemente uma janela do navegador).
  • Se o provedor WPC for usado, mantenha a janela do navegador aberta até o download começar. Se o navegador falhar ao iniciar, defina o caminho do Chrome explicitamente.
  • Se o provedor de token PO expirar, reinicie-o uma vez e tente novamente.
  • Se um proxy de sistema estiver configurado, passe-o para o contêiner do provedor. Se o proxy apontar para 127.0.0.1/localhost, reescreva-o para host.docker.internal para o Docker.

Quando Usar Esta Habilidade

Esta habilidade deve ser invocada quando os usuários:

  • Solicitarem download de vídeos ou playlists do YouTube
  • Quiserem extrair áudio de vídeos do YouTube
  • Enfrentarem falhas de download do yt-dlp ou disponibilidade limitada de formatos
  • Precisarem de ajuda com seleção de formato ou opções de qualidade
  • Relatarem apenas formatos de baixa qualidade (360p) disponíveis
  • Perguntarem sobre download de conteúdo do YouTube em qualidade específica (1080p, 4K, etc.)
  • Precisarem converter vídeos WebM baixados para formato MP4 para maior compatibilidade
  • Solicitarem download de streams HLS (m3u8) de plataformas como Mux, Vimeo ou outros serviços de streaming
  • Precisarem baixar streams protegidos que exigem cabeçalhos de autenticação

Pré-requisitos

1. Verificar a Instalação do yt-dlp (Execute você mesmo)

which yt-dlp
yt-dlp --version

Se não estiver instalado ou desatualizado (< 2025.10.22):

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

Crítico: Versões desatualizadas do yt-dlp causam falhas de extração nsig e formatos ausentes.

2. Verificar o Acesso à Qualidade Atual (Execute você mesmo)

Antes de baixar, verifique os formatos disponíveis:

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

Se apenas o formato 18 (360p) aparecer: É necessária a configuração do provedor de token PO para acesso de alta qualidade.

Fluxo de Trabalho de Download de Alta Qualidade

Passo 1: Instalar o Provedor de Token PO (Configuração Única)

Para acesso 1080p/1440p/4K, instale um plugin de provedor de token PO no ambiente Python do yt-dlp:

# Encontre o caminho do Python do yt-dlp (interpretador usado pelo yt-dlp)
head -1 $(which yt-dlp)

# Instale o plugin usando o interpretador da linha acima
<YTDLP_PYTHON> -m pip install bgutil-ytdlp-pot-provider

Verificação: Execute yt-dlp -F "VIDEO_URL" novamente. Procure pelos formatos 137 (1080p), 271 (1440p) ou 313 (4K).

Consulte references/po-token-setup.md para instruções detalhadas de configuração e solução de problemas.

Passo 2: Baixar com a Melhor Qualidade

Depois que o provedor de token PO estiver instalado:

# Baixar a melhor qualidade até 1080p
yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "VIDEO_URL"

# Baixar a melhor qualidade disponível (4K se disponível)
yt-dlp -f "bestvideo+bestaudio/best" "VIDEO_URL"

Passo 3: Verificar a Qualidade do Download

# Verificar resolução do vídeo
ffprobe -v error -select_streams v:0 -show_entries stream=width,height,codec_name -of default=noprint_wrappers=1 video.mp4

Saída esperada para 1080p:

codec_name=vp9
width=1920
height=1080

Alternativa: Método de Cookies do Navegador

Se a configuração do provedor de token PO for problemática, use cookies do navegador:

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

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

Benefícios: Acesso a conteúdo com restrição de idade e exclusivo para membros. Requisitos:

  • Você deve estar logado no YouTube no navegador especificado.
  • O navegador e o yt-dlp devem usar o mesmo IP/proxy.
  • Não use o cliente Android com cookies (o cliente Android não suporta cookies).

Tarefas Comuns

Download Apenas de Áudio (Execute você mesmo)

Extrair áudio como MP3:

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

Diretório de Saída Personalizado (Execute você mesmo)

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

Baixar com Legendas (Execute você mesmo)

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

Download de Playlist (Execute você mesmo)

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

Converter WebM para MP4 (Execute você mesmo)

Downloads de alta qualidade do YouTube geralmente usam o formato WebM (codec VP9). Converta para MP4 para maior compatibilidade:

# Verifique se o ffmpeg está instalado
which ffmpeg || brew install ffmpeg  # macOS

# Converter WebM para MP4 com boas configurações de qualidade
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: Usar codec de vídeo H.264 (amplamente compatível)
  • -preset medium: Equilíbrio entre velocidade de codificação e tamanho do arquivo
  • -crf 23: Fator de taxa constante para qualidade (intervalo 18-28, menor = melhor qualidade)
  • -c:a aac: Usar codec de áudio AAC
  • -b:a 128k: Taxa de bits de áudio 128 kbps

Dica: A conversão mantém a resolução 1080p e fornece velocidade de codificação ~6x em hardware moderno.

Referência Rápida de Solução de Problemas

Apenas 360p Disponível (Formato 18)

Causa: Provedor de token PO ausente ou yt-dlp desatualizado.

Solução:

  1. Atualize o yt-dlp: brew upgrade yt-dlp
  2. Instale o provedor de token PO (consulte o Passo 1 acima)
  3. Ou use o método de cookies do navegador

Faça Login para Confirmar que Você Não é um Robô

Causa: O YouTube exige autenticação para prosseguir.

Solução:

  1. Solicite permissão e use cookies do navegador (--cookies-from-browser chrome).
  2. Certifique-se de que o navegador e o yt-dlp usam o mesmo IP/proxy.
  3. Tente novamente com o cliente web_safari se necessário.

Apenas Imagens Disponíveis / Formato Solicitado Não Disponível

Causa: Tokens PO não aplicados ou verificação do provedor/navegador falhou.

Solução:

  1. Verifique se o provedor de token PO está em execução antes do download.
  2. Mantenha a janela do navegador aberta se estiver usando WPC.
  3. Se cookies estiverem em uso, prefira o cliente web_safari e tente novamente.

Falha na Extração nsig

Sintomas:

WARNING: [youtube] nsig extraction failed: Some formats may be missing

Solução:

  1. Atualize o yt-dlp para a versão mais recente
  2. Instale o provedor de token PO
  3. Se ainda falhar e os tokens PO estiverem desabilitados, use o cliente Android: yt-dlp --extractor-args "youtube:player_client=android" "VIDEO_URL"

Erros de SSL EOF / Fragmento

Causa: Instabilidade de proxy ou rede.

Solução:

  1. Tente novamente com formatos progressivos (não-m3u8).
  2. Mude para um proxy/nó mais estável.
  3. Evite fechar a janela do navegador do token PO durante o download.

Downloads Lentos ou Erros de Rede

Para usuários na China ou atrás de proxies restritivos:

  • Os downloads podem ser lentos devido às condições de rede
  • Permita tempo suficiente para a conclusão
  • O yt-dlp tenta novamente automaticamente em falhas transitórias

Aviso de Token PO (Inofensivo)

WARNING: android client https formats require a GVS PO Token

Ação: Ignore se o download for bem-sucedido. Isso indica que o cliente Android tem acesso limitado a formatos sem tokens PO.

Referência do Script Incluso

scripts/download_video.py

Use este invólucro de conveniência para iniciar automaticamente um provedor de token PO por padrão para downloads de alta qualidade. Use-o você mesmo e relate os resultados ao usuário sem pedir para ele executar comandos.

Uso básico:

scripts/download_video.py "VIDEO_URL"

Argumentos:

  • url - URL do vídeo do YouTube (obrigatório)
  • -o, --output-dir - Diretório de saída
  • --output-template - Modelo de nome de arquivo de saída (sintaxe yt-dlp)
  • -f, --format - Especificação de formato
  • -q, --quality - Predefinição de qualidade (best, 1080p, 720p, 480p, 360p, worst). Padrão: best (ignorado para --audio-only)
  • -a, --audio-only - Extrair áudio como MP3
  • --subtitles - Baixar legendas se disponíveis
  • --sub-lang - Idiomas das legendas (separados por vírgula, padrão: en)
  • --cookies-from-browser - Carregar cookies de um navegador (ex.: chrome, firefox)
  • --cookies-file - Carregar cookies de um arquivo cookies.txt
  • --player-client - Usar um cliente de player específico do YouTube (ex.: web_safari)
  • --auto-po-token - Iniciar automaticamente o provedor de token PO (padrão; usa Docker se disponível, caso contrário, muda para provedor baseado em navegador)
  • --no-auto-po-token - Desabilitar a configuração automática de token PO
  • --proxy - URL do proxy para yt-dlp e o provedor de token PO (ex.: http://127.0.0.1:1082)
  • --wpc-browser-path - Caminho do executável do navegador para o provedor WPC
  • -F, --list-formats - Listar formatos disponíveis
  • --merge-format - Contêiner de saída da mesclagem (ex.: mp4, mkv). Padrão: mp4
  • --playlist - Permitir downloads de playlists (padrão: apenas vídeo único)
  • --info - Imprimir título/canal/duração/miniatura e sair
  • --no-android-client - Desabilitar fallback do cliente Android

Nota: Use o cliente Android apenas quando os tokens PO estiverem desabilitados. Mantenha os tokens PO habilitados para alta qualidade.

Expectativas de Qualidade

Configuração360p720p1080p1440p4K
Token PO automático (padrão)✓✓✓✓✓
Apenas cliente Android✓✗✗✗✗
Provedor de token PO (manual)✓✓✓✓✓
Cookies do navegador✓✓✓✓✓

...

[truncado para tradução]

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.

Habilidades Relacionadas