Communitygithub.com

Malik-rgb43/editing-workflow

Transforme uma nova ideia de vídeo, briefing ou lista de especificações em um Livro-Razão de Conceito verificável e faça perguntas até que cada parâmetro esteja preciso, antes de qualquer conceito, prompt ou construção. Use no início de qualquer novo vídeo, com ou sem filmagens, ou quando o usuário colar um conceito com especificações.

O que é editing-workflow?

Esta skill, 'video-intake', é o gateway obrigatório para toda nova ideia de vídeo, garantindo que nenhum prompt, código ou geração seja iniciado antes que todos os parâmetros-chave estejam precisos e aprovados pelo usuário. Ela funciona como um planejador meticuloso: a partir de uma mensagem do usuário (ideia, briefing, especificações), a skill cria um Registro de Entrada (INTAKE_LOG.md) e um Livro-Razão de Conceito no arquivo `hf/PROMPT.md`, onde cada afirmação concreta do usuário vira uma linha rastreável com ID, especificação mensurável e status. Através de um loop de perguntas (máximo de 4 por rodada), ela elimina suposições sobre plataforma, duração, tom, CTA, qualidade e estrutura, sempre com opções concretas e uma recomendação. A skill também gera cartas de conceito (se o usuário não fixou um), um BRIEF.md completo e aplica verificações rigorosas (Gates) como integridade do livro-razão, ausência de adivinhação e aprovação do PROMPT antes de qualquer ação. É indicada para equipes de produção de vídeo e agentes de IA que precisam de um fluxo disciplinado e à prova de erros no início de projetos, suportando plataformas como Claude Code, Cursor e Codex.

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

Perguntar na sua IA favorita

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

Documentação

video-intake (Entrada de Vídeo)

O gateway por onde todo novo vídeo passa primeiro (estágio wf-00). Saída: um registro de entrada ipsis litteris, um Livro-Razão de Conceito com uma linha mensurável por item concreto, BRIEF.md e (se o usuário não fixou um conceito) três cartas de conceito. Não escreve PROMPT quadro a quadro, nem código, nem geração.

Regras que nunca se dobram

  1. Entrada até estar preciso. Sem referência, pergunte. Plataforma, duração, tom, CTA, estrutura (corte de silêncios vs. reconstrução) e nível de qualidade nunca são adivinhados.
  2. Cada item concreto que o usuário escreveu vira uma linha do livro-razão com um id, nas próprias palavras do usuário (hebraico permanece hebraico). Alegações compostas são divididas ("globo maior e pessoa mais alta" = 2 linhas).
  3. Nenhuma carta de conceito, estrutura de PROMPT ou construção até que as linhas bloqueantes estejam travadas: FMT, LEN, TON, BAR, CTA, FILE; mais STR e COLOR quando houver filmagens; mais VAR quando mais de um arquivo for entregue.
  4. PROMPT.md é aprovado pelo usuário antes da primeira linha de código, também em execuções autônomas: o agente rascunha, o humano aprova (decisão padrão Q6). Ordem de mudança: livro-razão -> PROMPT -> código.
  5. Sem gastos aqui. Entrada é planejamento. Geração por IA precisa de paid-generation-gate; "só planejar" significa zero geração. Direitos pouco claros + geração planejada = bloqueado.
  6. Linhas travadas nunca são sobrescritas: adicione uma linha e risque a antiga (riscado por L<nn>, ou ~~antigo~~ -> novo, hora na especificação).
  7. Pergunte apenas o que é desconhecido e material. Não pergunte sobre ferramentas ou pastas; decida e justifique em uma linha.
  8. Skills são procedimento, não permissão: limites de gastos e instalações do usuário e do projeto prevalecem. Não testado em um modelo (decisão padrão Q4).

