Communitygithub.com

delorenj/skills

Transcrições do YouTube transformadas em resumos, threads, artigos de blog e outros formatos.

O que é skills?

Esta skill permite que agentes de IA extraiam e processem transcrições de vídeos do YouTube, convertendo-as em diversos formatos de conteúdo estruturado. Ela é útil para desenvolvedores e criadores de conteúdo que precisam resumir vídeos rapidamente, gerar threads para redes sociais ou produzir artigos de blog a partir de material audiovisual. Compatível com ferramentas como Claude Code, Cursor e Codex, a skill opera via um script Python que aceita qualquer URL padrão do YouTube (incluindo links curtos, shorts e IDs de vídeo) e depende da biblioteca `youtube-transcript-api`. O workflow envolve buscar a transcrição, validar o idioma e a integridade dos dados, dividir transcrições longas em partes gerenciáveis, transformá-las no formato solicitado (capítulos, resumos, threads, posts de blog, etc.) e verificar a qualidade do resultado final, com tratamento robusto de erros para vídeos privados, transcrições desativadas ou problemas de dependência.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/youtube-content

Perguntar na sua IA favorita

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

Documentação

Ferramenta de Conteúdo do YouTube

Quando usar

Use quando o usuário compartilhar uma URL do YouTube ou link de vídeo, pedir para resumir um vídeo, solicitar uma transcrição ou quiser extrair e reformatar o conteúdo de qualquer vídeo do YouTube. Transforma transcrições em conteúdo estruturado (capítulos, resumos, threads, posts de blog).

Extrai transcrições de vídeos do YouTube e as converte em formatos úteis.

Configuração

Use uv para instalar a dependência no mesmo ambiente gerenciado pelo Hermes que executa o script auxiliar:

uv pip install youtube-transcript-api

Script Auxiliar

SKILL_DIR é o diretório que contém este arquivo SKILL.md. O script aceita qualquer formato de URL padrão do YouTube, links curtos (youtu.be), shorts, embeds, links ao vivo ou um ID de vídeo bruto de 11 caracteres.

# Saída JSON com metadados
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"

# Texto simples (ideal para canalizar para processamento adicional)
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only

# Com timestamps
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps

# Idioma específico com cadeia de fallback
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en

Formatos de Saída

Após buscar a transcrição, formate-a conforme solicitado pelo usuário:

  • Capítulos: Agrupar por mudanças de tópico, gerar lista de capítulos com timestamps
  • Resumo: Visão geral concisa de 5 a 10 frases de todo o vídeo
  • Resumos de capítulos: Capítulos com um breve parágrafo de resumo para cada um
  • Thread: Formato de thread do Twitter/X — posts numerados, cada um com menos de 280 caracteres
  • Post de blog: Artigo completo com título, seções e principais conclusões
  • Citações: Citações notáveis com timestamps

Exemplo — Saída de Capítulos

00:00 Introdução — o apresentador abre com a declaração do problema
03:45 Contexto — trabalhos anteriores e por que as soluções existentes são insuficientes
12:20 Método principal — explicação passo a passo da abordagem proposta
24:10 Resultados — comparações de benchmark e principais conclusões
31:55 Perguntas e respostas — perguntas da audiência sobre escalabilidade e próximos passos

Fluxo de Trabalho

  1. Buscar a transcrição usando o script auxiliar com --text-only --timestamps via uv run python3.
  2. Validar: confirmar que a saída não está vazia e está no idioma esperado. Se estiver vazia, tentar novamente sem --language para obter qualquer transcrição disponível. Se ainda estiver vazia, informar ao usuário que o vídeo provavelmente tem transcrições desativadas.
  3. Dividir se necessário: se a transcrição exceder ~50 mil caracteres, dividir em partes sobrepostas (~40 mil com sobreposição de 2 mil) e resumir cada parte antes de fundir.
  4. Transformar no formato de saída solicitado. Se o usuário não especificou um formato, o padrão é um resumo.
  5. Verificar: reler a saída transformada para verificar coerência, timestamps corretos e completude antes de apresentar.

Tratamento de Erros

  • Transcrição desativada: informar o usuário; sugerir que ele verifique se as legendas estão disponíveis na página do vídeo.
  • Vídeo privado/indisponível: relatar o erro e pedir ao usuário que verifique a URL.
  • Nenhum idioma correspondente: tentar novamente sem --language para buscar qualquer transcrição disponível e, em seguida, informar o idioma real ao usuário.
  • Dependência ausente: executar uv pip install youtube-transcript-api e tentar novamente.

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

Habilidades Relacionadas