Communitygithub.com

edit-workflow-intake

Transforma una nueva idea, brief o lista de especificaciones en un Libro de Contabilidad (Concept Ledger) verificable y realiza preguntas hasta que cada parámetro sea preciso, antes de cualquier concepto, prompt o construcción. Úsalo al inicio de cualquier video nuevo, con o sin material de archivo, o cuando el usuario pegue un concepto con especificaciones.

¿Qué es edit-workflow-intake?

Este skill, denominado 'video-intake', actúa como la puerta de entrada obligatoria para cualquier proyecto de video nuevo (etapa wf-00). Su función principal es convertir una idea o brief inicial en un 'Concept Ledger' (libro de contabilidad de conceptos) con filas medibles para cada elemento concreto, un archivo BRIEF.md, y hasta tres tarjetas de concepto si el usuario no ha fijado uno. Su objetivo es eliminar toda ambigüedad antes de invertir tiempo en prompts o generación, asegurando que parámetros como plataforma, duración, tono, calidad y llamada a la acción (CTA) se determinen mediante un bucle de preguntas iterativo, y no por suposición. El skill sigue reglas estrictas: no adivina ningún parámetro (como formato, duración, tono, barra de calidad, CTA, archivo) y mantiene un registro detallado de cada afirmación del usuario (INTAKE_LOG.md). Cada afirmación concreta se convierte en una fila del libro de contabilidad, con el texto original del usuario, una especificación medible y un estado de verificación. El skill utiliza un bucle de preguntas de 3-4 preguntas por ronda, siempre ofreciendo opciones concretas y recomendando una por defecto. No se permite la generación de prompts o código hasta que el usuario haya aprobado explícitamente el PROMPT.md. El skill está diseñado para agentes de IA como Claude Code, Cursor o Codex, y se ejecuta mediante scripts de Python (ledger_check.py, source_inventory.py). Utiliza una serie de puertas de control (G1 a G7) que verifican la integridad del libro de contabilidad, la ausencia de suposiciones, la lectura del árbol de fuentes, el análisis de referencias, la creación de tarjetas de concepto, la verificación de derechos y la transferencia al escritor de prompts. Si alguna puerta falla, el proceso se detiene y se solicita la corrección necesaria. En resumen, este skill es fundamental para cualquier flujo de trabajo de edición de video que busque ser metódico y evitar retrabajos. Al forzar la claridad y la precisión desde el principio, se asegura de que el agente y el usuario estén completamente alineados antes de pasar a las fases de creación y producción, ahorrando tiempo y recursos.

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

Preguntar en tu IA favorita

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

Documentación

video-intake

La puerta por la que pasa cada nuevo video primero (etapa wf-00). Salida: un registro de entrada literal, un Libro de Contabilidad con una fila medible por cada elemento concreto, BRIEF.md y (si el usuario no fijó un concepto) tres tarjetas de concepto. No escribe ningún PROMPT cuadro por cuadro, ningún código, ninguna generación.

Reglas que nunca se doblan

  1. Registro hasta que sea preciso. Sin referencia, pregunta. Plataforma, duración, tono, CTA, estructura (corte de silencios vs. reconstrucción) y barra de calidad nunca se adivinan.
  2. Cada cosa concreta que el usuario escribió se convierte en una fila del libro con una id, en las propias palabras del usuario (el hebreo permanece en hebreo). Las afirmaciones compuestas se dividen ("globo más grande y persona más alta" = 2 filas).
  3. No hay tarjetas de concepto, estructura de PROMPT ni construcción hasta que las filas bloqueantes estén bloqueadas: FMT, LEN, TON, BAR, CTA, FILE; más STR y COLOR cuando hay material de archivo; más VAR cuando se entrega más de un archivo.
  4. El PROMPT.md es aprobado por el usuario antes de la primera línea de código, también en ejecuciones autónomas: el agente redacta, el humano aprueba (decisión por defecto Q6). Orden de cambio: libro de contabilidad -> PROMPT -> código.
  5. No hay gasto aquí. La admisión es planificación. La generación de IA necesita paid-generation-gate; "solo planificar" significa cero generación. Derechos poco claros + generación planificada = bloqueado.
  6. Las filas bloqueadas nunca se sobrescriben: agrega una fila y tacha la anterior (tachada por L<nn>, o ~~antiguo~~ -> nuevo, hora en la especificación).
  7. Pregunta solo lo que es desconocido y material. No preguntes sobre herramientas o carpetas; decide y di por qué en una línea.
  8. Las habilidades son procedimiento, no permiso: los límites del usuario y del proyecto sobre gasto e instalaciones ganan. No probado en un modelo (decisión por defecto Q4).

