Communitygithub.com

Malik-rgb43/workflow-de-edição

Entrega um vídeo aprovado como várias saídas (outras proporções, variantes de gancho, versões de plataforma, sem música/legendas) ou processa vários vídeos em paralelo, com um mix compartilhado, nomenclatura estrita e um manifesto que bloqueia derivados desatualizados.

O que é workflow-de-edição?

Esta skill transforma um único mestre de vídeo aprovado em múltiplas saídas (diferentes proporções, variantes de gancho, versões sem música ou sem legendas) sem perder o controle sobre a origem de cada arquivo. Ela gerencia toda a matriz de variantes, o congelamento do mestre, as cópias re-layout, o mix de áudio compartilhado, a nomenclatura, a fila de renderização única e as regras de supervisão de agentes. A skill não projeta o mestre (isso é feito pela skill de tipo) e não substitui a QA por arquivo (`render-qa-deliver`). É suportada em plataformas como Claude Code, Cursor e Codex, e é especialmente útil para criadores de conteúdo que precisam distribuir o mesmo vídeo em várias plataformas e formatos com consistência total de áudio e layout.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/multi-video-variants

Perguntar na sua IA favorita

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

Documentação

multi-video-variants

Transforma UM mestre aprovado em N saídas sem perder o controle de qual arquivo veio de qual estado fonte. É dona da matriz de variantes, do congelamento do mestre, das cópias re-layout, do mix compartilhado, da nomenclatura, da fila de uma renderização por vez, das regras de supervisão de agentes e do portão do manifesto. Ela não projeta o mestre (a skill de tipo faz isso) e não substitui a QA por arquivo (render-qa-deliver).

Regras que estão acima do resto deste arquivo

  1. Mestre primeiro, depois congelado. Derivados são feitos apenas a partir de um mestre que passou sua própria QA completa e foi registrado com manifest_check.py freeze. Uma correção necessária depois é feita no MESTRE, registrada com change, levada para cada cópia na mesma rodada, e TODO derivado é re-renderizado e re-registrado. Corrigir apenas uma cópia é proibido.
  2. Re-layout, nunca crop. Cada proporção é uma cópia da fonte mestre (hf_9x16/, hf_1x1/ ...) com sua própria tela, zonas seguras, escala de tipo, trilho de legendas, chaves de câmera e centralização de rosto. Um crop ou escala FFmpeg de um mestre renderizado não é uma variante.
  3. Um mix. Re-layouts e variantes de gancho usam o mesmo cues.js e os mesmos bytes de assets/mix.wav e são multiplexados a partir desse único arquivo; o áudio não é reconstruído por variante. Uma variante que realmente precisa de seu próprio mix (sem música, narração própria, corte de duração) declara isso no manifesto com um motivo.
  4. Um trabalho pesado por vez em toda a máquina (render, check, matte, ASR, Blender) sob render_lock. Trabalho paralelo é limitado a tarefas não pesadas (layout, spec, leitura de QA). No máximo 4 agentes em paralelo, cada um com no máximo 2 sub-agentes.
  5. "Pronto" é computado, não afirmado. A palavra é permitida apenas quando manifest_check.py check sai com 0. Um timeout, pasta vazia, hash ausente, qa: not_run ou evidência ausente é blocked / INSUFFICIENT_EVIDENCE, nunca pass.
  6. Nenhuma ação paga sem paid-generation-gate; nunca mensagem outra sessão Claude; restrições de usuário e projeto substituem este procedimento. Zonas seguras, -14 LUFS e telas são house preset v1 (decisão padrão Q5), não lei da plataforma.

Entradas -> Saídas

In: mestre aprovado (hf/, PROMPT.md, DESIGN.md, cues.js, assets/mix.wav) e a matriz de variantes da intake. Out: final/<nome>_<plataforma>_<gancho>_<proporcao>.mp4 x N, final/manifest.json (finals + manifesto apenas), relatórios de QA por arquivo sob _work/qa/<proporcao>/<rodada>/, _work/agents/<agent>.progress.md, _work/STATE.md (fila). Nomeação: <nome>_<plataforma>_<gancho>_<proporcao>.mp4, <nome> um slug ASCII minúsculo (underscores permitidos), <plataforma> = meta|tiktok|yt|ig|linkedin|x|all, <gancho> = master | hookA | hookA-nomusic | hookA-nocaps, <proporcao> = 9x16|4x5|1x1|16x9. Também aceito: a forma curta por proporção <nome>_<proporcao>.mp4 (plataforma all, gancho master, como no playbook de entrega). Um nome que o usuário pediu no ledger substitui a convenção e é registrado com seu ledger id (record --name-ledger-id).

Procedimento

