Communitygithub.com

Malik-rgb43/editing-workflow

Analisa um vídeo (arquivo, link do YouTube/TikTok/Instagram ou pasta de clipes) e produz métricas (cortes, ritmo, dados por quadro), folhas de contato, transcrição em hebraico e análise de áudio (SFX, BPM, tom, batidas, identificação de música). Gatilhos: assistir, analisar, detalhar, transcrever este vídeo/reel/anúncio; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NÃO serve para cortar/exportar (skills de tipo), aplicar estilo (reference-style-transfer) ou legendas para render final (hebrew-captions-asr).

O que é editing-workflow?

Este skill transforma qualquer vídeo (arquivo local, URL do YouTube/TikTok/Instagram ou uma pasta de clipes) em uma representação numérica que um modelo de IA pode interpretar: medições a cada quadro, folhas de contato com carimbo de data/hora, transcrição de fala em hebraico, uma linha do tempo de áudio com espectrogramas e uma análise textual completa. Ele executa um pipeline de ferramentas locais e gratuitas — sem APIs pagas de compreensão de vídeo — e respeita restrições de privacidade: material confidencial nunca é enviado para identificação remota de música ou ASR em nuvem. O skill é compatível com agentes como Claude Code, Cursor e Codex, e é acionado por comandos como 'analise este vídeo', 'quais são os cortes?', 'transcreva' ou 'o que está acontecendo neste anúncio?' (inclusive em hebraico: תנתח, תמלל, קאטים). Ele gera arquivos organizados em `analysis/<video>/`, incluindo `measurements.json`, `frames.csv`, folhas de contato, `transcript.json`, `audio.json` e um `breakdown.md` descritivo. O skill nunca edita, renderiza ou aplica estilos — ele é o passo de análise antes de skills de edição ou transferência de estilo. Um conjunto rigoroso de portões (gates) garante que a cobertura seja sempre declarada, que a entrada permaneça intacta e que cortes e métricas sejam verificados manualmente nos quadros.

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

Perguntar na sua IA favorita

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

Documentação

video-analysis

Converte vídeo em algo que um modelo pode ler: uma medição numérica de cada quadro, folhas de contato com carimbo de data/hora, uma transcrição, uma linha do tempo de som e imagens de espectrograma, e então uma análise escrita a partir deles. É um procedimento sobre a ferramenta de análise, não a ferramenta (o script privado do proprietário não é distribuído; a porta do estudante segue TOOLS_SPEC). Nunca edita, renderiza ou aplica um estilo.

Regras que se sobrepõem ao resto deste arquivo

  1. As entradas são somente leitura. Hash antes e depois (input.sha256 = sha256_after); saídas vão apenas para analysis/<video>/. Baixe apenas a URL que o usuário forneceu, nomeando a origem e o arquivo; é uma cópia de referência, nunca redistribuída; uma marca d'água da plataforma, cartão final e jingle são excluídos das estatísticas e listados.
  2. A cobertura é declarada primeiro. Todo relatório abre com um bloco de cobertura: completo vs amostrado, quadros decodificados dos esperados, o que foi excluído, o que NÃO foi executado. Uma amostra nunca é apresentada como cobertura completa. Uma execução amostrada não pode citar contagens de cortes ou ritmo como fato medido.
  3. Execute a ferramenta; nunca faça amostragem manual com ffmpeg. Se a ferramenta estiver faltando, indique blocked: tool_missing e pergunte; uma solução manual é permitida apenas como uma análise sampled explicitamente rotulada, sem contagens.
  4. Leia antes de escrever: veja TODAS as folhas e TODAS as imagens de áudio; zoom de 3 a 6 vezes; decida cada ponto de edição check a partir dos quadros; corrija contagens erradas e informe isso.
  5. Local, gratuito, privado. Nenhuma API paga de compreensão de vídeo, nenhum upload do vídeo ou de seus quadros ou áudio, nenhuma identificação remota de música em material private, sem uma estimativa datada e aprovação prévia (paid-generation-gate). Fala em hebraico é forçada para he; nunca confie em uma única passagem de ASR para nomes, marcas e números.
  6. Uma correspondência de música não é uma licença. Reporte "identificado como X, permissão de sincronização não estabelecida" ou "não identificado"; nunca invente um título. Rótulos estilo AudioSet são suposições ("provavelmente um whoosh"); tempo e tom são estimativas com auditoria de metade/dobro do tempo.
  7. Um trabalho pesado por vez sob render_lock; qualquer coisa acima de cerca de 2 minutos é executada em segundo plano com um log e uma ETA; sem promessa de tempo de execução (lote do proprietário: 9-23 min por vídeo sob carga, dependente da máquina). Skills são procedimento, não permissão: restrições do usuário e do projeto substituem este arquivo.

Interface de ferramenta que este skill espera (TOOLS_SPEC video-analysis; verifique com --help)

python tools/analyze.py <vídeo|URL|pasta> --out analysis/<vídeo> [--detail quick|standard|full]
       [--asr auto|always|never] [--no-song-id] [--no-audio-ai] [--check]
python tools/frames.py <vídeo> --at <t> --pad 0.25 --out analysis/<vídeo>     # cada quadro de uma janela curta

Contrato de saída (references/output-contract.md): analysis/<video>/{measurements.json, frames.csv, sheets/ (index.json + images), transcript.json, audio.json} + breakdown.md.

Procedimento

