Communitygithub.com

AbobakrDiara61/railway-system

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

O que é railway-system?

Esta skill foi projetada para extrair transcrições de vídeos do YouTube e gerar resumos detalhados e completos utilizando o framework STAR + R-I-S-E. Ela valida se o vídeo está disponível, extrai a transcrição usando a biblioteca Python `youtube-transcript-api` e produz documentação estruturada que captura todos os insights, argumentos e pontos-chave. A skill é voltada para usuários que precisam de análise aprofundada de conteúdo educacional, tutoriais, palestras ou materiais informativos, evitando a necessidade de reassistir ao vídeo. Funciona com plataformas que suportam ferramentas de IA e agentes de código, como Claude Code, Cursor e Codex, seguindo um fluxo de trabalho claro de validação de URL, verificação de disponibilidade, extração de transcrição, geração de resumo e formatação da saída em Markdown.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/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 usando 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 completa 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", "sumarizar" ou "extrair conteúdo" de vídeos do YouTube
  • O usuário deseja documentação abrangente priorizando completude sobre brevidade

Etapa 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 - Instalarei manualmente

Se o usuário selecionar "Sim":

pip install youtube-transcript-api

Verificar 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:

╔══════════════════════════════════════════════════════════════╗
║     📹  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 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 Transcrição

Progresso:

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

Objetivo: Verificar se o vídeo existe e 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"❌ 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"Perguntar ao usuário para verificar a URL
Transcrições desabilitadas"❌ 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

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 transcrição no idioma preferido do usuário primeiro
    # Voltar para inglês se não estiver disponível
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id, 
        languages=['pt', 'en']  # Preferir português, voltar 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 o prompt aprimorado STAR + R-I-S-E para criar um resumo detalhado.

Prompt Aplicado:

Usar 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 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
    • 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 Markdown abrangente
# 4. Estruturar com cabeçalhos, listas e destaques

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

Em seguida, aplicar 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 continua...]


## 📚 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 que eu a instalasse 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 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 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 cobre 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 continua ...]


**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 especializada.
  • Pare e peça esclarecimentos se as entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.

Individual skills in this repo

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Best practices for Remotion - Video creation in React

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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