Communitygithub.com

BEKO2210/Firstbrain

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

O que é Firstbrain?

Esta skill permite extrair transcrições de vídeos do YouTube e gerar resumos completos e detalhados utilizando o framework STAR + R-I-S-E. Ela valida a disponibilidade do vídeo, extrai a transcrição com a biblioteca Python `youtube-transcript-api` e produz documentação aprofundada que captura todos os insights, argumentos e pontos-chave do conteúdo. É ideal para profissionais, estudantes e criadores de conteúdo que desejam analisar vídeos educacionais, palestras, tutoriais ou qualquer material informativo sem precisar reassisti-los. A skill funciona em plataformas como Claude Code, Cursor e Codex, e guia o usuário por um fluxo de cinco etapas com indicadores visuais de progresso: validação da URL, verificação de disponibilidade, extração da transcrição, geração do resumo estruturado e formatação da saída em Markdown. O resultado final inclui metadados do vídeo, síntese executiva, análise detalhada seção por seção, conceitos e terminologia, além de opções para salvar o resumo e a transcrição bruta.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/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 é 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:

# Verifica 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

# Verifica 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.

Deseja 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

Durante todo o 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:

╔══════════════════════════════════════════════════════════════╗
║     📹  SUMMARIZADOR DE VÍDEOS - 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="$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

Etapa 2: Verificar Disponibilidade do Vídeo e 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("    [Gerado 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"Peça 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"Peça 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
    # Voltar para o 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 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 prompt aprimorado STAR + R-I-S-E para criar 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 modelo de IA (Claude/GPT) para gerar 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 abrangente em Markdown
# 4. Estruturar com cabeçalhos, listas e destaques

Ler "$ARQUIVO_TRANSCRICAO"  # 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 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]

[Análise detalhada...]

### [Tópico 2]

[Análise detalhada contínua...]


## 📚 Conceitos e Terminologia

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


## 📌 Conclusão

[Síntese final e principais 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 está instalado

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

Deseja que eu a instale agora?

  • Sim - Instalar com pip
  • Não - Instalarei manualmente

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

```bash
$ 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 válida de vídeo do YouTube.

📊 Resumo Executivo

Este vídeo fornece uma introdução abrangente aos conceitos fundamentais de Inteligência Artificial (IA), projetada 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.

[... continuação do resumo detalhado ...]


**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 concluído!


---

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

---

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

## Conexões

- **Domínio:** [[Design & Kreativitaet]]
- **Categoria:** [[Video & Audio Produktion]]
- **Arquivos:**
  - `scripts/extract-transcript.py`
  - `scripts/install-dependencies.sh`
- **Navegação:** [[Skills Uebersicht]], [[Home]]

Individual skills in this repo

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

Habilidades Relacionadas