Communitygithub.com

Malik-rgb43/editing-workflow

Script, edit ou revisar um anúncio pago em redes sociais, post patrocinado ou promoção de marca para um negócio, produto, app ou loja (Meta, Instagram, TikTok, 15-60 s): oferta exata e CTA, hooks ranqueados, variantes de hook, cartão final, tabela de conformidade, verificação de licenças. Disparadores: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NÃO para depoimentos (edit-testimonial), reels de especialista orgânicos (edit-talking-head), filmes só de IA (edit-ai-generated), exportações de proporção (multi-video-variants).

O que é editing-workflow?

Esta skill transforma a oferta, produto e filmagens de um cliente em um anúncio pago em redes sociais em hebraico que declara a oferta exatamente, abre com um hook ranqueado, passa por revisão de conformidade e licenças, e é entregue como um lote de variantes de hook em um único copo. Suporta Meta, Instagram e TikTok, com durações de 15 a 60 segundos. A skill verifica ofertas, alegações e licenças antes de qualquer refinamento visual, com uma tabela de conformidade de 12 tópicos que bloqueia o rascunho se qualquer item falhar. O workflow inclui ingestão de vídeo, ledger de ofertas, script com hooks ranqueados, quadros de estilo com zonas seguras, e portões mecânicos que garantem conformidade de oferta, licenças, zonas seguras e lote. Destinada a profissionais de marketing e editores de vídeo que precisam de um processo rigoroso e auditável para anúncios pagos.

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

Perguntar na sua IA favorita

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

Documentação

edit-ad-promo

Transforma a oferta, produto e filmagens de um cliente em um anúncio pago em redes sociais em hebraico que declara a oferta exatamente, abre com um hook ranqueado, passa por revisão de conformidade e revisão de licenças, e é entregue como um lote de variantes de hook em um único corpo. A oferta, as alegações e as licenças são verificadas antes que os pixels sejam refinados.

Regras que se sobrepõem ao restante deste arquivo

  1. Oferta, preço e CTA exatamente como fornecidos por escrito. Strings e números vêm de um ledger que o cliente confirmou; nada é inventado, arredondado ou "melhorado"; urgência apenas se for verdade. Sem oferta do cliente: proponha uma de baixo atrito e PERGUNTE; nunca escreva uma.
  2. A tabela de conformidade é bloqueante. Cada um dos seus 12 tópicos tem um status; uma linha fail ou blocked impede que o rascunho seja apresentado, independentemente do que a rubrica diga. Um rótulo (divulgação de IA, aviso legal) nunca cura uma alegação enganosa.
  3. Licenças: License: unknown = não está no cliente ou no trabalho de anúncio (decisão padrão Q2: o "orgânico apenas" mais antigo do proprietário é uma postura de risco para suas próprias contas, não uma licença). Música e SFX apenas se a própria linha do arquivo permitir anúncios para o canal e território. Sons e logotipos de marcas de terceiros precisam de permissão ESCRITA da marca para anúncios. Uma correspondência de música não é uma licença; sons populares não são liberados.
  4. Nenhuma lei universal de hook. Nenhuma fonte verifica um limiar de 3 segundos ou um número fixo de retenção; os hooks são ranqueados por razões declaradas e testados pelos próprios resultados do cliente.
  5. Zonas seguras são o preset da casa v1 (datado, não verificado em dispositivos; decisão padrão Q5), uma aprovação precisa de uma sobreposição visualizada, não apenas geometria.
  6. Gastos e privacidade: nenhuma geração paga sem paid-generation-gate (uma estimativa e aprovação datadas); tomadas de IA apenas como clima ou B-roll faltante, divulgadas; nenhuma filmagem do cliente para ferramentas em nuvem sem uma decisão por cliente; snapshot --describe false.
  7. PROMPT.md é aprovado por um humano antes da primeira linha de código de construção, também em execuções autônomas (decisão padrão Q6). Skills são procedimento, não permissão; restrições de usuário e projeto substituem este arquivo. Nunca mensage outras sessões do Claude.

Entradas -> saídas

Entrada: a oferta por escrito (preço, termos, prazo, aviso legal), canal CTA (botão, WhatsApp, código, endereço), plataformas e rota (orgânico, leilão de anúncio, Spark), durações (padrão 15 + 30 s), ativos de produto e marca, filmagens e consentimentos. Saída: linhas do ledger hf/OFFER (no PROMPT.md), hf/ad_gates.json (superfícies de oferta, hooks, conformidade, ativos), N variantes de hook em um corpo + cartão final, tabela de conformidade, QA por arquivo, nomenclatura <nome>_<plataforma>_<hook>_<aspecto>.mp4 com um manifesto (multi-video-variants).

Procedimento

