Communitygithub.com

Malik-rgb43/editing-workflow

Convierte un video (archivo, enlace de YouTube/TikTok/Instagram o carpeta de clips) en mediciones, hojas de fotogramas clave, transcripción en hebreo y análisis de sonido (SFX, BPM, tonalidad, beats, identificación de canción). No edita ni renderiza.

¿Qué es editing-workflow?

Este skill permite analizar videos de forma detallada sin necesidad de subirlos a servicios externos, convirtiéndolos en datos legibles por un modelo. Soporta plataformas como YouTube, TikTok e Instagram, así como archivos o carpetas locales. El análisis incluye mediciones numéricas por fotograma, hojas de contacto con marcas de tiempo, transcripción en hebreo, análisis de sonido (BPM, tonalidad, efectos) e identificación de canciones (sin implicar licencia). El skill sigue un procedimiento estricto: primero verifica el entorno, luego ejecuta el análisis en segundo plano, valida los resultados, revisa cada hoja y cada imagen de audio, aplica correcciones y finalmente genera un informe estructurado. Está diseñado para ser local, gratuito y privado, prohibiendo el envío de material sensible a APIs de pago o remotos sin aprobación explícita. Solo se dedica a una tarea pesada a la vez y no realiza edición, renderizado ni aplicación de estilos.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

video-analysis

Convierte un video en lo que un modelo puede leer: una medición numérica de cada fotograma, hojas de contacto con marcas de tiempo, una transcripción, una línea de tiempo de sonido e imágenes de espectrograma, y luego un desglose escrito a partir de ellos. Es un procedimiento sobre la herramienta de análisis, no la herramienta (el script privado del propietario no se distribuye; el puerto para estudiantes sigue TOOLS_SPEC). Nunca edita, renderiza ni aplica un estilo.

Reglas que prevalecen sobre el resto de este archivo

  1. Las entradas son de solo lectura. Hash antes y después (input.sha256 = sha256_after); las salidas van solo bajo analysis/<video>/. Descarga solo la URL que el usuario dio, nombrando la fuente y el archivo; es una copia de referencia, nunca redistribuida; una marca de agua de la plataforma, tarjeta final y jingle se excluyen de las estadísticas y se listan.
  2. La cobertura se indica primero. Cada informe abre con un bloque de cobertura: completo vs muestreado, fotogramas decodificados de los esperados, qué se excluyó, qué NO se ejecutó. Una muestra nunca se presenta como cobertura completa. Una ejecución muestreada no puede citar conteos de cortes o ritmo como hechos medidos.
  3. Ejecuta la herramienta; nunca muestrees manualmente con ffmpeg. Si la herramienta falta, indica blocked: tool_missing y pide; se permite una alternativa manual solo como una inspección sampled explícitamente etiquetada sin conteos.
  4. Lee antes de escribir: revisa CADA hoja y CADA imagen de audio; haz zoom 3-6 veces; decide cada punto de edición check a partir de fotogramas; corrige conteos incorrectos y dímelo.
  5. Local, gratuito, privado. Sin API de comprensión de video paga, sin subida del video o sus fotogramas o audio, sin identificación remota de canciones en material private, sin una estimación fechada y aprobación previa (paid-generation-gate). El habla en hebreo se fuerza a he; nunca confíes en una sola pasada de ASR para nombres, marcas y números.
  6. Una coincidencia de canción no es una licencia. Informa "identificado como X, permiso de sincronización no establecido" o "no identificado"; nunca inventes un título. Las etiquetas de estilo AudioSet son suposiciones ("probablemente un whoosh"); el tempo y la tonalidad son estimaciones con auditoría de mitad/doble tiempo.
  7. Una tarea pesada a la vez bajo render_lock; cualquier cosa de más de aproximadamente 2 minutos se ejecuta en segundo plano con un registro y una ETA; sin promesa de tiempo de ejecución (lote del propietario: 9-23 min por video bajo carga, dependiente de la máquina). Las habilidades son procedimiento, no permiso: las restricciones del usuario y del proyecto anulan este archivo.

Interfaz de herramienta que espera esta habilidad (TOOLS_SPEC video-analysis; verifica con --help)

python tools/analyze.py <video|URL|carpeta> --out analysis/<video> [--detail quick|standard|full]
       [--asr auto|always|never] [--no-song-id] [--no-audio-ai] [--check]
python tools/frames.py <video> --at <t> --pad 0.25 --out analysis/<video>     # cada fotograma de una ventana corta

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

Procedimiento

