Communitygithub.com

Shorts

Crea YouTube Shorts en dos modos: Clip (recorte de un episodio terminado con candidatos del transcript y retención, un corte aproximado 9:16 alrededor del rostro, gráficos verticales, música con derechos claros, y verificación del Crítico) y Original (Short grabado por sí mismo: tres ideas con evidencia del trabajo real del usuario, el usuario habla libremente, el Escritor lo acorta, solo se graba al hablante, el equipo aporta el metraje de apoyo).

¿Qué es Shorts?

Este skill permite generar YouTube Shorts de forma automatizada, ofreciendo dos modos principales: - **Clip**: Extrae un Short a partir de un episodio ya publicado. El Scout identifica automáticamente los mejores pasajes (basándose en la transcripción y datos de retención) y propone hasta tres candidatos. Luego, el Editor crea un corte vertical 9:16 alrededor del rostro, ajusta los gráficos, añade música con licencia clara y el Crítico verifica que no haya errores. - **Original**: El usuario graba un Short desde cero. El Scout genera tres ideas basadas en el trabajo real del usuario, el usuario habla libremente durante 2-3 minutos, y el Escritor lo acorta siguiendo reglas de narrativa breve. Solo se graba al hablante; el equipo agrega el metraje de apoyo (pantallas, renders) después. Para publicar, se genera una tarjeta por Short (o se puede activar la aprobación permanente para que se publiquen automáticamente hasta dos al día). El skill también analiza resultados tras 48 horas y puede sugerir reglas basadas en datos después de diez Shorts. Soporta plataformas como Claude Code, Cursor y Codex, y requiere acceso a YouTube Analytics para datos de retención.

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

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Shorts?

Un Short es un pequeño episodio en formato vertical (1080x1920) con menos pasos. Clip proviene de un episodio terminado y no le cuesta al usuario más que un sí. Original se graba por sí mismo, para probar rápidamente qué funciona. Los datos sugieren que el usuario decide: una idea fuerte que no tenga sentido para el usuario en ese momento se descarta sin discusión.

Qué modo (Showrunner)

SituaciónHacer
Un episodio está editadoEl Scout busca candidatos de clip por su cuenta; la tarjeta llega con o justo después de la vista previa
Un episodio lleva dos días en línea y existen datos de retenciónEl Scout verifica si hay un pasaje fuerte que aún no sea Short; una tarjeta si es así
"haz un short sobre …"Original
"haz shorts", nada másUna tarjeta: hasta tres candidatos de clip del último episodio y tres ideas originales
Sin video por mucho tiempo, ninguno en procesoIdeas originales, como máximo una vez por semana, a menos que el usuario lo haya desactivado
Una idea original que el usuario ya dijo en un episodioDecirlo: "Ya lo dijiste en el episodio 12. Un clip no requiere grabación."

Clip primero cuando exista material. Nuevo Short: crewcut episode new "<título>" --short clip --from <episodio> o --short original. La barra de pasos muestra solo sus pasos (clip 6, original 9).

Clip

  1. Candidatos (Scout). crewcut cut candidates --episode <fuente> lista pasajes independientes con tiempos. Un candidato necesita: una primera oración que se sostenga sin el video anterior y que contenga una afirmación o un resultado; una prueba en la imagen (un número, una comparación, un resultado), no solo una cabeza parlante; un final real, nunca una oración cortada a la mitad; de 20 a 55 s de aproximadamente doce oraciones completas como máximo (pueden venir de diferentes lugares). Con datos de retención, preferir pasajes donde la curva suba. Sin datos, decir que se trabajó solo con el texto. Verificar que los originales y la voz limpia existan antes de proponer un candidato.
  2. Una tarjeta, los tres mejores: título, primera oración, duración, una imagen fija cada uno, fuerza del 1 al 10 y esfuerzo (pequeño, mediano, grande: ¿el material está en vertical o hay que volver a grabar pantallas?). Botón "Hacer estos tres".
  3. Corte aproximado (Editor). crewcut cut short con las piezas por palabra de inicio y fin (o segundos fijos cuando los tiempos de palabra fallan): volver a la grabación original, 9:16 alrededor del rostro, la voz limpia del episodio, nuevos tiempos de palabra. Una pieza nunca cruza un límite de corte. Si el original es demasiado pequeño para un recorte vertical nítido (landscape 1080p), decirlo antes de construir, no después.
  4. Gráficos verticales. Escenas 2D renderizadas nuevamente en vertical con el paquete de estilo. Pantallas y páginas web grabadas de nuevo en vertical (crewcut render capture), nunca la imagen horizontal recortada. El 3D del episodio vuelve como tarjeta o capa; el 3D vertical nuevo tiene costo de alquiler y necesita una tarjeta. Máximo shorts.text_cards_max tarjetas de texto; cada imagen entendida en dos segundos; símbolos antes que texto; movimiento calmado (nada que crezca píxel a píxel).
  5. Música. Solo música con derechos claros y un archivo fuente (crewcut render music-bed): debajo de la voz a shorts.music_db, con ducking, un pequeño hueco antes del remate. Nunca la música del video largo a menos que su licencia lo permita.
  6. Verificación (Crítico). crewcut cut short-check: el conjunto de reglas de Short (rostro en cuadro, sin texto sobre el rostro ni el borde derecho donde están los botones de YouTube, brillo, duración y ritmo según el paquete de estilo, volumen con el margen del limitador, límites de piezas a nivel de audio). Mirar la hoja de contacto; escribir la lista "por favor escuchar" con marcas de tiempo para el usuario: nadie más que el usuario oye el sonido. 0 errores antes de la tarjeta de vista previa.

