Communitygithub.com

hoodini/ai-agents-skills

Edite qualquer vídeo transformando-o em uma demonstração legendada — transcreva (qualquer idioma, padrão large-v3), apresente um transcript_review.txt para o usuário corrigir erros de transcrição ANTES da renderização, depois construa uma composição HyperFrames com rótulos de vidro líquido, fundo de bolhas líquidas, transições líquidas morph, texto opcional atrás do sujeito via remoção de fundo e renderize o vídeo final.

O que é ai-agents-skills?

Esta skill fornece um pipeline completo de edição de vídeo legendado, construído sobre a estrutura HyperFrames. Ela orquestra um fluxo de trabalho de 12 etapas que começa com a transcrição de áudio usando o modelo large-v3 do Whisper (suporta qualquer idioma, incluindo hebraico e inglês) e termina com a renderização de um vídeo final com efeitos visuais avançados. O ponto central da skill é a pausa obrigatória para revisão e aprovação da transcrição pelo usuário antes da renderização, garantindo legendas precisas. Além disso, oferece suporte a saídas nos formatos 16:9 (YouTube/horizontal) e 9:16 (TikTok/Instagram Reels/YouTube Shorts) a partir da mesma fonte 16:9 sem necessidade de regravação, usando um modo vertical que aplica um fundo desfocado com bolhas líquidas. A skill também inclui remoção opcional de fundo para inserir texto atrás do sujeito, correções automáticas para erros comuns do Whisper (especialmente em hebraico) e uma interface de revisão interativa que pode ser executada como um servidor web local ou como um editor de arquivo estático. Ela é ideal para criar tutoriais legendados, vídeos promocionais, reels ou qualquer conteúdo que precise de legendas sincronizadas com estilo profissional.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/video-edit

Perguntar na sua IA favorita

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

Documentação

Edição de Vídeo — Pipeline de Demonstração Legendada

Editor de vídeo legendado completo, baseado no HyperFrames. O usuário fornece um vídeo; você orquestra transcrição → revisão → renderização e SEMPRE pausa para aprovação da transcrição antes da renderização longa.

Onde esta skill se encaixa na pirâmide YUV.AI

video-edit está no nível intermediário da pirâmide de skills YUV.AI, ao lado de yuv-design-system, yuv-decks, yuv-viral-video, parallax-landing-page e video-to-landing-page. O orquestrador de nível superior yuv-pilot roteia para cá sempre que o usuário quer uma demonstração legendada, tutorial ou edição com locução e legendas.

Esta é a skill irmã, mais geral, de yuv-viral-video. A divisão:

  • yuv-viral-video — pipeline opinativo de vídeos virais curtos da YUV.AI (ritmo MrBeast, estilo editorial exclusivo)
  • video-edit — editor legendado geral com transcrição-revisão-antes-renderização (hebraico + inglês + qualquer idioma do Whisper)

Para vídeos legendados com a marca YUV.AI, combine esta skill com yuv-design-system (modo Neon para decisões de tipografia/paleta). Para vídeos legendados genéricos/de terceiros, esta skill funciona sozinha.

Quando invocar

  • Um caminho para um arquivo de vídeo (mp4/mov/mkv) + um pedido para "editar", "legendar", "adicionar legendas", "fazer um reel/promo", "fazer igual"
  • "Corrigir as legendas / erros de hebraico" — reentre na etapa de revisão em um projeto existente
  • Qualquer construção de tutorial / locução / promo legendado

Local de salvamento

Padrão: ~/Documents/yuv-projects/videos/<slug>/ — sempre salve projetos de vídeo legendado aqui para que as renderizações sejam encontráveis. O <slug> é curto, derivado do tópico ou nome do arquivo de origem.

mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# Inicialize o projeto aqui.

A renderização final é salva em ~/Documents/yuv-projects/videos/<slug>/renders/<name>_FINAL.mp4. Informe ao usuário onde o vídeo está ao final da renderização.


