Communitygithub.com

ASoudy/AGS - Resumidor de Vídeos do YouTube

Extrai transcrições de vídeos do YouTube e gera resumos detalhados e abrangentes utilizando o framework de análise inteligente STAR + R-I-S-E.

O que é AGS - Resumidor de Vídeos do YouTube?

Esta skill (ASoudy/AGS) foi projetada para extrair transcrições de vídeos do YouTube e gerar resumos completos e detalhados, priorizando a profundidade em vez da brevidade. Ela utiliza o framework STAR + R-I-S-E para estruturar a análise, garantindo que todos os insights, argumentos e pontos-chave do conteúdo sejam capturados. A skill é ideal para criadores de conteúdo, estudantes e profissionais que precisam analisar vídeos educacionais, palestras ou tutoriais sem precisar reassisti-los. O fluxo de trabalho inclui validação da URL, verificação da disponibilidade da transcrição (via `youtube-transcript-api`), extração do texto e geração de um resumo estruturado em Markdown, com seções como resumo executivo, análise detalhada, conceitos e terminologia. A skill também oferece suporte a feedback visual de progresso e gerencia dependências ausentes, solicitando a instalação automática quando necessário. Suporta plataformas como Claude Code, Cursor e Codex, e é mantida por Eric Andrade.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/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

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

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

Quando Usar Esta Skill

Esta skill deve ser usada 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 abrangente priorizando completude em vez de brevidade

Etapa 0: Descoberta e Configuração

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

# Verificar se o 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 - Instalarei manualmente

Se o usuário selecionar "Sim":

pip install youtube-transcript-api

Verifique 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 indicador visual de progresso antes de cada etapa para manter o usuário informado. O formato do indicador é:

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

Especificações de formato:

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

Exiba a caixa de status inicial antes da Etapa 1:

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

Etapa 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 o ID do vídeo usando regex ou análise de URL
URL="$USER_PROVIDED_URL"

# 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

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

Progresso:

echo "[████████░░░░░░░░░░░░] 40% - Etapa 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 desativadas 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 desativadas"❌ As transcrições estão desativadas 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"Solicitar um vídeo público

Etapa 3: Extrair Transcrição

Progresso:

echo "[████████████░░░░░░░░] 60% - Etapa 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 a transcrição no idioma preferido do usuário primeiro
    # Recorrer ao inglês se não estiver disponível
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id, 
        languages=['pt', 'en']  # Preferir português, fallback 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 um texto coerente
  • Preservar pontuação e formatação quando disponível
  • Remover segmentos duplicados ou sobrepostos (se artefatos de geração automática)
  • Armazenar em arquivo temporário para análise

Etapa 4: Gerar Resumo Abrangente

Progresso:

echo "[████████████████░░░░] 80% - Etapa 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 abrangente de sumarização
  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
    • Detalhamento 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
TRANSCRIPT_FILE="/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 abrangente em Markdown
# 4. Estruturar com cabeçalhos, listas e destaques

Read "$TRANSCRIPT_FILE"  # Ler transcrição no contexto

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

Etapa 5: Formatar e Apresentar a Saída

Progresso:

echo "[████████████████████] 100% - Etapa 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]

[Detalhamento...]

### [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 conclusões]

Exemplo 2: Dependência Ausente

Entrada do Usuário:

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

Resposta da Skill:

⚠️  youtube-transcript-api não instalado

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

Gostaria de instalá-la agora?
- [ ] Sim - Instalar com pip
- [ ] Não - Instalarei manualmente

Usuário seleciona "Sim":

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

✅ Instalação concluída! 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 da 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 de 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 gostaria de salvar? → Resumo + transcrição bruta

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



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

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

Limitações

  • Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
  • Pare e peça esclarecimentos se as entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem faltando.

Individual skills in this repo

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

ASoudy/AGS

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

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

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

Habilidades Relacionadas