#EtapaFaçaArtefato
0Matriz na intakeuma linha de ledger por arquivo: proporção, plataforma, rota (orgânico / ad / spark), gancho, versão (completa, sem música, sem legendas, duração), proporção mestre. Proporções "talvez" tardias: escreva notas de layout agora para que um pedido tardio seja um agente, não uma reconstrução (references/variant-matrix-and-layout.md)matriz em PROMPT.md <inputs>; lista matrix no manifesto
1Portão do mestremestre aprovado, QA de todos os quadros do render-qa-deliver passou, manifest_check.py freeze <project> --hf hf --matrix ...src_hash congelado + mix_sha256
2Cópias re-layoutum agente por proporção em uma CÓPIA; mesmos cues e mix; preencha a tabela de layout (o que mudou por elemento, references/variant-matrix-and-layout.md); preflight 0 erros; snapshot overlay no gancho, oferta, cartão final (--describe false, no máximo 5 timestamps por chamada)hf_<proporcao>/, _work/qa/<proporcao>/layout.md
3Variantes de gancho / versãogancho = sub-composição vinculada a variáveis na cópia da proporção, uma linha por variante; teste UMA variação primeiro (variáveis de lote não são testadas em um projeto); multiplexe o mix compartilhado; sem música / sem legendas = mix declarado ou variantes de camadarows.json, arquivos de variante
4Filaescreva a ordem de renderização em _work/STATE.md (mestre, depois cada proporção, depois variantes); manifest_check.py stamp ANTES de cada render; renders através de hf_deliver / render_lock run um de cada vez; um dono de render nunca inicia um segundo trabalho pesadolog de lock, stamps
5Registroapós cada render: record (hashes, correções mestre aplicadas, variante de mix, estado QA, loudness medido no arquivo FINAL)manifest.json
6QA por saídaframe_qa, caption_qa --band <top>:1450 (9:16), motion_qa se layout mudou movimento, face_center audit para filmagem de locutor, qa delivery; eixos de revisão visual apenas 1 (composição/crop) e 4 (legibilidade); eixos 2-3 herdados a menos que movimento tenha mudadorelatórios + caminhos de evidência
7Portão de prontomanifest_check.py check <project> --json sai com 0; mostre ao usuário a lista de arquivos com hash fonte, estado QA, LUFS/TP; liste lacunas honestamenteRelatório PRONTO
8Aprenderlinhas de ledger de timing por arquivo, lições para a Inbox_work/timing_ledger.jsonl

Portões

Estados são pass | fail | blocked | n/a com um motivo. Um timeout, amostra vazia ou entrada ausente é blocked, nunca pass. Uma chamada de ferramenta bem-sucedida é evidência de execução; um render visualizado é evidência de aparência.