Flujo

  1. Lee lo que existe: el mensaje, los archivos adjuntos y todo el árbol fuente: python scripts/source_inventory.py <carpeta fuente> --write projects/<nombre>/_work/intake (escribe source_ls.txt + probe.json; un original de cámara 4K una vez quedó sin verse junto a un corte bruto). Verifica projects/ para un proyecto hermano en la misma fuente: pregunta "¿nuevo proyecto o continuación de X?". Ramificaciones (referencia, prompt pegado, "חדש לגמרי", "רק תכנן"): references/branches-and-mistakes.md.
  2. Registra literalmente en _work/intake/INTAKE_LOG.md: las palabras del usuario como líneas simples, tus preguntas como líneas Q: bajo ## Ronda N.
  3. Analiza el libro de contabilidad en el bloque <libro> de hf/PROMPT.md (un borrador sin <estructura> todavía): ids, dim, dicho, spec medible, dónde / cuándo, verificación de aceptación, src U/R/D/A, estado (references/ledger-template.md).
  4. Bucle de preguntas (references/question-bank.md): rondas de 3-4 preguntas, opciones concretas, la primera = la recomendada; BAR en la ronda 1. Después de cada ronda imprime נעול: ... | פתוח: ... y actualiza el libro de contabilidad. "תמשיך" / "continuar" = toma las opciones recomendadas, marca D, dilo en UNA línea.
  5. ¿Referencia presente? entrégala a reference-style-transfer y pregunta qué rango de tiempo es "el estilo". Ausente: sigue preguntando; nunca inventes un estilo.
  6. Conceptos: si el usuario no fijó uno, tres tarjetas Probado / Atrevido / Salvaje que difieran en el concepto; recomienda una (references/concept-cards-and-brief.md).
  7. BRIEF.md a partir de la plantilla (agent-content/techniques/templates/BRIEF.md) con los datos de derechos, ejecuta ledger_check.py, entrega al escritor de PROMPT, espera la aprobación, luego registra PROMPT_APPROVED <fecha> "<palabras>" en hf/CHANGELOG.md.

El bucle de preguntas en resumen

  • 3-4 preguntas por ronda, de mayor impacto primero: FMT / LEN / STR / BAR, luego HOOK / TON / LOOK / MOT, luego TYPE / 3D / BROLL / BRAND, luego CAP / MUS / SFX / CTA, luego FILE / VAR / DUE.
  • Cada opción es concreta (un número, un nombre, un hex, un archivo); la primera opción es la recomendada, etiquetada (מומלץ) / (recomendada) con una línea que explique por qué. Elección visual: agrega una vista previa, o un tablero-de-opciones cuando haya 3+ opciones de gusto pendientes.
  • Nunca preguntes lo que ls, ffprobe o el mensaje ya responden; nunca preguntes sobre herramientas o carpetas.
  • Después de cada ronda: נעול: L01 L02 ... | פתוח: HOOK LOOK ....
  • Sin referencia proporcionada significa preguntar; una referencia proporcionada significa analizarla y preguntar solo lo que una referencia no puede responder (duración, relaciones, estructura, CTA, nombre de archivo, barra, licencia de música, fecha límite).

Mensaje de la Ronda 1 (Hebreo / Inglés)

סבב 1 - ארבע שאלות, לכל אחת ברירת מחדל מומלצת:
1. פלטפורמה ויחס? (מומלץ: 9:16 ריילס/טיקטוק; מאסטר אחד, שאר היחסים בעיצוב מחדש)
2. כמה שניות בדיוק? (מומלץ: התוכן המלא בצילום; 45 במושן)
3. חיתוך שתיקות בלבד, או בנייה מחדש? (מומלץ: שתיקות בלבד, סדר טבעי, משפטים שלמים)
4. רמת איכות? (מומלץ: פרימיום - ביט גרפי כל 3-6 שניות, צבע מדוד)
Ronda 1 - cuatro preguntas, cada una con un valor predeterminado recomendado: 1. plataforma y relación, 2. segundos exactos, 3. solo corte de silencios o reconstrucción, 4. barra de calidad.

Una fila del libro de contabilidad de un vistazo

| L02 | TRN | "Film burn en segundo 1-2" | el archivo de burn del usuario, fotograma completo, blend de pantalla | 1.00-2.00 s (f30-60) | tira de fotogramas f28-62: burn visible, nombre de archivo coincide | U | bloqueada | Una afirmación por fila; dicho textual; spec medible; un dicho temporizado necesita un rango y una verificación a nivel de fotograma (el verificador exige ambos).

Señales de que la admisión va mal

La duración o la plataforma aparecen sin una frase del usuario detrás; una tarjeta de concepto existe antes de que FILE o CTA estén bloqueados; una fila D que el usuario nunca vio; la carpeta fuente nunca se listó; el PROMPT tiene un bloque <estructura> y no tiene una línea PROMPT_APPROVED.