Fluxo

  1. Leia o que existe: a mensagem, os anexos e a ÁRVORE DE ORIGEM INTEIRA: python scripts/source_inventory.py <pasta de origem> --write projects/<nome>/_work/intake (escreve source_ls.txt + probe.json; um original de câmera 4K já ficou esquecido ao lado de um corte bruto). Verifique projects/ por um projeto irmão na mesma origem: pergunte "novo projeto ou continuação de X?". Ramos (referência, prompt colado, "novo completamente", "só planejar"): references/branches-and-mistakes.md.
  2. Registre ipsis litteris em _work/intake/INTAKE_LOG.md: as palavras do usuário como linhas simples, suas perguntas como linhas Q: sob ## Rodada N.
  3. Analise o livro-razão no bloco <ledger> de hf/PROMPT.md (um rascunho sem <structure> ainda): ids, dim, said, spec mensurável, where / when, verificação de aceitação, src U/R/D/A, status (references/ledger-template.md).
  4. Loop de perguntas (references/question-bank.md): rodadas de 3-4 perguntas, opções concretas, primeira = recomendada; BAR na rodada 1. Após cada rodada imprima Travado: ... | Aberto: ... e atualize o livro-razão. "Continue" / "continue" = aceite as opções recomendadas, marque D, diga isso em UMA linha.
  5. Referência presente? entregue a reference-style-transfer e pergunte qual intervalo de tempo é "o estilo". Ausente: continue perguntando; nunca invente um estilo.
  6. Conceitos: se o usuário não fixou um, três cartas Comprovado / Ousado / Selvagem que diferem em conceito; recomende uma (references/concept-cards-and-brief.md).
  7. BRIEF.md a partir do modelo (agent-content/techniques/templates/BRIEF.md) com os fatos corretos, execute ledger_check.py, entregue ao escritor de PROMPT, aguarde aprovação, então registre PROMPT_APPROVED <data> "<palavras>" em hf/CHANGELOG.md.

O loop de perguntas em resumo

  • 3-4 perguntas por rodada, maior impacto primeiro: FMT / LEN / STR / BAR, depois HOOK / TON / LOOK / MOT, depois TYPE / 3D / BROLL / BRAND, depois CAP / MUS / SFX / CTA, depois FILE / VAR / DUE.
  • Cada opção é concreta (um número, um nome, um hex, um arquivo); a primeira opção é a recomendada, rotulada (recomendado) com uma linha de justificativa. Escolha visual: adicione uma prévia, ou um quadro de escolhas quando 3+ opções de gosto estiverem pendentes.
  • Nunca pergunte o que ls, ffprobe ou a mensagem já respondem; nunca pergunte sobre ferramentas ou pastas.
  • Após cada rodada: Travado: L01 L02 ... | Aberto: HOOK LOOK ....
  • Nenhuma referência fornecida significa pergunte; uma referência fornecida significa analise-a e pergunte apenas o que uma referência não pode responder (duração, proporções, estrutura, CTA, nome do arquivo, nível de qualidade, licença de música, prazo).

Mensagem da Rodada 1 (Hebraico / Inglês)

סבב 1 - ארבע שאלות, לכל אחת ברירת מחדל מומלצת:
1. פלטפורמה ויחס? (מומלץ: 9:16 ריילס/טיקטוק; מאסטר אחד, שאר היחסים בעיצוב מחדש)
2. כמה שניות בדיוק? (מומלץ: התוכן המלא בצילום; 45 במושן)
3. חיתוך שתיקות בלבד, או בנייה מחדש? (מומלץ: שתיקות בלבד, סדר טבעי, משפטים שלמים)
4. רמת איכות? (מומלץ: פרימיום - ביט גרפי כל 3-6 שניות, צבע מדוד)
Rodada 1 - quatro perguntas, cada uma com um padrão recomendado: 1. plataforma e proporção, 2. segundos exatos, 3. corte de silêncios apenas ou reconstrução, 4. nível de qualidade.

Uma linha do livro-razão de relance

| L02 | TRN | "queima de filme no segundo 1-2" | o arquivo de queima do usuário, quadro cheio, mesclagem de tela | 1.00-2.00 s (f30-60) | tira de quadro f28-62: queima visível, nome do arquivo corresponde | U | travado | Uma afirmação por linha; said ipsis litteris; spec mensurável; um said com tempo precisa de um intervalo e uma verificação no nível do quadro (o verificador aplica ambos).

Sinais de que a entrada está dando errado

Duração ou plataforma aparece sem uma frase do usuário por trás; uma carta de conceito existe antes de FILE ou CTA estar travado; uma linha D que o usuário nunca viu; a pasta de origem nunca foi listada; o PROMPT tem um bloco <structure> e nenhuma linha PROMPT_APPROVED.

Portões (Gates)

Estados: pass | fail | blocked | n/a com um motivo. Um registro de entrada faltando, livro-razão vazio, tempo limite ou pasta ilegível nunca passa.