#FaçaArtefato
0Intake via video-intake: oferta + termos + prazo, canal CTA, plataformas/rota, durações, proporções, hooks (3), lista de verificação de ativos do cliente (references/ad-blueprint-and-hooks.md), consentimentos; um anúncio de referência -> reference-style-transfer primeiro; ls toda a pasta fonteBRIEF + ledger
1Ledger de oferta: uma linha por string exata (hebraico literal, símbolo de moeda, prazo, CTA) com as superfícies em que deve aparecer (voz, super, cartão final)linhas do ledger
2Tabela de conformidade do brief ANTES da escrita do roteiro (references/compliance-table.md): alegações, termos de preço, antes/depois, avaliações, hooks de atributo pessoal, saúde/finanças, ativos de marca, divulgação de IA, licença de música, consentimento de pessoas, UI falsa, política da plataformaad_gates.json conformidade
3Roteiro: três hooks ranqueados com razões, folha de batidas por duração (hook, problema, solução, prova, oferta, CTA), oferta três vezes, cortes de 15 s e 30 s; narração transcrita para a edição em papelSCRIPT.md
4Quadros de estilo com a sobreposição da zona segura: hook, etiqueta de preço, antes/depois, cartão final; ativos com uma linha de licença cada (references/sound-and-licences.md); geração paga apenas através de paid-generation-gatequadros de estilo, SOURCES.md
5PROMPT.md + DESIGN.md (cada quadro: o quê, onde em px, quando em quadros, easing, som) -> aprovação humana -> construção: corte, gráficos (insígnia de preço, UI reconstruída em código, nunca estoque), legendas, cor, mixprojeto hf/
6Portões mecânicos: python scripts/ad_gate_check.py hf/ad_gates.json e python scripts/safe_zone_check.py elements.json --aspect 9x16 --overlay-evidence <captura de tela visualizada>; ambos saem 0relatórios
7Verificar: render-qa-deliver (QA de cada quadro no arquivo final), rubrica A1-A8 (references/rubric-and-benchmarks.md), teste mudo, um crítico em todo o conjunto; UMA renderização completa por rodadaevidências de QA
8Lote: variantes de hook no mix compartilhado, versões nomusic / nocaps, outras proporções via multi-video-variants (manifest_check.py saída 0)final/ + manifesto
9Apresentar: arquivos de uma vez, alterações numeradas, a tabela de conformidade, ticks do ledger, lacunas honestas (o que não foi testado em dispositivo)mensagem

Portões

Os estados são pass | fail | blocked | n/a com uma razão. Um timeout, amostra vazia ou entrada faltante é blocked, nunca pass. Uma chamada de ferramenta bem-sucedida é evidência de execução; uma renderização visualizada é evidência de aparência.

PortãoPredicadoEvidênciaSe falsoProprietárioReaverificar quando
G1 oferta exatatoda string/número do ledger aparece literalmente em cada superfície necessária; nenhum preço ou porcentagem na tela que não esteja no ledger; um CTA existedescobertas de oferta do ad_gate_check.py claras (sem OFFER_NOT_EXACT, UNLEDGERED_AMOUNT, NO_CTA)corrija o texto; nunca invente ou arredonde uma alegação; pergunte ao clientead_gate_check.py + humanoqualquer edição de texto, preço ou cartão
G2 conformidadetodos os 12 tópicos avaliados; nenhum fail/blocked; linhas pass carregam evidências; linhas n/a carregam razõesa tabela em ad_gates.json; ad_gate_check.py saída 0remova ou substitua a alegação; proponha redação conforme; não renderizeesta skill (bloqueante)qualquer nova alegação, ativo ou canal
G3 ranking de hook>= 3 hooks ranqueados com razões distintas; nenhuma alegação universal de 3 segundos; nenhum abridor proibidolista de hooks em ad_gates.jsonre-ranqueie; reescreva a razão como uma justificativa editorialesta skillqualquer edição de hook
G4 zonas segurastexto-chave, CTA, preço, logotipo dentro da zona da casa de cada aspecto; trilho de legenda inferior <= y 1450 em 9:16safe_zone_check.py saída 0 COM uma captura de tela de sobreposição visualizada no hook, oferta e cartão finalre-layout do elemento; reporte blocked se nenhuma sobreposição foi visualizadaesta skillqualquer alteração de layout; um resultado de teste em dispositivo
G5 licençascada música/SFX/filmagem/logotipo tem uma linha permitida para anúncios, cobertura de canal, atribuição se CC-BY, permissão por escrito para ativos de marca de terceiros; ativos de IA divulgadosdescobertas de ativos do ad_gate_check.py claras; SOURCES.mdtroque por um ativo licenciado; pergunte à marcaesta skill + paid-generation-gatequalquer alteração de ativo ou canal
G6 lote e cartão finalvariantes de hook compartilham um mix (apenas os primeiros segundos diferem); cartão final 2-3 s com logotipo, oferta, contato, CTA, música até o fim; um crítico revisa todo o conjuntomanifesto check saída 0; quadro do cartão final visualizadodeduplique, re-muxe, re-renderize apenas o arquivo com falhamulti-video-variantsqualquer alteração no mestre ou hook
G7 rubrica e teste mudomédia >= 4,0, nenhuma dimensão < 3, portões A1/A2/A6 acima de 2; oferta, marca e CTA compreendidos no mudo; final -14 +/- 0,5 LUFS, TP <= -1relatório do crítico com timecodes; qa deliverycorrija e re-revise apenas os intervalos alteradoscrítico + esta skillcada rascunho