#HazArtefacto
0Pregunta solo qué cambia en la ejecución: desglose completo o una pregunta (cortes / transcripción / canción)? ¿Material confidencial (private)? ¿Qué idioma para el desglose? ¿Una carpeta? Lista primero; nunca sobrescribas un análisis anteriorlínea de alcance
1Preflight (analyze --check / doctor): registra SO, ffmpeg, ruta ASR detectada (CPU / Vulkan / CUDA / MLX; none si no se detecta), el flag de entorno Vulkan; sin ruta = blocked solo para transcripciónbloque environment
2Ejecuta en segundo plano bajo el bloqueo. --detail: quick para corpus/charla larga, standard por defecto, full para gráficos en movimiento, ediciones muy rápidas o una referencia para transferir (references/thresholds.md). Varios videos: un lote, luego un agente por video (solo su carpeta, breakdown.md como salida, fecha límite, respuesta <= 10 líneas)carpetas de análisis
3python scripts/validate_analysis.py analysis/<video> --stage producedPASS o los componentes que fallan
4Lee: todas las hojas, todas las imágenes de audio; haz zoom solo en dispositivos distintos; resuelve puntos check; corrige el conteo (pacing.override + review.corrections); audita tempo mitad/doblebloque review
5python scripts/validate_analysis.py analysis/<video> --video <source>; se requiere salida 0 para presentar números como hechosinforme de validación
6Escribe breakdown.md en el idioma del usuario según references/reading-and-breakdown.md (cobertura primero, 7 secciones, incertidumbres al final)breakdown.md
7Informa: la ruta del archivo, 5-10 líneas, las correcciones, lo que no se pudo establecer; ofrece la siguiente habilidad (reference-style-transfer, una habilidad de tipo) en lugar de hacerlomensaje

Puertas

Los estados son pass | fail | blocked | n/a con una razón. Un timeout, muestra vacía o entrada faltante es blocked, nunca pass. Una llamada exitosa de la herramienta es evidencia de ejecución; las hojas vistas son evidencia de apariencia.

PuertaPredicadoEvidenciaSi es falsoPropietarioRevisar cuando
G1 perfil de máquinaRuta ASR detectada y registrada; la ruta Vulkan registra GGML_VK_DISABLE_COOPMAT (el controlador AMD del propietario necesita =1; otros controladores no probados)measurements.environment de doctor/--checkrecurre a la ruta CPU y dímelo; nunca asumas una GPUesta habilidad + doctornueva máquina, controlador o modelo
G2 contrato válidolos cinco componentes pasan o son n/a con una razónvalidate_analysis.py salida 0 (--video proporcionado)arregla o vuelve a ejecutar el componente; informa INSUFICIENTE con la pieza faltantevalidate_analysis.pycualquier re-ejecución o edición manual
G3 declaración de coberturael informe abre con modo, fotogramas decodificados/esperados, exclusiones, lista de no ejecutados, claims_not_allowedprimer bloque de breakdown.mdagrégalo; degrada afirmaciones a "muestreado"esta habilidadcada informe
G4 regresión del detector de cortescualquier cambio en un umbral del detector mantiene F1 >= la línea base del conjunto etiquetado (histórico del propietario 0.89 = P 0.87 / R 0.91 en 20 anuncios verificados a mano, 339 puntos de edición, privados, no reproducidos; punto ciego conocido: tipo cinético y piezas de cámara continua)cut_regression.py --pair ... --min-f1 0.89 salida 0 con >= 100 puntos de verdadrevierte el cambio de umbralcut_regression.pycada cambio de detector; nunca a simple vista
G5 entradas intactashash de fuente igual antes y despuésvalidate_analysis.py --videorestaura el archivo desde el original, vuelve a ejecutarvalidate_analysis.pycada ejecución
G6 leer antes de escribircada hoja de fotogramas clave/panorámica e imagen de audio vista; cada punto check resuelto; conteos verificados en fotogramasbloque review completo (etapa revisada)vuelve y revísalosesta habilidadcada análisis
G7 privacidad y derechosentrada private: sin identificación remota de canciones, sin ASR en la nube, sin subida de fotogramas; coincidencia = sin licenciasong_id.status, asr.routeelimina el registro de extracto, vuelve a ejecutar localmenteesta habilidadcada ejecución

Números y límites para citar con su alcance

  • Detector de cortes: solo la afinación del propietario (G4); el conteo automático de cortes fue incorrecto en aproximadamente el 60 % de los videos promocionales hasta que se verificó en fotogramas; un ejemplo de tipo cinético leyó 108 cortes/min automáticamente frente a 42 de las hojas.
  • ASR (máquina del propietario, E08, una pasada, habla leída): Vulkan 5.82 audio-s por wall-s, CPU CT2 int8 0.84, WER 17.7-19.4 %: references/volatile-facts.md (fechado; caduca el 2026-12-31).
  • El análisis de sonido solo se ejecuta realmente: beats/BPM/tonalidad necesitan >= 3 s de música; voces cantadas necesitan la pasada de letras sin VAD (solo segmentos seguros, etiquetados "SUNG LYRICS").

Referencias (cargar cuando)

  • references/output-contract.md - escribir, portar o depurar cualquier archivo de salida; leer un informe de validación.
  • references/thresholds.md - afinar o portar el detector, elegir --detail, explicar un conteo incorrecto.
  • references/reading-and-breakdown.md - antes de leer hojas y antes de escribir el desglose.
  • references/volatile-facts.md - antes de citar cualquier velocidad, WER, precio, licencia o hecho de herramienta (módulo fechado).
  • agent-content/references/asr-routes.md (rutas ASR canónicas, propiedad de otro lugar) y hebrew-captions-asr (transcripciones de grado de subtítulos); reference-style-transfer consume las carpetas de esta habilidad.
  • Scripts: scripts/validate_analysis.py (verificación de contrato, --self-check), scripts/cut_regression.py (puerta F1, --self-check); ambos fallan cerrados (salida 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).

Skills relacionados