PortãoPredicadoEvidênciaSe falsoProprietárioRevisão
G1 completude do livro-razãocada cláusula concreta no registro de entrada tem uma linha; cada citação de linha U está no registro; 0 linhas inventadaspython scripts/ledger_check.py hf/PROMPT.md --source _work/intake/INTAKE_LOG.md sai com 0 (status PASS, cobertura checked)adicione as linhas faltantes, ou --waive uma cláusula com um motivo; nunca edite o registro para correspondervideo-intakequalquer nova mensagem do usuário ou edição do livro-razão
G2 sem adivinhaçãoFMT, LEN, TON, BAR, CTA, FILE (+STR, COLOR com --footage; +VAR com --variants) cada um vem de U/R/A aprovado, ou de uma linha D que o usuário viu; <= 4 perguntas por rodadao mesmo script: blocking todos ok, nenhum too_many_questionspergunte a próxima rodada; não escreva conceitosvideo-intakeuma resposta altera uma linha bloqueante
G3 árvore de origem lidatoda a árvore de origem foi listada; candidatos originais de câmera relatados ou unknown_work/intake/source_ls.txt e probe.json existem e são citadosexecute novamente; uma listagem blocked permanece bloqueadavideo-intakenovos arquivos adicionados à origem
G4 ramo de referênciareferência presente -> reference-style-transfer e o intervalo de tempo do estilo registrado; ausente -> loop continualinha do ramo no registro de entradanão invente um estilovideo-intakeusuário adiciona uma referência
G5 três conceitos3 cartas, diferentes duas a duas em >= 2 de dispositivo de gancho / estrutura / linguagem visual; cada uma lista os ids do livro-razão que obedeceas cartasregenere a mais fracavideo-intakeuma linha bloqueante muda
G6 direitosBRIEF.md tem uma seção Fonte e direitos preenchida (proprietário/consentimento da filmagem, licença de música/estoque por arquivo, conta do cliente vs. própria)BRIEF.mdbloqueado: sem geração paga, sem uso em anúncios de Licença: desconhecida (decisão padrão Q2)video-intakeum novo ativo aparece
G7 hand-offledger_check.py hf/PROMPT.md --source ... --prompt hf/PROMPT.md sai com 0 (cada id citado >= 2x) e PROMPT_APPROVED está em hf/CHANGELOG.mdsaída do script + a linhaPROMPT permanece um rascunho; nenhum códigoescritor de PROMPTqualquer alteração no livro-razão ou PROMPT

Saídas

_work/intake/{INTAKE_LOG.md, source_ls.txt, probe.json}, o bloco <ledger> em hf/PROMPT.md, hf/BRIEF.md, a carta de conceito escolhida, as linhas de variantes (uma por arquivo), a lista ABERTO:, o JSON da verificação do livro-razão.

Condições de parada

  • O usuário diz "apenas comece": aceite os padrões recomendados como D e diga quais; ainda pergunte o CTA, FILE e qualquer item bloqueante que ele não viu.
  • Uma nova solicitação contradiz uma linha travada: mostre ambas, pergunte qual vence; nunca escolha silenciosamente.
  • O usuário quer pular a aprovação do PROMPT: recuse o atalho, ofereça um PROMPT mais curto, não um pulado.
  • Entrada passa de 4 rodadas: resuma travado | aberto e peça ao usuário para resolver o restante com um "continue".

Referências e scripts

  • references/ledger-template.md: carregue ao criar ou editar o livro-razão (formato que o verificador analisa, códigos de dimensão, tipos de verificação, exemplo).
  • references/question-bank.md: carregue quando um campo está faltando ou antes de compor uma rodada (Hebraico + Inglês, opções, plano de rodada).
  • references/branches-and-mistakes.md: carregue quando a entrada é uma referência, um prompt colado, um projeto irmão, ou após uma falha de portão.
  • references/concept-cards-and-brief.md: carregue ao escrever cartas de conceito, BRIEF.md, os fatos de direitos, ou o hand-off.
  • scripts/ledger_check.py, scripts/source_inventory.py: stdlib; cada um tem --self-check.
  • Técnicas compartilhadas (outro proprietário): agent-content/techniques/concept-ledger.md (regras canônicas do livro-razão), agent-content/techniques/question-bank.md (banco completo em Hebraico); manual de estágio agent-content/playbooks/wf-00-intake.md.

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

>- 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).

Habilidades Relacionadas