Fluxo de trabalho (12 etapas)

  1. Analisar a origem — ffprobe para dimensões, fps, duração, áudio.

  2. Estruturar — cd ~/Documents/yuv-projects/videos && npx hyperframes init <slug> --video <path> --non-interactive. Renomeie o vídeo copiado para source.mp4.

  3. Extrair áudio — ffmpeg -i source.mp4 -vn -ac 1 -ar 16000 audio.wav.

  4. Transcrever — copie references/transcribe.py para o projeto. Modelo padrão large-v3 (melhor hebraico). CUDA geralmente falha no Windows (falta cuDNN); o script usa fallback para CPU int8. Force language="he" para hebraico, language="en" para inglês; caso contrário, detecção automática.

  5. Aplicar correções conhecidas — copie o conteúdo de references/corrections-hebrew.md para um corrections.json na raiz do projeto (chaves = token errado, valores = token correto).

  6. 🛑 PARE — inicie o servidor de revisão e deixe o usuário aprovar em um webapp. Primeiro aplique as correções conhecidas: copie references/make_review.py para o projeto e execute python make_review.py. Ele aplica corrections.json a transcript.json.

    Em seguida, inicie o servidor de revisão como uma tarefa em segundo plano (ele bloqueia até que o usuário clique em "Aprovar e Renderizar" no navegador):

    python "$HOME/.claude/skills/video-edit/references/serve_review.py" .
    # No Windows: python "C:\Users\<você>\.claude\skills\video-edit\references\serve_review.py" .
    

    O servidor imprime uma linha como REVIEW_URL=http://localhost:PORT/. Pegue essa URL da saída da tarefa em segundo plano (ou leia o stdout) e envie ao usuário:

    👉 Revise sua transcrição aqui: http://localhost:PORT/ Quando clicar em Aprovar e Renderizar, continuarei automaticamente.

    O agente não precisa de uma mensagem "continuar" — quando o usuário clica no botão, o servidor escreve transcript_review.txt no diretório do projeto E sai com código 0. A notificação de tarefa em segundo plano do agente é acionada e o pipeline é retomado da etapa 8.

    Fallback se não houver navegador / servidor: abra o editor como um arquivo estático (start "" "$HOME/.claude/skills/video-edit/transcript-editor/index.html"), peça ao usuário para selecionar a pasta do projeto, editar, salvar transcript_review.txt de volta no projeto e responder "continuar". O editor suporta ambos os modos.

  7. (Opcional) Remoção de fundo — veja a etapa 7 abaixo; pode ser executada em paralelo com a revisão do usuário.

  8. Após a aprovação, execute python references/apply_review.py. Ele re-tokeniza as linhas editadas e redistribui os tempos das palavras de volta para transcript.json para que a sincronia das legendas ainda funcione.

  9. (Opcional) Remoção de fundo — se algum segmento com locução precisar de texto atrás do sujeito, extraia o segmento como outro.mp4 (ou intro.mp4) e execute npx hyperframes remove-background <clip>.mp4 -o <name>_subject.webm --quality best. Apenas CPU na maioria das configurações (~3–8 min para um clipe de ~15s em 1440p).

  10. Recodificar origem com keyframes densos — a renderização multi-worker trava em keyframes esparsos. Sempre execute:

    ffmpeg -y -i source.mp4 -c:v libx264 -preset medium -crf 18 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -pix_fmt yuv420p -movflags +faststart -c:a copy footage.mp4
    
  11. Recarregue a transcrição (editada) e gere a sub-composição do corpo via references/gen_body.py. O gerador emite o compositions/components/caption-body.html completo com estilo editorial + matriz alternados em pílulas de vidro líquido, ancorado no canto inferior esquerdo central (limpa os PiPs da webcam no canto inferior direito).

  12. Conecte o index.html do host a partir de references/host-template.html. Ordem das camadas (z-index, NÃO track-index):

    • z0: footage .cam-bg
    • z1: fundo de bolhas líquidas (compositions/liquid-blobs.html, mix-blend-mode: screen, duração total)
    • z2: legenda parallax atrás do sujeito (intro e/ou outro, quando a remoção de fundo é usada)
    • z3: recorte do sujeito .cam-out / .cam-sub (com data-media-start correspondente)
    • z6: legendas do corpo
    • z46: barra de progresso + flash + transição líquida morph
  13. Lint — npx hyperframes lint. Deve ter 0 erros. Correções comuns: conflito de transformação CSS/GSAP no elemento de transição (use xPercent/yPercent ou remova a transformação CSS); tweens sobrepostos na mesma propriedade (adicione overwrite: "auto").

  14. Renderizar — npx hyperframes render --quality standard --fps 30 --output renders/<name>_FINAL.mp4. "Standard" é o alvo de entrega correto — high aproximadamente dobra o tempo de renderização. Verifique com 6–8 quadros de verificação ao longo da linha do tempo antes de relatar a conclusão.