PortãoPredicadoEvidênciaSe falsoDonoRevisar quando
G1 matriztoda saída tem uma linha de ledger (proporção, plataforma, rota, gancho, versão) antes de qualquer construçãomatrix em PROMPT.md e manifestopergunte o eixo ausente agora; não construaesta skill + video-intakequalquer novo pedido de proporção/variante
G2 mestre congeladomestre passou QA completa; freeze registrado; nenhum derivado iniciado antesmanifesto master.src_hash, frozen_utc mais antigo que todo stamppare derivados; congeleesta skillqualquer mudança na fonte mestre
G3 re-layoutcada derivado tem sua própria tela raiz, linha de layout por elemento, zonas seguras de sua proporção; nenhum render mestre cortadolinhas layout.md + snapshots overlay + preflight 0 Ere-layout do elemento falho; não escale o quadro inteiroo agente da proporçãomudança no layout mestre, nova cópia
G4 ativos compartilhadoscues.* e assets/mix.wav idênticos ao mestre em toda cópia de re-layout/gancho; variantes de gancho multiplexam, não re-mixammanifest_check.py check: sem M035/M041copie cues/mix do mestre de volta; re-renderizeesta skillmudança de cue ou mix mestre
G5 QA por saídacada arquivo qa: pass com um arquivo de evidência e LUFS -14 +/- 0.5, TP <= -1 no arquivo final (portão da casa)caminho qa_evidence, números lufs, tp no manifestocorrija e re-renderize APENAS aquele arquivorender-qa-deliverqualquer re-render
G6 disciplina de trabalho pesadoexatamente um trabalho pesado por vez; <= 4 agentes, cada um <= 2 sub-agentes, cada um com lista de arquivos, arquivo de saída, prazo, arquivo de progressolog render_lock; mtimes de _work/agents/*.progress.mdenfileire, pare o trabalho extra (apenas sua própria árvore de processos)esta skillcada lançamento de agente
G7 manifesto prontodesatualizado / órfão / ausente / alterado-após-render todos ausentesmanifest_check.py check sai com 0liste os arquivos falhos para o usuário; re-renderize os desatualizadosmanifest_check.pyantes de dizer "pronto", após qualquer mudança

Números (house preset v1, datado de 2026-10-02, detalhes em references/house-presets.md)

  • Telas: 9:16 1080x1920, 4:5 1080x1350, 1:1 1080x1080, 16:9 1920x1080; H.264 SDR yuv420p, AAC 48 kHz, 30 fps padrão.
  • Zonas seguras, texto-chave/CTA/logo/preço: 9:16 topo 300 / fundo 672 (y <= 1248) / esquerda 140 / direita 192, trilho de legendas fundo <= y 1450; 16:9 x <= 1824, topo 54, fundo 162; 4:5 e 1:1 54 px cada lado. Não verificado em dispositivos: execute o exercício de overlay.
  • Loudness: -14 LUFS integrado +/- 0.5, pico verdadeiro <= -1 dBTP, medido no arquivo final; mix intermediário TP <= -1.5.
  • Supervisão: verificação de batimento cardíaco a cada 15 min aproximadamente; silencioso ou além do prazo por 20 min = verifique, substitua ou pare; linha de status para o usuário a cada 10 min de silêncio aproximadamente; timeout de render 3x o ETA medido. (fonte: workflow destilado 02 §13.6, 2026-10-01)

Regras de decisão

SeEntão
uma correção mestre é necessária após derivados existiremcorrija o MESTRE, change, leve o patch para toda cópia, re-renderize e re-registre todos
uma cópia precisa de timing ou cues diferentesisso é uma mudança no mestre; ou uma nova edição (recut) com suas próprias linhas de ledger, nunca uma bifurcação silenciosa
um gancho precisa de uma linha falada diferentedeclare own-vo com um motivo; toda outra variante permanece no mix compartilhado
uma proporção é solicitada tardeescreva a tabela de layout, lance UM agente em uma cópia do mestre congelado; não toque no mestre
dois renders são solicitados de uma vezenfileire-os; o lock decide; escreva a ordem em STATE.md
um agente está silencioso além do prazoverifique seu arquivo de progresso, então substitua ou pare (apenas sua própria árvore de processos), depois render_lock status
a pasta finals contém um render antigomova para _work/delivered/v<N>/; "pronto" é bloqueado até que a pasta corresponda ao manifesto
o usuário nomeia os arquivoso nome deles vence; registre com --name-ledger-id e mantenha campos de plataforma/gancho/proporção explícitos

Estados bloqueados (relate-os, não os contorne)

manifest_check.py BLOQUEADO ou EVIDÊNCIA INSUFICIENTE; um derivado com from_master desatualizado ou uma correção mestre ausente; uma fonte alterada-após-render; desvio de cues ou mix compartilhados; qa não pass; uma variante prometida ausente; um arquivo não planejado presente. Diga qual arquivo, qual código e a correção.

Armadilhas que custam tempo real

Pedido tardio de 16:9 na entrega (um re-layout completo, descartado); uma correção mestre de 3.7 s não levada para o 1:1; um render antigo deixado ao lado dos novos e ninguém sinalizou; um agente derivado que encontrou um bug mestre e corrigiu apenas sua cópia; três agentes renderizando ao mesmo tempo (um job Blender paralelo dobrou um render, 11.5 para 21.5 min, laptop do dono); colisões de nomeação entre cortes do Meta e TikTok; uma variante de gancho carregando silenciosamente um mix diferente. Uma folha de contato visualizada de cada proporção ainda é necessária: hashes não podem ver uma legenda sobre um rosto.

Referências (carregue quando)

  • references/variant-matrix-and-layout.md - escrevendo a matriz, re-layout de uma proporção, variantes de gancho/sem música/sem legendas/duração.
  • references/manifest-schema.md - registrando arquivos, lendo descobertas de manifest_check.py, o ciclo de vida de derivado desatualizado.
  • references/parallel-and-agents.md - lançando agentes, fila, lock, batimentos cardíacos, parando, orçamento de token.
  • references/house-presets.md - antes de citar qualquer tela, zona segura, loudness ou número de plataforma (módulo datado).
  • agent-content/references/platform-specs.md (fatos canônicos de plataforma, de propriedade de outro lugar) e agent-content/playbooks/wf-08-deliver.md (playbook de entrega: nomeação, regras de manifesto) - predefinições de exportação e o playbook; se um número diferir, o arquivo canônico vence e references/house-presets.md é atualizado.
  • Outras skills: render-qa-deliver (QA por arquivo), hebrew-captions-asr (trilho de legendas), edit-ad-promo (ranqueamento de gancho), revision-round (notas entre proporções), paid-generation-gate.
  • Scripts: scripts/manifest_check.py (--self-check 29 casos, saída 0 PRONTO / 1 BLOQUEADO / 2 EVIDÊNCIA INSUFICIENTE) e scripts/test_manifest_check.py (teste unitário).

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

Habilidades Relacionadas