Números (padrões da casa e medianas de mercado, com seus limites)

  • Modelo: hook 0-2/0-3 s, oferta 7-9 s (corte de 15 s) / 19-22 s (corte de 30 s), cartão final 12,5-15 s / 27-30 s; a oferta mais CTA ocupam 30-45 % de um anúncio de 30 s (mercado 31-42 %).
  • Uma mudança visual a cada 1,4 s no mínimo; cerca de 36 cortes/min (mercado, 16:9) e 34,5 (proprietário, 9:16); marca dentro de cerca de 1 s, produto dentro de cerca de 3 s; um pico de intensidade sonora, no logotipo.
  • Zona segura 9:16: topo 300 / fundo 672 (texto-chave y <= 1248) / esquerda 140 / direita 192, trilho de legenda inferior <= y 1450: preset da casa v1, datado de 2026-10-02 (references/safe-zone-presets.md).
  • Título na faixa de hook: no máximo 6 palavras (recomendação da casa para 9:16 pago com som desligado).

Regras de decisão

SeEntão
o brief não tem ofertapeça por escrito ou proponha uma de baixo atrito e pergunte; o verificador permanece INSUFFICIENT até ser respondido
o cliente quer uma música popular ou um clipe de filmesubstitua por uma faixa licenciada; explique que uma correspondência ou tendência não é uma licença; orce o tempo de substituição
um hook "deve funcionar nos primeiros 3 segundos"reescreva a razão como uma justificativa editorial; nenhum limiar universal é verificado
uma alegação não tem prova ("o melhor", "100 % garantido")a linha de conformidade é blocked; proponha redação documentada; não renderize
existe apenas um ativo 16:9 para um anúncio 9:16re-layout através de multi-video-variants; nunca corte ou reduza o quadro para caber na zona
os cortes do Meta e do TikTok diferemum token de plataforma no nome do arquivo e uma linha de licença por canal
o anúncio é principalmente tomadas de IAtambém carregue edit-ai-generated, divulgue por rota, gaste apenas através do portão
o visual aprovado do cliente conflita com a assinatura da skillo visual do cliente vence; anote o desvio da rubrica

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

Uma string de oferta que difere do ledger; um valor na tela que não está no ledger; qualquer linha de conformidade fail/blocked; um ativo com unknown, NC ou sem linha permitida para anúncios; um ativo de marca de terceiros sem permissão por escrito; uma alegação de zona segura sem sobreposição visualizada; manifest_check.py não READY. Cada um é uma razão para parar e dizer o que o desbloqueia.

Armadilhas que custam uma rodada ou uma campanha

Um desconto enterrado aos 21,6 s de um anúncio de 30 s; o preço estilizado como legenda; "um desconto significativo" no lugar de um número; marca apenas no final; uma música comercial ou clipe de anime no corte; uma faixa licenciada para TikTok usada no Meta; um som de pagamento de terceiros em um anúncio pago; um antes/depois que foi melhorado por IA; picos verdadeiros acima de 0 dBTP; marca ou endereço com erro ortográfico; anúncios de 46-53 s quando 15 + 30 s foram solicitados; um hook avaliado como "melhor" sem razão; uma variante de hook que silenciosamente carrega um mix diferente.

Referências (carregar quando)

  • references/ad-blueprint-and-hooks.md - roteiro: modelo, escada de hooks, oferta/CTA/cartão final, gramática visual, lista de verificação de ativos do cliente.
  • references/compliance-table.md - etapa 2 e antes de apresentar: os 12 tópicos, evidências, redação conforme, notas da plataforma (datadas).
  • references/safe-zone-presets.md (+ references/safe_zone_presets.json, lido pelo script) - qualquer layout; antes de dizer "passa" (preset datado).
  • references/sound-and-licences.md - escolher música/SFX, as linhas de licença, mixagem e níveis.
  • references/rubric-and-benchmarks.md - antes de apresentar; pontuar um rascunho; a tabela de números.
  • Outras skills: video-intake, reference-style-transfer, multi-video-variants, render-qa-deliver, revision-round, paid-generation-gate, edit-ai-generated (um anúncio feito principalmente de tomadas de IA). Fatos da plataforma: agent-content/references/platform-specs.md (de propriedade de outro lugar, datado); rubrica de benchmark agent-content/benchmarks/ad-promo.rubric.md (de propriedade de outro lugar).
  • Scripts: scripts/ad_gate_check.py, scripts/safe_zone_check.py (stdlib, docstring de uso, --self-check, saída 0 / 1 / 2).

Individual skills in this repo

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

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

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

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