O que Video Ninja faz?
Jump Skill — Orquestrador mestre que roteia tarefas de vídeo para 79 habilidades globalmente instaladas de 10 repositórios e uma fonte bem conhecida, habilidades de Anatomia e edição do DaVinci Resolve de repositórios sincronizados localmente, mais uma camada de metodologia destilada do pipeline My-Little-Studio.
Este ninja roteia qualquer tarefa de vídeo para as habilidades instaladas ou sincronizadas localmente. É o ponto de entrada obrigatório: leia-o antes de escolher uma habilidade de vídeo.
Por que este ninja existe
Os dez repositórios de origem globalmente instalados cobrem renderização, processamento de mídia, craft, frameworks, bibliotecas de animação, estilos de arte e subsistemas gráficos 3D, mas cada um é um silo. HyperFrames pode renderizar vídeo, mas não tem opinião sobre qualidade. motion-video-kit tem uma doutrina de qualidade, mas não tem renderizador. Remotion é um framework alternativo, não um plug-in para HyperFrames. opus-video-skills traz looks distintos como aquarela e tipografia cinética, mas não a doutrina de craft dos outros repositórios. ffmpeg-skill trabalha em filmagens existentes; não constrói composições do zero. gsap-skills ensina padrões corretos de GSAP, mas não é um motor de vídeo. dotlottie-web lida com ativos Lottie, mas não os compõe em vídeo. O pacote Three.js fornece subsistemas gráficos 3D avançados, mas não planeja nem entrega um filme.
Este ninja é a camada que escolhe e conecta eles, e mantém o controle do que ainda falta no ecossistema.
A regra de ouro
/hyperframesé o ponto de entrada padrão para criação e composição de vídeo. Ele escolhe entre os 10 fluxos de trabalho e carrega habilidades de domínio conforme necessário. Para edições de filmagens que devem ser construídas no DaVinci Resolve Studio, use a rota opcionalvideo-editor-skills. Este ninja não substitui o roteamento do HyperFrames; ele informa qual camada usar e quando o HyperFrames sozinho não é suficiente.
Para criação, animação, composição e renderização de vídeo, comece com /hyperframes. Para uma linha do tempo de talking-head, vlog ou aula que deve ser construída no Resolve Studio, use a rota controlada video-editor-skills. Outras exceções incluem Remotion, captura de tela, doutrina de craft, métodos de pipeline e o steer do YouTube Video em references/youtube-video.md.
Os repositórios de origem globalmente instalados
| Repositório | Habilidades | Camada | Status |
|---|---|---|---|
heygen-com/hyperframes | 27 | Renderizador + habilidades de domínio | Instalado, Apache-2.0 |
kajisho5/ffmpeg-skill | 1 (42 ferramentas) | Processamento de mídia | Instalado, MIT |
echris6/motion-video-kit | 1 | Doutrina de qualidade | Instalado, MIT |
remotion-dev/skills | 12 | Framework alternativo | Instalado |
Rieranthony/product-film-skill | 1 | Captura de tela | Instalado, MIT |
tugrawork-creator/saas-motion-kit | 1 | Variedade e antirrepetição | Instalado |
tuzhechen2005/opus-video-skills | 2 | Estilos de arte processual | Instalado, MIT |
greensock/gsap-skills | 8 | Habilidades oficiais GSAP: timelines, ScrollTrigger, plugins, React | Instalado, MIT |
LottieFiles/dotlottie-web | 1 | Player Lottie moderno: Rust+WASM, máquinas de estado, temas | Instalado, MIT |
scottstts/Threejs-Awesome-Graphics-Agent-Skills | 24 | Subsistemas gráficos Three.js avançados | Instalado por seu próprio instalador; excluído da sincronização (~261 MB), MIT |
A proveniência das habilidades globalmente instaladas é registrada em ~/.agents/.skill-lock.json. O pacote Three.js é a exceção: seu próprio instalador (npx threejs-awesome-graphics-agent-skills@latest install --agent universal) instala em ~/.agents/skills/ sem uma entrada no lockfile. fframes-video é instalado separadamente através de fframes.studio.
Habilidades de origem sincronizadas localmente
| Repositório | Habilidade | Função | Licença |
|---|---|---|---|
wheresryan22/anatomy | anatomy | Figuras técnicas isométricas para explicadores | MIT |
appariciojunior/video-editor-skills | 12 habilidades | Edição opcional de primeira passagem no DaVinci Resolve Studio | CC BY-NC 4.0; apenas uso não comercial |
Ambos são declarados no repos.md raiz e sincronizados em repos/video-ninja/ para que o Ninja possa carregar suas instruções quando necessário. Veja references/repos.md.
Bibliotecas de estilo de filme e o kit de personagens
| Repositório | O que adiciona | Como o Ninja usa | Licença |
|---|---|---|---|
lemomo-ai/lemo-opuscar | 66 estilos de filme feitos em código, cada um com um filme de demonstração, STYLE.md e um guia do diretor | Através da habilidade lemo-opuscar (plugin Claude), que mantém sua própria biblioteca esparsa em ~/lemo-opuscar. Não sincronizado (~195 MB) | Código MIT; filmes de demonstração CC BY 4.0 |
Vincentwei1021/mg-styles-15 | 15 estilos de motion design com prompt completo, fonte, renderizador e rubrica de revisão | Checkout esparso de prompts/, harness/ e lib/ sob demanda. Não sincronizado (~1,2 GB) | MIT |
JohnHeibel/ClaudeAnimationBase | Kit de personagens pintados à mão p5.brush: 31 emoções, vistas, gestos, chapéus, revisão de contact sheet | Sincronizado localmente em repos/video-ninja/ClaudeAnimationBase/; leia seu ANIMATION_GUIDE.md | MIT; Clawd apenas em vídeos sobre Claude, caso contrário seu próprio personagem |
Famílias, estilos, etapas de instalação e notas de licença: references/film-families-and-styles.md.
Habilidade instalada separadamente
| Fonte | Habilidade | Função | Instalação |
|---|---|---|---|
fframes.studio | fframes-video | Renderizador Rust/SVG alternativo com GPU Skia, FFmpeg e QA legível por agente | Bem conhecido, instalado globalmente |
Ferramentas externas avaliadas que não estão instaladas
| Fonte | Função | Quando considerar | Status |
|---|---|---|---|
m-bain/whisperX | ASR local com timestamps em nível de palavra e diarização | Trabalho de talking-head, entrevista ou podcast que precisa de temporização de palavras ou identificação de falante | Backend opcional; não instalado. Veja references/whisperx.md |
airbnb/lottie-web | Player para animações Lottie do After Effects | Reutilizar um ativo Lottie .json fornecido pelo projeto em uma composição HyperFrames | Dependência sob demanda; não instalado pelo Ninja. Veja references/lottie.md |
ManimCommunity/manim | Motor Python para animação matemática | Explicadores matemáticos recorrentes que justificam outro renderizador e adaptador | Avaliado, não instalado. O tweet linka para 3b1b/manim (ManimGL). Veja references/repos.md |
rive-app/rive-wasm | Animações interativas com máquinas de estado nativas | Projeto tem ativos .riv do Rive Editor, ou precisa de animações que reagem ao estado do aplicativo | Dependência sob demanda. Veja references/rive.md |
goldfire/howler.js | Controle de áudio web: sprites, fades, áudio espacial | Efeitos sonoros com temporização precisa, sprites de áudio, áudio posicional 3D | Dependência sob demanda. Veja references/howler.md |
vercel/satori | JSX → SVG para cards de título e miniaturas | Gerar em lote cards de título, miniaturas ou gráficos com muito texto a partir de dados | Dependência sob demanda. Veja references/satori.md |
Anatomia produz um ativo visual ou cena, não o vídeo final. Sua fonte é sincronizada em {{JUMP_SKILLS_DIR}}/repos/video-ninja/anatomy/; leia o SKILL.md desse repositório ao rotear para ele. Construa e inspecione a figura, depois traga a saída para dentro de /hyperframes e siga a doutrina de movimento, composição e renderização. Se o caminho estiver faltando, trate Anatomia como indisponível e use o fallback descrito em references/anatomy.md.
Não assuma que WhisperX ou Manim está instalado ou disponível. Lottie é um formato de ativo: carregue seu player apenas quando o projeto já incluir esse tipo de animação.
Documentação de referência adicional
As seguintes ferramentas estão documentadas na pasta references para uso sob demanda:
| Ferramenta | Referência | Caso de uso |
|---|---|---|
| Rive | references/rive.md | Animações interativas com máquinas de estado; alternativa ao Lottie quando o projeto tem ativos .riv |
| Howler.js | references/howler.md | Controle de áudio web: sprites, fades, áudio espacial; complementa /hyperframes-audio |
| Satori | references/satori.md | JSX → SVG para cards de título, miniaturas, imagens OG; geração em lote de gráficos de texto |
| YouTube Video | references/youtube-video.md | Talking-head bruto editado em um vídeo polido do YouTube com motion graphics explicativos |
Essas ferramentas não são habilidades instaladas, mas estão documentadas para quando suas capacidades específicas são necessárias. A linha YouTube Video é um steer de pipeline, não uma biblioteca.
Mais cinco steers de pipeline cobrem ferramentas de ativos usadas durante a produção de gráficos para uma composição: excalidraw.md (diagramas desenhados à mão como ativos de vídeo), penpot.md (fonte de design open source com um MCP oficial), fontsource.md (fontes auto-hospedadas para renderização determinística), lucide.md (conjunto de ícones de IU), e svgo.md (otimização SVG segura para animação). Nenhum deles instala uma habilidade.
Mapa de motores
A imagem de origem mistura motores de composição, frameworks de projeto e um editor de arquivos. Use essas distinções antes de escolher um fluxo de trabalho:
| Motor | Como funciona | Quando escolher | Status no Ninja |
|---|---|---|---|
| HyperFrames | HTML/CSS/JS em Chrome headless + FFmpeg | Novas composições, motion design e vídeo dirigido por agente | Padrão, instalado |
| ffmpeg-skill | Sondar → editar → validar arquivos existentes | Cortar, unir, normalização de áudio, multicâmera e entrega | Processamento, instalado |
| fframes-video | Rust/SVG por quadro, GPU Skia, FFmpeg e CLI de inspeção | Renderização vetorial de alto rendimento, trabalho em lote e revisão automatizada | Motor alternativo, instalado |
| Remotion | React/TypeScript, renderização local ou Lambda | Projetos React existentes, portas de composição ou renderização distribuída | Framework alternativo, instalado |
| Motion Canvas / Revideo | Geradores TypeScript; Revideo adiciona um player React, renderização headless e entradas dinâmicas | Motion Canvas para animação vetorial baseada em editor; Revideo para templates parametrizados e renderização Node/serverless | Avaliado; nenhuma habilidade instalada |
| MoviePy | Clipes Python, composições e efeitos de quadro | Pipelines Python orientados a dados ou protótipos de composição | Avaliado; nenhuma habilidade instalada |
| Manim Community Edition | Python para animação matemática programática | Explicadores recorrentes sobre matemática, gráficos ou geometria | Avaliado; nenhuma habilidade ou adaptador instalado |
Não apresente Motion Canvas, Revideo, MoviePy ou ManimCE como capacidades instaladas até que uma habilidade defina roteamento, um contrato de renderização e verificação. Se um projeto já usar uma dessas ferramentas, o Ninja pode mantê-la e aplicar a mesma doutrina de movimento, áudio e validação.
Verifique a licença do Remotion antes da produção: seu código é source-available, e a licença gratuita cobre indivíduos e organizações de até três pessoas. Equipes maiores ou uso automatizado podem exigir uma Licença Corporativa. Não o descreva como MIT ou open source aprovado pela OSI.
Roteamento
Passo 1 — Isso é realmente uma tarefa de vídeo?
Se não for uma tarefa de vídeo, este ninja não se aplica:
| Solicitação | Roteie para |
|---|---|
| Site/aplicativo | impeccable, apple-design |
| Animação de IU apenas (não um vídeo) | animate, improve-animations (pacote Emil Kowalski) |
| Cópia de marketing ou script apenas | copywriting, social |
Passo 2 — Roteie por entregável
Deixe /hyperframes escolher entre os 10 fluxos de trabalho. Sua tabela de prioridades é autoritativa. Este ninja só precisa identificar a camada a adicionar:
| Solicitação | Fluxo de trabalho | Camada adicional do Ninja |
|---|---|---|
| Legenda em talking-head | /embedded-captions | + /captions-overlay |
| Cards de overlay em podcast | /talking-head-recut | + /cut-the-curve |
| Promo de produto ou URL | /product-launch-video | + /motion-doctrine, /seam-craft, §Lançamento de produto |
| Vídeo semanal de changelog | /changelog-video | — |
| Gravação de tela → demo | /product-film (habilidade dedicada) | Veja §Remotion |
| Filme de negócios (live action, IA, premium) | /business-motion-film | Veja §Doutrina |
| Promo SaaS antirrepetição | /saas-motion-video | Veja §Doutrina |
| Desenho animado em aquarela / vídeo com letra de karaokê | /painted-animation | Veja §Estilos de arte |
| Showreel / portfólio de tipografia cinética | /kinetic-reel | Veja §Estilos de arte |
| Explicador técnico com um mecanismo ou objeto isométrico | Anatomia (quando sincronizado) | Leia seu SKILL.md local, construa e inspecione SVG/HTML; traga o ativo para dentro de /hyperframes para composição e renderização. Veja references/anatomy.md |
| Edição de talking-head, vlog ou aula no DaVinci Resolve Studio | video-editor-skills (quando sincronizado e a licença permitir) | Leia seu skills/edit-video/SKILL.md local; verifique scripts do Studio e o uso comercial |