Communitygithub.com

avenoxai/avenoxskills

Avenox Studio — pipeline local-first de produção de vídeos para YouTube (ROTEADOR, leia primeiro). Use para QUALQUER solicitação de edição, corte, produção, montagem, legendagem, trilha sonora ou renderização de vídeo longo, ou para criar motion graphics. Integra ferramentas open-source (auto-editor, mlx-whisper, MLT/melt, ffmpeg) e HyperFrames para gráficos animados. Gatilhos: "editar este vídeo", "cortar a gravação", "criar gráficos", "extrair legendas", "renderizar o final", um nome de job ou qualquer coisa sobre o pipeline de vídeo. O humano é o diretor/controle de qualidade; o agente é o operador.

O que é avenoxskills?

A Avenox Studio é um kit de ferramentas local-first para produção de vídeos longos no YouTube, operado por agente de IA. Ela substitui editores baseados em nuvem por um pipeline totalmente local, usando ferramentas open-source como auto-editor para cortes silenciosos, mlx-whisper para transcrição local, MLT/melt para montagem de projetos, ffmpeg para renderização e HyperFrames para motion graphics animados. O fluxo de trabalho segue 7 etapas: captura, corte bruto, criação de gráficos, montagem, legendas, trilha sonora e exportação. Cada etapa pode ser acionada por comandos naturais como "editar este vídeo" ou "renderizar o final". A principal regra é o ciclo de diretor: o agente produz previews rápidos para aprovação humana antes de renderizar finais, evitando desperdício de horas em cortes rejeitados. O pipeline respeita restrições de marca rígidas (definidas em brand/frame.md) e formatação YouTube 16:9 1080p60. A ferramenta é compatível com macOS (com aceleração de hardware e Apple Silicon para mlx-whisper) e parcialmente com Linux. O agente usa scripts em bash, Python e Node para executar cada etapa, e o humano mantém apenas o cérebro (especificações, planos edit.json) fora das pastas de mídia pesada para evitar corrupção de sincronização em nuvem.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/avenoxai/avenoxskills/tree/HEAD/skills/avenox-video

Perguntar na sua IA favorita

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

Documentação

Avenox Studio — roteador do operador

Guia rápido do operador para um pipeline de vídeo local-first operado por agente. Tudo roda na sua própria máquina: sem editor em nuvem, sem upload para renderizar.

O humano dirige e aprova a qualidade; o agente opera o pipeline.

Configuração

export STUDIO_JOBS="$HOME/video/projects"   # mídia pesada fica aqui
export STUDIO_ROOT="/caminho/para/este/repo"     # scripts, templates, marca

Requisitos: macOS (codificação de hardware via h264_videotoolbox; Apple Silicon para mlx-whisper), ffmpeg, python3, melt/MLT, Node (para HyperFrames). A maior parte funciona no Linux com libx264 e uma compilação CUDA do whisper substituída.

Princípios operacionais

  1. Disciplina de mídia. Mídia pesada NUNCA em uma pasta sincronizada com nuvem — a sincronização vai travar em intermediários de vários GB e pode corromper escritas em andamento. Os jobs ficam em $STUDIO_JOBS/<job>/ (raw/ cut/ graphics/ audio/ outputs/). Seu sistema de anotações guarda apenas o cérebro: este sistema, a especificação de marca, os planos edit.json.
  2. Loop do diretor. Produza um preview (stills dos gráficos + uma renderização rápida do rascunho) → envie para anotações → só então renderize o final. Nunca envie um final sem aprovação. Esta é a regra mais importante; um agente que renderiza finais não revisados queimará horas em um corte rejeitado.
  3. Marca é uma restrição rígida, não uma sugestão. Leia marca/moldura.md antes de criar qualquer gráfico. Defina uma vez e tranque. (A implementação de referência é deliberadamente anti-"AI slop": editorial premium, papel quente + tinta + um único acento, sem neon/gradiente/glassmorfismo/brilho-3D.)
  4. Formato: YouTube 16:9 1080p60. Predefinição em marca/presets/youtube-16x9.json.
  5. Finalização é híbrida. Gere o rascunho automaticamente; o mesmo .mlt abre no Kdenlive ou Shotcut para finalização manual. Não tente automatizar o gosto.
  6. Transcrição padrão é LOCAL mlx-whisper com whisper-large-v3-turbo — rápida, gratuita e forte em áudio não-inglês. Observe que a maioria dos proxies de roteamento de LLM não expõe endpoint whisper; se for remoto, use uma API de fala dedicada.

Scripts (scripts/)

ScriptFaz
autocut.sh IN.mp4 [balanced|aggressive|conservative]corte silencioso → _cut.xml (Premiere) ou variantes --export
transcribe.py IN.mp4 PREFIXO→ transcricao/PREFIXO_timed.json + _narration.txt
mltgen.py edit.json out.mlt --base <dir-job>lista de edição → projeto MLT (Kdenlive/Shotcut/melt)
vrender.sh project.mlt out.mp4 [fast|quality]renderizar (fast = rascunho HW, quality = master CRF18)
grabshot.shcaptura de tela da área de transferência → disco
slides2png.shslides estáticos legados — prefira HyperFrames
remove-silence.pypassagem de silêncio independente

As 7 etapas

  1. Captura — copie o raw → $STUDIO_JOBS/<job>/raw/. Confirme o briefing e quais segmentos realmente importam.
  2. Corte bruto — autocut.sh raw.mov balanced → cut/screen_cut.mp4; transcribe.py para o roteiro. Receita completa → habilidade avenox-roughcut.
  3. Gráficos — HyperFrames. Roteie pela habilidade hyperframes → geralmente motion-graphics (trechos curtos), faceless-explainer (trechos de conceito) ou general-video. Leia marca/moldura.md primeiro; renderize MP4s animados em graphics/. Receita completa → habilidade avenox-graphics.
  4. Montagem — escreva edit.json (modelo em templates/edit.json) misturando cut/*.mp4 + graphics/*.mp4 + música → mltgen.py edit.json project.mlt --base <dir-job>.
  5. Legendas — transcribe.py → .srt; aplique marca/caption-corrections.json (copie de caption-corrections.example.json — um mapa de localizar/substituir para termos que seu ASR corrompe consistentemente). Envie como CC do YouTube, não embutido.
  6. Música — base sob tudo, sidechain-duck sob a voz, alvo ~-14 LUFS. Atribuição de trilha em CREDITS.md.
  7. Exportação — vrender.sh project.mlt draft.mp4 fast → revisão do diretor → vrender.sh … final.mp4 quality → podar arquivos temporários.

Padrão de qualidade dos gráficos

Os clipes HyperFrames devem obedecer a marca/moldura.md. Prefira movimento tipográfico, contido e com peso. Se uma batida não precisar de movimento, um quadro estático limpo é suficiente — não anime por animar.

Referência

  • Corte bruto: avenox-roughcut · Gráficos: avenox-graphics
  • Habilidades HyperFrames: hyperframes (roteador), hyperframes-cli, hyperframes-animation, hyperframes-creative, motion-graphics, faceless-explainer, general-video
  • Especificação de marca: marca/moldura.md (preencher a partir de marca/moldura.template.md)

Habilidades Relacionadas