Saída vertical (9:16) para TikTok / Reels / Shorts

Quando o usuário solicitar saída vertical / retrato / TikTok / Reels / 9:16 (a partir de uma fonte 16:9):

  1. Clone o projeto para uma pasta irmã: cp -r project/ project-vertical/.
  2. Substitua seu index.html por references/host-template-vertical.html (tela 1080×1920, fundo desfocado com bolhas líquidas, a imagem 16:9 como uma faixa horizontal centralizada, legendas abaixo).
  3. Substitua seu gen_body.py por references/gen_body_vertical.py (pílula centralizada, fontes maiores, largura máxima mais estreita) e reexecute-o para emitir compositions/components/caption-body.html.
  4. Remova as sub-composições de recorte atrás do sujeito + parallax (o recorte está alinhado para 16:9; não vale a pena realinhar para v1). A composição vertical usa o fundo desfocado da origem + bolhas para atmosfera.
  5. Atualize data-duration para a duração real do vídeo. Atualize o texto do chip da marca em index.html (YUV.AI por padrão).
  6. Lint + renderize — mesmos comandos. A saída é 1080×1920. Publicação direta no TikTok / IG Reels / YT Shorts.

Para entregar ambos 16:9 e 9:16 de uma só vez, execute dois comandos de renderização (em projetos paralelos). A aprovação do transcript_review.txt se aplica a ambos — mesmas legendas, duas composições.

Regras críticas

  • Nunca renderize o final sem aprovação explícita da transcrição. A etapa de revisão é o ponto principal.
  • Para hebraico: large-v3 + language="he" + direction: rtl + Rubik (700 + 900 para ênfase editorial de peso duplo).
  • As pílulas de legenda sempre precisam de um fundo escuro opaco — texto claro sem fundo desaparece na interface branca do aplicativo.
  • Centralize as pílulas de legenda horizontalmente, mas desloque a coordenada x do centro para a esquerda (ex.: left: 720px) quando a imagem tiver um PiP da webcam no canto inferior direito.
  • O clipe de recorte atrás do sujeito DEVE ter data-media-start correspondente ao seu data-start (ou correspondente ao deslocamento da origem se o clipe foi extraído), senão o recorte reproduz a partir do quadro 0 e dessincroniza.
  • O webm remove-background mantém o RGB original e escreve apenas a máscara alfa — ffprobe relata yuv420p, que parece "sem alfa". Confirme via TAG:ALPHA_MODE=1 ou sobreponha sobre uma cor sólida.
  • Cartões de finalização/saída com texto gravado — NÃO coloque legendas sobre eles; eles colidem.

Referências de arquivos

