Communitygithub.com

Desesbraker/agentes-vip

Extrai transcrições de vídeos do YouTube e gera resumos abrangentes e detalhados usando estruturas de análise inteligentes.

O que é agentes-vip?

Este skill permite que agentes de IA, como Claude Code ou Cursor, extraiam transcrições de vídeos do YouTube e gerem resumos extremamente detalhados usando o framework combinado STAR + R-I-S-E. Ele valida a disponibilidade do vídeo, extrai a transcrição através da biblioteca Python `youtube-transcript-api` e produz uma documentação completa que captura todos os insights, argumentos e pontos-chave do conteúdo. O skill é ideal para usuários que precisam de análise aprofundada de conteúdo educacional, palestras, tutoriais ou vídeos informativos, eliminando a necessidade de reassistir ao vídeo para obter referências. Ele suporta múltiplos formatos de URL do YouTube, verifica automaticamente a existência de legendas (manuais ou automáticas), e estrutura a saída em Markdown com seções como síntese executiva, análise detalhada tópico a tópico, conceitos e terminologia, além de conclusões. O progresso é visualmente exibido em um painel estilizado com barras de progresso, garantindo transparência durante o processamento. Caso a dependência `youtube-transcript-api` não esteja instalada, o skill solicita permissão ao usuário para instalá-la automaticamente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/youtube-summarizer

Perguntar na sua IA favorita

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

Documentação

youtube-summarizer

Propósito

Este skill extrai transcrições de vídeos do YouTube e gera resumos abrangentes e detalhados usando o framework STAR + R-I-S-E. Ele valida a disponibilidade do vídeo, extrai transcrições usando a biblioteca Python youtube-transcript-api e produz documentação detalhada capturando todos os insights, argumentos e pontos-chave.

O skill foi projetado para usuários que precisam de análise completa de conteúdo e documentação de referência a partir de vídeos educacionais, palestras, tutoriais ou conteúdo informativo.

Quando Usar Este Skill

Este skill deve ser usado quando:

  • O usuário fornece uma URL de vídeo do YouTube e deseja um resumo detalhado
  • O usuário precisa documentar o conteúdo do vídeo para referência sem reassisti-lo
  • O usuário deseja extrair insights, pontos-chave e argumentos de conteúdo educacional
  • O usuário precisa de transcrições de vídeos do YouTube para análise
  • O usuário pede para "resumir", "sintetizar" ou "extrair conteúdo" de vídeos do YouTube
  • O usuário deseja documentação completa priorizando a completude em vez da brevidade

Passo 0: Descoberta e Configuração

Antes de processar vídeos, valide o ambiente e as dependências:

# Verificar se youtube-transcript-api está instalado
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
    echo "⚠️  youtube-transcript-api não encontrado"
    # Oferecer para instalar
fi

# Verificar disponibilidade do Python
if ! command -v python3 &>/dev/null; then
    echo "❌ Python 3 é necessário, mas não está instalado"
    exit 1
fi

Pergunte ao usuário se a dependência estiver faltando:

youtube-transcript-api é necessário, mas não está instalado.

Gostaria de instalá-lo agora?
- [ ] Sim - Instalar com pip (pip install youtube-transcript-api)
- [ ] Não - Eu instalarei manualmente

Se o usuário selecionar "Sim":

pip install youtube-transcript-api

Verificar a instalação:

python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api instalado com sucesso')"

Fluxo de Trabalho Principal

Diretrizes de Acompanhamento de Progresso

Ao longo do fluxo de trabalho, exiba um medidor visual de progresso antes de cada etapa para manter o usuário informado. O formato do medidor é:

echo "[████░░░░░░░░░░░░░░░░] 20% - Passo 1/5: Validando URL"

Especificações de formato:

  • 20 caracteres de largura (use █ para preenchido, ░ para vazio)
  • Incrementos percentuais: Passo 1=20%, Passo 2=40%, Passo 3=60%, Passo 4=80%, Passo 5=100%
  • Contador de etapas mostrando atual/total (ex: "Passo 3/5")
  • Breve descrição da fase atual

Exiba a caixa de status inicial antes do Passo 1:

