Communitygithub.com

editar

Construye una versión de video a partir de la grabación del usuario: el corte del orador, luego un plan de edición con todas las inserciones (escenas 2D, escenas 3D, grabaciones, palabras clave), sonido y música, todo con un solo comando (crewcut render).

¿Qué es editar?

Esta habilidad convierte la grabación de un usuario en un video completo en dos etapas principales. Primero, genera el **corte del orador** seleccionando las mejores tomas, cortando en pausas y aplicando gradación de color. Luego, construye un **plan de edición** (`edit/plan-vNNN.json`) que define cada inserción (escenas 2D, escenas 3D, grabaciones, palabras clave), su sincronización con las palabras del orador, la música de fondo y los efectos de sonido. El comando `crewcut render` ejecuta todo el plan para producir el video final. Esta habilidad está diseñada para agentes de IA como Claude Code, Cursor o Codex que trabajan con el ecosistema Crewcut. No define estilos visuales (colores, fuentes, niveles); estos provienen de un paquete de estilo separado (`crewcut brand show`) y de reglas de gusto en `brand/rules/`. La habilidad incluye referencias detalladas para cada subproceso (grabación, planificación, sonido, escenas 3D) y verifica la calidad con una habilidad `cut-check`. Soporta renderizado local y en GPU alquilada, con estimaciones de costo antes de cada paso que consume recursos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/marcopatzelt/crewcut/tree/HEAD/skills/edit

Preguntar en tu IA favorita

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

Documentación

Editar: un plan, un comando

El Editor convierte la grabación del usuario en un video en dos partes. Primero el corte del orador: las mejores tomas, cortadas en pausas, con gradación. Luego el plan de edición (edit/plan-vNNN.json): cada inserción, sus palabras y señales, el sonido. La estación de trabajo crewcut render construye el plan. Nada en esta habilidad contiene un color, una fuente o un nivel: estos provienen del paquete de estilo (crewcut brand show). El gusto reside en brand/rules/edit.md y brand/rules/cut.md.

Leer primero

QuieresLee
cortar la grabación en el corte del oradorreferences/record-to-cut.md (sonido hasta el final, dividir archivos, última toma completa, dobles arranques, cortes en pausas, regrabar, gradar, mostrar y bloquear)
escribir el plan, elegir o construir una escena, mostrar una grabaciónreferences/plan-and-scenes.md (anclajes de palabras, contar la mezcla, forma por declaración, señales, nueva escena 2D, reutilización, grabaciones)
hacer música, ajustar niveles o alquilar una GPUreferences/sound-and-gpu.md (música a lo largo de la historia, elegida por medición, niveles, trampas de GPU, la tarjeta de costo)
construir una escena 3Dhabilidad 3d-scene
verificar antes de mostrarhabilidad cut-check (ejecutada por el Crítico, nunca por ti)

Nombres de escenas y sus claves de datos: templates/2d/BLOCKS.md y templates/3d/README.md. No copies listas de claves aquí.

Cómo se hace una versión

  1. Corte del orador (references/record-to-cut.md): crewcut ingest, crewcut transcribe, crewcut cut …. Ejecuta python3 skills/cut-check/scripts/cut_check.py <decisions> sobre él y corrige cada ERROR antes de construir sobre él.
  2. Palabras del corte final: crewcut transcribe audio/voice-vNNN.wav → work/words-vNNN.json. Todos los tiempos del plan provienen de estas palabras.
  3. Cuenta la mezcla, luego enumera los puntos (sección abajo). Envía la lista como una tarjeta antes del gran render: crewcut card propose --episode $CREWCUT_EPISODE --step edit --kind mix --title "Inserts for v002" --file edit/mix-v002.md. Sigue construyendo mientras está abierta; la tarjeta es una mirada, no un bloqueo.
  4. Escribe el plan con un pequeño script generador (edit/make_plan.py) que establece cada tiempo desde un anclaje de palabra. Nunca escribas segundos a mano. Esquema: docs/architecture.md, "Edit plan". Los valores dejados como null provienen del paquete.
  5. crewcut render plan edit/plan-vNNN.json: enumera cada inserción con fotogramas y señales. Léelo. Una inserción de medio segundo es un anclaje incorrecto.
  6. crewcut render 2d edit/plan-vNNN.json: inserciones 2D, localmente.
  7. 3D: crewcut render probe edit/plan-vNNN.json <id> da un fotograma fijo a la mitad del tamaño. Míralo junto a la referencia antes de cualquier otra cosa (habilidad 3d-scene). Luego la estimación de costo y la tarjeta (sección "GPU alquilada o local"), luego crewcut render 3d edit/plan-vNNN.json --rented --gpus N o --local.
  8. crewcut render cut edit/plan-vNNN.json: ensamblaje con la base musical, golpes, escritura, pausas, ducking y el objetivo de sonoridad del paquete. La salida no está verificada. Dile al Showrunner: "construido, sin verificar, no mostrar".
  9. Pasa la versión al Crítico (crewcut job add --episode $CREWCUT_EPISODE --identity critic --step edit "check plan-vNNN"). Solo después de que ambas verificaciones muestren 0 ERROR: la vista previa va a export/, el Showrunner la muestra como una tarjeta con el archivo (crewcut card propose … --kind preview --file export/<id>-vNNN-preview.mp4), e inmediatamente después de mostrar: crewcut render shown edit/plan-vNNN.json. A partir de entonces, cada cambio es una nueva versión del plan, incluso para dos fotogramas.