Original

  1. Ideas (Scout). Fuentes: Shorts de los canales que el usuario nombró, por vistas sobre la mediana del canal; lo que el usuario realmente hizo (episodios recientes, pruebas, lo que contó en el chat). Nunca inventar una experiencia. Formatos que funcionan (análisis de Nate Herk de 50 Shorts, un canal de EE.UU. con más de un millón de suscriptores; una dirección, no una promesa): el Short es la prueba ("Claude construyó esto"), primera opción; historia en primera persona con un wow, segunda opción; historia de otra persona, posible; presentación de herramientas y noticias, evitar; encuestas callejeras, evitar. Una tarjeta con tres ideas: primera oración, la prueba que estará en la imagen, el formato, la evidencia de los datos. Sin prueba, no hay idea.
  2. El usuario habla primero, luego el Escritor acorta. Pedir en un mensaje de dos a tres minutos de charla libre (el micrófono en el compositor), con cuatro preguntas: ¿Qué hiciste? ¿Qué pensabas antes? ¿Qué salió mal o te sorprendió? ¿Qué número tienes? Conservar las palabras del usuario y ordenarlas: yo, evento, número (la primera oración contiene todo el conflicto); un ancla temporal o un número en una serie; lo que pensé; el giro, con la prueba en la imagen (una demo corre en cinco segundos); qué hago diferente ahora; un cabo suelto. Longitud según shorts.words (por defecto 110 a 170 palabras, 30 a 50 s).
  3. Verificación y humanización. python3 skills/script/scripts/script_check.py <archivo> --short hasta 0 errores, luego el pase del Humanizer (skills/script). El botón de la tarjeta del guion es "Esto realmente pasó": el usuario confirma que la historia es verdadera (--data '{"button": "Esto realmente pasó"}').
  4. Grabación: solo el hablante, vertical u horizontal con espacio para recortar, desde el teleprompter o desde puntos clave. Nada más: sin pantalla, sin manos, sin segundo ángulo.
  5. Metraje de apoyo (Editor): la prueba real del trabajo del usuario (una grabación de pantalla vertical, un render, un número como escena), escenas 2D con el paquete de estilo, 3D solo si el paquete lo incluye (con la estimación habitual). Nada preparado, ninguna cita inventada. Diseño según shorts.layout: "full", o "proof-top" (prueba arriba, rostro abajo, el final en el rostro).
  6. Verificación como en el paso 6 de Clip.

Título, miniatura, enlace al video largo

  • Título con las verificaciones habituales de título, más corto. La primera oración y el título dicen lo mismo.
  • Miniatura (Diseñador): vertical con borde inferior libre.
  • Enlace: el paquete obtiene related_url (el video largo) para clips; la subida lo agrega a la descripción y como comentario. "Video relacionado" y fijar no tienen API: decirle al usuario en una línea que los configure en YouTube Studio.

Publicación

  • Una tarjeta de publicación por Short, a menos que el usuario haya activado la aprobación permanente para Shorts: el segundo botón silencioso en la tarjeta de publicación de un Short, o crewcut shorts standing on (como miembro del equipo esto propone la tarjeta; solo el sí del usuario la activa). Cubre solo Shorts, solo después de que short-check haya encontrado 0 errores, nunca con material de terceros o una persona ("third_party": true en el paquete), y no el primer Short después de cambiar el paquete de estilo. Cada Short se sube como privado, se lee en voz alta, y solo entonces se vuelve público o programado. Desactivado: "pregúntame de nuevo para Shorts" → crewcut shorts standing off. Con la aprobación permanente, la API es el camino correcto: ninguna mano en el archivo.
  • Cuándo: crewcut shorts slot --episode <short> da el próximo horario libre (máximo shorts.per_day_max al día en shorts.publish_times, nunca dos Shorts con el mismo mensaje principal en un día, pares uno tras otro). "Todos a la vez" es una frase del usuario.

Resultados

Después de 48 horas: crewcut shorts results --episode <short> agrega una fila a studio/shorts.tsv (modo, formato, duración, subtítulos, primera oración, vistas, porcentaje promedio de visualización, suscriptores). A partir de diez Shorts, el Scout puede proponer una regla de la tabla como tarjeta ("Tus Shorts de menos de 40 s retienen un 20 % más de espectadores. ¿Poner 40 s como límite?"). Antes de diez, no decir nada sobre patrones.

Límites honestos

  • Construido y probado unitariamente; aún no se ha hecho un Short completo con Crewcut.
  • Un recorte fijo necesita al hablante cerca del centro; un recorte que sigue a un hablante en movimiento está planeado.
  • Los datos de retención necesitan la API de YouTube Analytics (conectada con YouTube).

Fuentes

  • Nate Herk (https://www.youtube.com/@nateherk): Shorts como prueba; la clasificación de formatos anterior es nuestro resumen de un análisis de sus 50 Shorts.
  • Narrativa de reel de Farza, Chris Raroque, Roy Lee, Riley Brown, Varun Mayya y Codie Sanchez (enlaces en README): primera persona, el giro, números reales desiguales; el usuario habla, el agente acorta.

Individual skills in this repo

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

edit

Builds a video version from the user's recording: the speaker cut, then one edit plan with all inserts (2D scenes, 3D scenes, recordings, keywords), sound and music, built with one command (crewcut render). Use for: edit the video, build the cut, speaker cut, rough cut, insert, b-roll, 2D scene, 3D insert, counter, keyword, music bed, sound, assemble, render the preview, new plan version, short from the long video.

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.

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