╔══════════════════════════════════════════════════════════════╗
║     📹  YOUTUBE SUMMARIZER - Processando Vídeo             ║
╠══════════════════════════════════════════════════════════════╣
║ → Passo 1: Validando URL                  [EM ANDAMENTO]    ║
║ ○ Passo 2: Verificando Disponibilidade                     ║
║ ○ Passo 3: Extraindo Transcrição                            ║
║ ○ Passo 4: Gerando Resumo                                   ║
║ ○ Passo 5: Formatando Saída                                 ║
╠══════════════════════════════════════════════════════════════╣
║ Progresso: ██████░░░░░░░░░░░░░░░░░░░░░░░░  20%              ║
╚══════════════════════════════════════════════════════════════╝

Passo 1: Validar URL do YouTube

Objetivo: Extrair o ID do vídeo e validar o formato da URL.

Formatos de URL suportados:

  • 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

Ações:

# Extrair ID do vídeo usando regex ou análise de URL
URL="$URL_FORNECIDA_PELO_USUARIO"

# Padrão 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/')
# Padrão 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 do YouTube inválido"
    exit 1
fi

echo "📹 ID do vídeo extraído: $VIDEO_ID"

Se a URL for inválida:

❌ URL do YouTube inválida

Por favor, forneça uma URL válida do YouTube em um destes formatos:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

Exemplo: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Passo 2: Verificar Disponibilidade do Vídeo e Transcrição

Progresso:

echo "[████████░░░░░░░░░░░░] 40% - Passo 2/5: Verificando Disponibilidade"

Objetivo: Verificar se o vídeo existe e se a transcrição está acessível.

Ações:

from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys

video_id = sys.argv[1]

try:
    # Obter lista de transcrições disponíveis
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print(f"✅ Vídeo acessível: {video_id}")
    print("📝 Transcrições disponíveis:")
    
    for transcript in transcript_list:
        print(f"  - {transcript.language} ({transcript.language_code})")
        if transcript.is_generated:
            print("    [Gerada automaticamente]")
    
except TranscriptsDisabled:
    print(f"❌ As transcrições estão desabilitadas para o vídeo {video_id}")
    sys.exit(1)
    
except NoTranscriptFound:
    print(f"❌ Nenhuma transcrição encontrada para o vídeo {video_id}")
    sys.exit(1)
    
except Exception as e:
    print(f"❌ Erro ao acessar o vídeo: {e}")
    sys.exit(1)

Tratamento de Erros:

ErroMensagemAção
Vídeo não encontrado"❌ O vídeo não existe ou é privado"Pedir ao usuário para verificar a URL
Transcrições desabilitadas"❌ As transcrições estão desabilitadas para este vídeo"Não é possível prosseguir
Nenhuma transcrição disponível"❌ Nenhuma transcrição encontrada (não gerada automaticamente ou adicionada manualmente)"Não é possível prosseguir
Vídeo privado/restrito"❌ O vídeo é privado ou restrito"Pedir um vídeo público

Passo 3: Extrair Transcrição

Progresso:

echo "[████████████░░░░░░░░] 60% - Passo 3/5: Extraindo Transcrição"

Objetivo: Recuperar a transcrição no idioma preferido.

Ações:

from youtube_transcript_api import YouTubeTranscriptApi

video_id = "VIDEO_ID"

try:
    # Tentar obter transcrição no idioma preferido do usuário primeiro
    # Recuar para inglês se não estiver disponível
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id, 
        languages=['pt', 'en']  # Preferir português, recuar para inglês
    )
    
    # Combinar segmentos da transcrição em texto completo
    full_text = " ".join([entry['text'] for entry in transcript])
    
    # Obter metadados do vídeo
    from youtube_transcript_api import YouTubeTranscriptApi
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print("✅ Transcrição extraída com sucesso")
    print(f"📊 Tamanho da transcrição: {len(full_text)} caracteres")
    
    # Salvar em arquivo temporário para processamento
    with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
        f.write(full_text)
    
except Exception as e:
    print(f"❌ Erro ao extrair transcrição: {e}")
    exit(1)

Processamento da Transcrição:

  • Combinar todos os segmentos da transcrição em texto coerente
  • Preservar pontuação e formatação quando disponíveis
  • Remover segmentos duplicados ou sobrepostos (se artefatos de geração automática)
  • Armazenar em arquivo temporário para análise

Passo 4: Gerar Resumo Abrangente

Progresso:

echo "[████████████████░░░░] 80% - Passo 4/5: Gerando Resumo"

Objetivo: Aplicar o prompt aprimorado STAR + R-I-S-E para criar um resumo detalhado.

Prompt Aplicado:

Use o prompt aprimorado da Fase 2 (framework STAR + R-I-S-E) com a transcrição extraída como entrada.

Ações:

  1. Carregar o texto completo da transcrição
  2. Aplicar o prompt de sumarização abrangente
  3. Usar o modelo de IA (Claude/GPT) para gerar o resumo estruturado
  4. Garantir que a saída siga a estrutura definida:
    • Cabeçalho com metadados do vídeo
    • Síntese executiva
    • Análise detalhada seção por seção
    • Principais insights e conclusões
    • Conceitos e terminologia
    • Recursos e referências

Implementação:

# Usar o arquivo de transcrição como entrada para o prompt de IA
ARQUIVO_TRANSCRICAO="/tmp/transcript_${VIDEO_ID}.txt"

# O agente de IA irá:
# 1. Ler a transcrição
# 2. Aplicar o framework de sumarização STAR + R-I-S-E
# 3. Gerar saída Markdown abrangente
# 4. Estruturar com cabeçalhos, listas e destaques

Ler "$ARQUIVO_TRANSCRICAO"  # Ler transcrição no contexto

Em seguida, aplique o prompt de sumarização completo (da versão aprimorada na Fase 2).

Passo 5: Formatar e Apresentar a Saída

Progresso:

echo "[████████████████████] 100% - Passo 5/5: Formatando Saída"

Objetivo: Entregar o resumo em Markdown limpo e bem estruturado.

Estrutura da Saída:

# [Título do Vídeo]

**Canal:** [Nome do Canal]  
**Duração:** [Duração]  
**URL:** [https://youtube.com/watch?v=VIDEO_ID]  
**Data de Publicação:** [Data se disponível]

## 📝 Resumo Detalhado

### [Tópico 1]

[Explicação abrangente com exemplos, dados, citações...]

#### [Subtópico 1.1]

[Análise detalhada...]

### [Tópico 2]

[Análise detalhada continuada...]

## 📚 Conceitos e Terminologia

- **[Termo 1]:** [Definição e contexto]
- **[Termo 2]:** [Definição e contexto]

## 📌 Conclusão

[Síntese final e principais aprendizados]

### **Exemplo 2: Dependência Ausente**

**Entrada do Usuário:**

claude> resuma este vídeo do youtube https://youtu.be/abc123


**Resposta do Skill:**

⚠️ youtube-transcript-api não instalado

Este skill requer a biblioteca Python 'youtube-transcript-api'.

Gostaria que eu a instalasse agora?

  • Sim - Instalar com pip
  • Não - Eu instalarei manualmente

**Usuário seleciona "Sim":**

```bash
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1

✅ Instalação completa! Prosseguindo com o resumo do vídeo...

Exemplo 4: URL Inválida

Entrada do Usuário:

claude> resuma vídeo do youtube www.youtube.com/some-video

Resposta do Skill:

❌ Formato de URL do YouTube inválido

Exemplos de formato esperado:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

Por favor, forneça uma URL de vídeo do YouTube válida.

📊 Resumo Executivo

Este vídeo fornece uma introdução abrangente aos conceitos fundamentais da Inteligência Artificial (IA), projetado para iniciantes e profissionais que desejam entender os fundamentos técnicos e as aplicações práticas da IA moderna. O instrutor aborda desde definições básicas até algoritmos de aprendizado de máquina, usando exemplos práticos e visualizações para facilitar a compreensão.

[... resumo detalhado continuado ...]


**Opções de Salvamento:**

O que você gostaria de salvar? → Resumo + transcrição bruta

✅ Arquivo salvo: resumo-exemplo123-2026-02-01.md (inclui transcrição bruta) [████████████████████] 100% - ✓ Processamento completo!


Bem-vindo a este tutorial abrangente sobre fundamentos de aprendizado de máquina. No vídeo de hoje, exploraremos os conceitos principais que impulsionam os sistemas modernos de IA...

Versão: 1.2.0 Última Atualização: 2026-02-02 Mantido por: Eric Andrade

Individual skills in this repo

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

Habilidades Relacionadas