Puertas de control

Estados: pass | fail | blocked | n/a con una razón. Un registro faltante, libro de contabilidad vacío, tiempo de espera o carpeta ilegible nunca pasa.

PuertaPredicadoEvidenciaSi es falsoPropietarioRevisar de nuevo
G1 integridad del libro de contabilidadcada cláusula concreta en el registro de entrada tiene una fila; cada cita de fila U está en el registro; 0 filas inventadaspython scripts/ledger_check.py hf/PROMPT.md --source _work/intake/INTAKE_LOG.md sale 0 (estado PASS, cobertura checked)agrega las filas faltantes, o --waive una cláusula con una razón; nunca edites el registro para que coincidavideo-intakecualquier nuevo mensaje del usuario o edición del libro de contabilidad
G2 sin suposicionesFMT, LEN, TON, BAR, CTA, FILE (+STR, COLOR con --footage; +VAR con --variants) cada uno proviene de U/R/A aprobado, o de una fila D que el usuario vio; <= 4 preguntas por rondael mismo script: blocking todo ok, sin too_many_questionshaz la siguiente ronda; no escribas conceptosvideo-intakeuna respuesta cambia una fila bloqueante
G3 árbol fuente leídotodo el árbol fuente fue listado; candidatos a cámara original reportados o unknown_work/intake/source_ls.txt y probe.json existen y están citadosvuelve a ejecutar; un listado blocked permanece bloqueadovideo-intakenuevos archivos agregados a la fuente
G4 rama de referenciareferencia presente -> reference-style-transfer y el rango de tiempo del estilo registrado; ausente -> el bucle continúalínea de rama en el registro de entradano inventes un estilovideo-intakeel usuario agrega una referencia
G5 tres conceptos3 tarjetas, diferentes por pares en >= 2 de dispositivo de gancho / estructura / lenguaje visual; cada una enumera los ids del libro de contabilidad que obedecelas tarjetasregenera la más débilvideo-intakeuna fila bloqueante cambia
G6 derechosBRIEF.md tiene una sección Fuente y derechos llena (propietario/consentimiento del metraje, licencia de música/stock por archivo, cuenta del cliente vs. propia)BRIEF.mdbloqueado: sin generación paga, sin uso publicitario de Licencia: desconocida (decisión por defecto Q2)video-intakeaparece un nuevo activo
G7 traspasoledger_check.py hf/PROMPT.md --source ... --prompt hf/PROMPT.md sale 0 (cada id citado >= 2x) y PROMPT_APPROVED está en hf/CHANGELOG.mdsalida del script + la líneaPROMPT permanece como borrador; sin códigoEscritor de PROMPTcualquier cambio en el libro de contabilidad o PROMPT

Salidas

_work/intake/{INTAKE_LOG.md, source_ls.txt, probe.json}, el bloque <libro> en hf/PROMPT.md, hf/BRIEF.md, la tarjeta de concepto elegida, las filas de variantes (una por archivo), la lista OPEN:, el JSON de verificación del libro de contabilidad.

Condiciones de parada

  • El usuario dice "solo empieza": toma los valores predeterminados recomendados como D y di cuáles; aún así pregunta por la CTA, FILE y cualquier elemento bloqueante que no hayan visto.
  • Una nueva solicitud contradice una fila bloqueada: muestra ambas, pregunta cuál gana; nunca elijas en silencio.
  • El usuario quiere saltarse la aprobación del PROMPT: rechaza el atajo, ofrece un PROMPT más corto, no uno saltado.
  • La admisión supera las 4 rondas: resume bloqueado | abierto y pide al usuario que resuelva el resto con un solo "continuar".

Referencias y scripts

  • references/ledger-template.md: cargar al crear o editar el libro de contabilidad (formato que analiza el verificador, códigos de dimensión, tipos de verificación, ejemplo).
  • references/question-bank.md: cargar cuando un campo falta o antes de componer una ronda (Hebreo + Inglés, opciones, plan de ronda).
  • references/branches-and-mistakes.md: cargar cuando la entrada es una referencia, un prompt pegado, un proyecto hermano, o después de una falla de puerta.
  • references/concept-cards-and-brief.md: cargar al escribir tarjetas de concepto, BRIEF.md, los datos de derechos o el traspaso.
  • scripts/ledger_check.py, scripts/source_inventory.py: stdlib; cada uno tiene --self-check.
  • Técnicas compartidas (otro propietario): agent-content/techniques/concept-ledger.md (reglas canónicas del libro de contabilidad), agent-content/techniques/question-bank.md (banco completo en hebreo); libro de jugadas de etapa 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).

Skills relacionados