Un texto o número cambiado: cambia el plan (nueva versión), ejecuta los pasos 5 a 9. Solo las inserciones modificadas se renderizan de nuevo. crewcut render all <plan> ejecuta 2d, 3d y cut de una sola vez cuando no se necesita una revisión intermedia.

Mezcla primero, luego el plan

Estas se aplican a cada plan, antes de que se renderice un fotograma. Los límites provienen de edit-style.json.

  1. Símbolo antes que texto. Cada inserción muestra primero algo que sucede. Una tarjeta de texto (headline, post) solo donde el espectador debe leer una fuente real: como máximo text_cards_max fuentes y como máximo text_share_max de las inserciones a pantalla completa. keyword solo para un número o un nombre, como máximo keywords_max, cada uno de como máximo keyword_max_words palabras. Cuenta por tipo antes de renderizar; la verificación de estilo cuenta de nuevo.
  2. Simbólico significa 2D y 3D. 3D donde un objeto con una acción es la idea. 2D dibujado para procesos, cantidades, formas y comparaciones: formas que se construyen, mueven o cambian. Por punto, elige lo que un espectador entiende en 2 segundos. Una escena contiene como máximo una palabra o un número, sobre la palabra hablada.
  3. La referencia es el estándar, no "se renderiza". Compara con baseline.json y brand/references/. Las GPU alquiladas son para calidad: resolución completa, suficientes muestras, sombras suaves, bordes limpios. 2D es diseño en movimiento, no una diapositiva: las partes se construyen una tras otra, la cámara se desplaza un poco, las transiciones son suaves.
  4. Verifica cada escena antes del corte. Un fotograma fijo y una tira de 5 fotogramas junto a la referencia. Si parece una presentación de diapositivas, clip art o una plantilla, tírala y constrúyela de nuevo. Pocas escenas muy buenas superan a muchas mediocres; reutiliza una escena de 2 a 4 veces con otra palabra o estado.
  5. Material real, sin que te lo pidan. Una publicación, un anuncio o un resultado de terceros va en la imagen: la publicación como tarjeta con una marca en la palabra hablada, un video corto de terceros en una tarjeta con su fuente visible. Nunca una captura de pantalla inventada, nunca un logotipo de empresa que inventaste.
  6. La música pertenece a la historia (references/sound-and-gpu.md). Solo instrumentos, tranquila debajo de la voz, con una nota de fuente y derechos.
  7. Calcula rápido, nunca inactivo. Mientras las máquinas cargan, sigue trabajando localmente (plan, 2D, corte). Cada paso remoto tiene un límite de tiempo. Al final, demuestra que ninguna máquina está en ejecución.
  8. Muestra la lista antes del gran render (paso 3): tiempo, tipo, una línea de lo que se ve, el número de tarjetas de texto.

Escenas

Escenas 2D (HTML, renderizado por Chromium, estilizado por los tokens de la marca) y escenas 3D (Blender por código, templates/3d/). Claves de datos: templates/2d/BLOCKS.md, templates/3d/README.md. Qué forma para qué declaración: references/plan-and-scenes.md, sección 3.

TipoEscenas
Números y cantidades 2Dcounter, bars, grid, wave
Fuentes y material real 2Dheadline, post, clip-card, cards, swap
Ideas dibujadas 2Darea, flow, untangle
Sobre el orador (transparente) 2Dkeyword
3Dobject-word, row, grid3d, stack, slide, box, scale (kit compartido templates/3d/stage.py)
grabación"kind": "clip" con file, at, speed: una grabación terminada a pantalla completa

El paquete neutro incluye pocas escenas 3D generales. Las escenas propias del usuario van a brand/templates/ (nunca editar las plantillas de la aplicación). Una nueva escena obtiene una línea en BLOCKS.md o templates/3d/README.md y no se prueba hasta que se haya visto un fotograma de ella.

Reglas de mezcla (valores del paquete)

  • Proporción 3D: aproximadamente graphics_mix.3d de las inserciones; 2D lleva los números; el orador está en pantalla entre medias.
  • Corta en la palabra, no en el ritmo. La palabra en la imagen llega de 0 a 3 fotogramas antes de que se pronuncie.
  • Divide los tramos largos del orador con "speaker": [{"at": s, "zoom": z}] (zoom desde zoom_base hasta zoom_punch, nunca más de zoom_max).
  • El orador nunca está menos de speaker_min_seconds entre dos partes a pantalla completa, y al menos speaker_open_close_seconds al principio y al final.
  • Sonido: base musical a music_db con duck, un golpe solo en puntos fuertes, escritura debajo de los contadores, un breve silencio en la música antes del número más importante. Sonoridad loudness_lufs, pico verdadero como máximo true_peak_db.
  • Fuentes honestas: una tarjeta de titular nombra la fuente real.
  • Nunca afirmes una comprobación de visualización o audición que no haya ocurrido. Esta sesión no puede oír: nombra los tiempos.