ArquivoPropósito
transcript-editor/index.htmlEditor interativo no navegador — visualização de vídeo, edição RTL, aplicação de dicionário, sugestões opcionais de IA WebLLM, salva transcript_review.txt
references/setup.mdPré-requisitos + comandos de instalação para Node / Python / FFmpeg / faster-whisper
references/transcribe.pyTranscrição faster-whisper com fallback de CPU + timestamps de palavras
references/serve_review.pyServidor de revisão local — carrega automaticamente o editor, bloqueia até o usuário clicar em Aprovar e Renderizar, então escreve transcript_review.txt e sai (sinaliza o agente)
references/make_review.pyAplicar correções + emitir transcript_review.txt (fallback em modo arquivo)
references/apply_review.pyAnalisar o arquivo de revisão editado, redistribuir timestamps de palavras, atualizar transcript.json
references/gen_body.pyGerador do corpo da legenda (editorial + matriz em pílulas de vidro líquido)
references/host-template.htmlComposição do host 16:9 com efeitos líquidos + transição de wipe
references/host-template-vertical.htmlHost 9:16 (1080×1920) — layout para TikTok / Reels / Shorts: fundo desfocado, faixa de vídeo 16:9 centralizada, legendas abaixo, chip da marca no canto superior direito
references/gen_body_vertical.pyGerador do corpo da legenda ajustado para vertical (pílula centralizada, fontes maiores, largura máxima mais estreita)
references/liquid-blobs.htmlCamada de bolhas flutuantes com duração total
references/caption-parallax-outro.htmlModelo de legenda atrás do sujeito (inglês; clone para outros idiomas)
references/corrections-hebrew.mdErros comuns de transcrição do Whisper em hebraico
references/transcript-review-workflow.mdA etapa de pausa/aprovação em detalhes

Individual skills in this repo

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

hoodini/ai-agents-skills

Edit any selfie or screen-share footage into a viral short-form video in YUV.AI's signature style — Apple-style liquid-glass cards (real CSS backdrop-filter), dark-mode polish, MrBeast-paced cuts, video-title karaoke captions, premium GSAP motion graphics, no fake content, never covering the speaker's face. Hebrew is rendered in Rubik Black, English in Anton uppercase. Always renders BOTH 9:16 and 16:9 and always saves with _V<N> suffix for backups. Trigger when the user drops a path to an .mp4/.mov/.mkv and says "edit this", "make it viral", "turn this into a short", or any Hebrew equivalent (ערוך סרטון, סרטון ויראלי, להפוך לוויראלי, ריל, שורט). The pipeline is the COMBINATION of two skills: video-use (transcription + word-snapped cuts + base extraction) and hyperframes (HTML/CSS/GSAP visual composition + render). Do NOT use for podcast-only audio edits.

hoodini/ai-agents-skills

Yuval Avidani's YUV.AI brand and design system. Apply ONLY when YUV.AI-branded output is requested — presentations, decks, keynotes, portfolio, brand site, profile, speaker bio, brand assets, or any prompt mentioning YUV.AI / "my brand" / "my deck" / "my site" / "for me". Do NOT auto-trigger on generic "build a game / web app / dashboard / landing page" without YUV.AI context — those use whatever palette fits. Three modes; NEON (hot pink #FF1464 + neon cyan #00E5FF + white, DEFAULT for YUV.AI web, apps, games, dashboards, social, general visual work); DECKS (Fly High purple/yellow/grey, presentations and slides ONLY); Warm Editorial (pink/yellow/bone for Hope, Marcus, bigcats.ai, practical.yuv.ai). Universal Fly High throughline across all modes; flight/progress motifs (HUD strips, dials, "Let's Fly High" tagline, phoenix mark). Anton + Inter (EN), Rubik + Assistant (HE), letter-spacing 0 default. Bundled brand assets, canonical socials, credentials. Project brand wins if specified.

hoodini/ai-agents-skills