#FaçaArtefato
0Pergunte apenas o que muda na execução: análise completa ou uma pergunta (cortes / transcrição / música)? Material confidencial (private)? Qual idioma para a análise? Uma pasta: liste-a primeiro; nunca sobrescreva uma análise anteriorlinha de escopo
1Pré-verificação (analyze --check / doctor): registre SO, ffmpeg, rota de ASR detectada (CPU / Vulkan / CUDA / MLX; none se não detectado), a flag de ambiente Vulkan; sem rota = blocked para transcrição apenasbloco environment
2Execute em segundo plano sob o lock. --detail: quick para corpus/palestra longa, standard padrão, full para motion graphics, edições muito rápidas ou uma referência para transferir (references/thresholds.md). Vários vídeos: um lote, depois um agente por vídeo (apenas sua pasta, breakdown.md como saída, prazo, resposta <= 10 linhas)pastas de análise
3python scripts/validate_analysis.py analysis/<video> --stage producedPASS ou os componentes com falha
4Leia: todas as folhas, todas as imagens de áudio; zoom apenas em dispositivos distintos; resolva pontos check; corrija a contagem (pacing.override + review.corrections); audite tempo metade/dobrobloco review
5python scripts/validate_analysis.py analysis/<video> --video <source>; saída 0 é necessária para apresentar números como fatosrelatório de validação
6Escreva breakdown.md no idioma do usuário conforme references/reading-and-breakdown.md (cobertura primeiro, 7 seções, incertezas por último)breakdown.md
7Reporte: o caminho do arquivo, 5-10 linhas, as correções, o que não pôde ser estabelecido; ofereça o próximo skill (reference-style-transfer, um skill de tipo) em vez de fazê-lomensagem

Portões (Gates)

Os 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; folhas visualizadas são evidência de aparência.

PortãoPredicadoEvidênciaSe falsoResponsávelRevisar quando
G1 perfil da máquinaRota de ASR detectada e registrada; rota Vulkan registra GGML_VK_DISABLE_COOPMAT (driver AMD do proprietário precisa =1; outros drivers não testados)measurements.environment de doctor/--checkrecorra à rota CPU e informe; nunca assuma uma GPUeste skill + doctornova máquina, driver ou modelo
G2 contrato válidotodos os cinco componentes passam ou são n/a com um motivovalidate_analysis.py saída 0 (--video fornecido)corrija ou reexecute o componente; reporte INSUFICIENTE com a peça faltantevalidate_analysis.pyqualquer reexecução ou edição manual
G3 declaração de coberturarelatório abre com modo, quadros decodificados/esperados, exclusões, lista de não executados, claims_not_allowedprimeiro bloco de breakdown.mdadicione; rebaixe alegações para "amostrado"este skillcada relatório
G4 regressão do detector de cortesqualquer alteração em um limite do detector mantém F1 >= a linha de base do conjunto rotulado (histórico do proprietário 0.89 = P 0.87 / R 0.91 em 20 anúncios verificados manualmente, 339 pontos de edição, privados, não reproduzidos; ponto cego conhecido: peças de tipo cinético e câmera contínua)cut_regression.py --pair ... --min-f1 0.89 saída 0 com >= 100 pontos verdadereverta a alteração do limitecut_regression.pycada alteração do detector; nunca a olho
G5 entradas intactashash da origem igual antes e depoisvalidate_analysis.py --videorestaure o arquivo do original, reexecutevalidate_analysis.pycada execução
G6 leia antes de escrevercada folha de quadro-chave/visão geral e imagem de áudio visualizada; cada ponto check resolvido; contagens verificadas nos quadrosbloco review completo (etapa revisada)volte e visualize-oseste skillcada análise
G7 privacidade e direitosentrada private: sem identificação remota de música, sem ASR em nuvem, sem upload de quadro; correspondência = sem licençasong_id.status, asr.routeexclua o log de trechos, reexecute localmenteeste skillcada execução

Números e limites para citar com seu escopo

  • Detector de cortes: apenas a sintonia do proprietário (G4); a contagem automática de cortes estava errada em cerca de 60% dos vídeos de anúncio-promo até ser verificada nos quadros; um exemplo de tipo cinético leu 108 cortes/min automaticamente vs 42 das folhas.
  • ASR (máquina do proprietário, E08, uma passagem, fala lida): Vulkan 5.82 áudio-s por parede-s, CPU CT2 int8 0.84, WER 17.7-19.4%: references/volatile-facts.md (datado; expira em 31/12/2026).
  • A análise de som só é executada de verdade: batidas/BPM/tom precisam >= 3 s de música; vocais cantados precisam da passagem de letras sem VAD (apenas segmentos confiantes, marcados como "SUNG LYRICS").

Referências (carregar quando)

  • references/output-contract.md - escrever, portar ou depurar qualquer arquivo de saída; ler um relatório de validação.
  • references/thresholds.md - sintonizar ou portar o detector, escolher --detail, explicar uma contagem errada.
  • references/reading-and-breakdown.md - antes de ler folhas e antes de escrever a análise.
  • references/volatile-facts.md - antes de citar qualquer velocidade, WER, preço, licença ou fato de ferramenta (módulo datado).
  • agent-content/references/asr-routes.md (rotas canônicas de ASR, de propriedade de outro lugar) e hebrew-captions-asr (transcrições de nível legenda); reference-style-transfer consome as pastas deste skill.
  • Scripts: scripts/validate_analysis.py (verificação de contrato, --self-check), scripts/cut_regression.py (portão F1, --self-check); ambos falham fechados (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

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