Cuando apliques una regla que proviene de una fuente nombrada, puedes decirlo en una línea, por ejemplo crewcut say --episode $CREWCUT_EPISODE --cite "fast cutting and keyword captions after Alex Hormozi's editing style" "…".

GPU alquilada o local

  • Los fotogramas 3D se renderizan en Blender Cycles. Local significa la CPU del contenedor: adecuado para pruebas a mitad de tamaño y escenas muy cortas. Cualquier cosa más larga va a una GPU alquilada.
  • Costo primero. crewcut compute estimate --kind blender --frames N [--local-sec-per-frame S] imprime tiempo y dinero para local y alquilado. Pon la estimación en una tarjeta (--kind spend, título con el monto), espera con crewcut card wait <id>. Salida 3 significa no: renderiza localmente o descarta la escena. Solo una identidad con may_spend: true alquila (el Editor).
  • Siempre: fotogramas fijos a la mitad del tamaño primero, luego la animación.
  • Solo el código de la escena y las fuentes van a una máquina alquilada. Nunca material de archivo, la voz, claves o datos privados.
  • Al final: crewcut compute destroy --all-ours, luego crewcut compute ledger --episode ID; el informe al usuario contiene el gasto y la prueba de que ninguna máquina está en ejecución. También después de un fallo.
  • Trampas y qué hacen las herramientas al respecto: references/sound-and-gpu.md, sección B.

Límites honestos

  • El agente no puede oír. Cada juicio de música y voz es una lista de escucha con tiempos para el usuario.
  • La detección de un resto de palabra, un doble arranque o un salto de nivel encuentra candidatos, no certezas.
  • La verificación de estilo mide límites; si una escena se ve bien solo una persona puede decirlo. Pon los fotogramas junto a la referencia y di claramente qué escenas aún están por debajo.

Planificado

  • Re-temporización de renderizados 3D cuando los tiempos de las palabras se desplazan unos fotogramas, para que no se rendericen de nuevo.
  • Música generada en una GPU alquilada a través de crewcut compute (el estudio lo hizo a mano; ver references/sound-and-gpu.md).
  • Grabaciones de páginas web como un paso de renderizado (Chromium está en el contenedor; todavía no hay comando).
  • Hojas de comparación (fotograma de escena junto a la referencia) como un solo comando.
  • Una autoprueba en el episodio de demostración en examples/demo/ una vez que exista.

Fuentes

Sin conexión ni respaldo de estas personas; tomamos ideas y escribimos nuestro propio resumen.

  • Alex Hormozi (estilo de edición y subtítulos hecho por su editor Ryan Magin), https://www.youtube.com/@AlexHormozi: corte rápido en la palabra y subtítulos de palabras cortas; aquí reducido a subtítulos de palabras clave.
  • fern (canal de YouTube), https://www.youtube.com/@fern-tv: inspiración solo para el aspecto 3D de arcilla. Sin valores tomados de él.

Individual skills in this repo

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

script

Writes the spoken script of an episode in the user's own voice (voice.md), in teleprompter form, after title and proof are fixed: opening that delivers the title's promise, small stories with rising stakes, the critical side, a verdict in its own form, the channel's closing line. skills/script/scripts/script_check.py checks form, sentences, opening, ending, numbers against the proof, and length. Delivered through the web teleprompter (crewcut prompter). Use when: \"write the script\", \"teleprompter text\", \"rewrite the script\", \"shorten the script\", \"make it sound natural\", \"script for the episode\". Not for titles or thumbnails. Short scripts: the `--short` mode of the check and skills/shorts.

shorts

Makes YouTube Shorts in two modes: Clip (cut from a finished episode: candidates from the transcript and retention, a 9:16 rough cut from the original recording around the face, portrait graphics, music with clear rights, the Critic's own Short check) and Original (a Short recorded for itself: three ideas with a proof from the user's real work, the user talks freely, the Writer shortens, only the speaker is recorded, the crew brings the B-roll). Publishing: one card per Short, or the user's own standing approval for Shorts; at most two a day. Use when: \"make shorts\", \"make a short about …\", \"clip this episode\", \"short from episode N\", \"publish shorts without asking\", \"how are my shorts doing\". Not for long videos (skills/episode, skills/edit).

title

Writes and checks the YouTube title and the thumbnail text of an episode, before the script. Delivers five candidates with a hook and a reason each, one recommendation, and three variants for the A/B test; skills/title/scripts/title_check.py checks every candidate against the style pack. Use when: \"title\", \"video title\", \"YouTube title\", \"what should the video be called\", \"check this title\", \"shorten the title\", \"better title\", \"thumbnail text\". Not for the blog's search title and not for the thumbnail image.

Skills relacionados