Yuval's all-in-one AI video pipeline. Turns an idea/script into a finished, on-brand MP4 by orchestrating HyperFrames (HTML→deterministic video render), Lottie (branded motion graphics), ManimCE (math / neural-network / concept animations), and a transcribe→approve caption flow — all wrapped in the YUV.AI Neon Phoenix brand via a frame.md. Use whenever Yuval wants to make, edit, or explain something as a video: promo, explainer, launch, social reel, "make a video about X", "explain X as a video", "neural network animation", "turn this into a video", captioned tutorial, 16:9 or 9:16. Triggers: video, explainer, promo, reel, manim, lottie, hyperframes, animation, "make a video", "explain ... as a video", מצגת וידאו, סרטון, הסבר וידאו. Routes each beat to the right engine, wraps in brand, self-verifies, and renders.

hoodini/ai-agents-skills

Build a premium cinematic landing page with mouse-scrub video hero and brand-driven narrative-arc sections. Use whenever the user provides a hero video plus a product / subject / brand and wants a landing page, promo site, product showcase, marketing page, or storytelling site. Works for any language (RTL or LTR — Hebrew, English, Arabic, Spanish, French, Japanese, etc.) and any subject (food, tech, animals, fashion, services, SaaS, wildlife campaigns, music releases, books, real estate). The signature effect is mouse-driven video scrubbing — the hero video lives across the entire page as a fixed backdrop, and moving the mouse left-right scrubs the video timeline so the subject responds to the cursor. Below the hero, 4-5 fully-opaque sections each carry their own brand identity (color, typography emphasis, layout pattern) and walk the viewer through a narrative arc (e.g. longing → joy → nostalgia → contemplation → action). Triggers on phrases like "build a landing page from this video", "cinematic landing ...

hoodini/ai-agents-skills

Build a scroll-driven cinematic landing page from a short video. The user provides a 5–15 second video (often AI-generated); this skill extracts every frame at HD JPEG quality, then produces a single-hero HTML page where the user's scroll gesture scrubs the frames in place (the page itself never scrolls) and 5 dramatic text overlays crossfade in/out — Google Anton headlines, Caveat handwritten accents, locked body, virtual scroll. Use this skill whenever the user wants to "turn this video into a landing page", "make a scroll-scrub landing page", "build a parallax hero from this clip", "add a new landing page to the parasites showcase", "do the same as github/lion/hope for this new video", or any variant that pairs a short clip with dramatic scroll-triggered storytelling. Trigger even if the user only says "use my video for a landing page" — that is this skill.

hoodini/ai-agents-skills

Turn any video into a cinematic scroll-driven landing page — Apple-style hero where scrolling progresses the visible frame through the video. Use when the user provides a video file and asks for "a landing page from this video", "scroll-frame website", "Apple-style scroll site", "hero that scrubs the video", "like the GitHub Copilot landing", or any equivalent. Extracts N evenly-spaced frames via ffmpeg, builds a self-contained HTML page with a sticky hero + JS scroll listener that swaps the visible frame as you scroll, plus headline, sections and CTA below. For YUV.AI projects, applies the yuv-design-system skill in Neon mode (pink/cyan/white, default for YUV.AI web) — Decks (purple/yellow) is reserved for slides only. For generic / non-YUV.AI projects, picks an appropriate palette per the source video. Output is one folder with `index.html` and a `frames/` directory — drop on any static host.

hoodini/github-trending

Fetch and display GitHub trending repositories and developers. Use when building dashboards showing trending repos, discovering popular projects, or tracking GitHub trends. Triggers on GitHub trending, trending repos, popular repositories, GitHub discover.

hoodini/mongodb

Work with MongoDB databases using best practices. Use when designing schemas, writing queries, building aggregation pipelines, or optimizing performance. Triggers on MongoDB, Mongoose, NoSQL, aggregation pipeline, document database, MongoDB Atlas.

hoodini/owasp-security

Implement secure coding practices following OWASP Top 10. Use when preventing security vulnerabilities, implementing authentication, securing APIs, or conducting security reviews. Triggers on OWASP, security, XSS, SQL injection, CSRF, authentication security, secure coding, vulnerability.

Habilidades Relacionadas