Communitygithub.com

clip-de-novedades

Para cada lanzamiento, crea un breve clip de "Qué hay de nuevo" filmado sobre la build real del producto: primero las palabras, revisado antes de que una persona lo vea.

¿Qué es clip-de-novedades?

Este skill permite crear clips de "Qué hay de nuevo" para cada lanzamiento de un producto, filmados directamente sobre la build real. Se enfoca en un flujo de trabajo estructurado: primero se redactan y acuerdan las palabras clave con el aprobador, luego se especifica cada escena, se filma desde un estado repetible, se renderiza con un solo comando y se revisan las imágenes antes de que una persona las vea. Soporta formatos como 9:16 y 1920x1080, integra ffmpeg y ffprobe, y mantiene el historial de especificaciones en el repositorio para facilitar la siguiente versión. Está diseñado para equipos de producto y desarrolladores que quieran comunicar cambios de forma rápida, precisa y consistente, evitando ediciones manuales y asegurando la aprobación final antes de publicar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GhostRoboticsLab/skills/tree/HEAD/skills/product/whats-new-clip

Preguntar en tu IA favorita

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

Documentación

Clip de novedades

Un clip de novedades le cuenta a la gente qué cambió en un lanzamiento, en el tiempo que lleva desplazarse más allá: una tarjeta de apertura que hace la misma pregunta cada lanzamiento y muestra la versión, una escena por cambio filmada en la build real del lanzamiento con su título, y una tarjeta final que indica dónde conseguirlo. Las palabras van primero y son las propias del aprobador. Se filma desde un estado sembrado y repetible, se renderiza con un comando, y se miran imágenes fijas de tu propio render antes de que cualquier persona lo vea. La especificación permanece en el repositorio, de modo que el siguiente lanzamiento comienza desde esta y no desde una sesión de edición en blanco.

Los datos del proyecto viven en docs/agents/whats-new-clip.md en el repositorio del usuario: dónde están las notas de la versión, cómo construir y sembrar la build del lanzamiento, cómo capturar esta superficie, el aspecto, los formatos, dónde se guardan los clips y quién aprueba. Si ese archivo falta, sigue primero SETUP.md.

La herramienta es scripts/clip.py. Ejecútala como uv run <carpeta de este skill>/scripts/clip.py <comando>; --help en cualquier comando muestra sus banderas. Necesita ffmpeg y ffprobe en PATH; uv trae Pillow. Sin uv, crea un entorno virtual fuera del repositorio (python3 -m venv <dir> && <dir>/bin/pip install pillow) y ejecuta la herramienta con <dir>/bin/python. El formato de la especificación y cada regla que check aplica están en SPEC.md.

1. Encontrar lo que la gente notará

Lee las notas del lanzamiento donde dice el archivo del proyecto. Enumera cada cambio que una persona verá, escuchará o sentirá, cada uno vinculado a su línea en las notas. Deja fuera las correcciones que nadie nota y el trabajo interno.

Si nada en la lista es algo que los usuarios notarán, pregunta al aprobador si este lanzamiento recibe un clip, y detente a menos que diga que sí.

Hecho cuando: cada elemento de la lista apunta a una línea en las notas del lanzamiento, o el aprobador ha dicho que no hay clip para este lanzamiento.

2. Acordar las palabras

Propón un título por cambio, en el orden en que se mostrarán, el más fuerte primero. Un cambio por escena. Un título es el beneficio de una persona en palabras sencillas, lo suficientemente corto para leerse dos veces mientras su escena se reproduce (unas seis palabras). Cuando el aprobador ya ha dado palabras para un cambio (en las notas, un mensaje, el "Qué hay de nuevo" dentro de la aplicación), úsalas textualmente: su ortografía, gramática y mayúsculas.

Pregunta al aprobador una sola vez, con la lista completa y tu recomendación para cada línea, de modo que una respuesta de una palabra funcione. No films nada antes de que las palabras estén acordadas: un título reformulado a menudo necesita una toma diferente.

Cuando el aprobador reformula un título que el producto también muestra (una hoja de "Qué hay de nuevo" dentro de la aplicación, notas de la tienda), pregunta si ese texto también cambia, para que el lanzamiento hable con una sola voz.

Hecho cuando: el aprobador ha aceptado cada título, y tú tienes cada uno exactamente como se acordó.

3. Escribir la especificación

Si la configuración ya escribió la especificación de esta versión, llena ese archivo. De lo contrario, comienza desde la especificación del último lanzamiento, para que el aspecto, la línea de apertura y la tarjeta final se mantengan:

clip.py init <versión> --out <carpeta de espec> --from <carpeta de espec>/<última versión>.json

Para un primer clip, usa --product "<nombre>" en lugar de --from. Llena el caption de cada escena (textualmente del paso 2), words_by (quién dio las palabras), y un in y out planificados lo suficientemente largos para leer su título. Un cambio sin nada que ver recibe la escena más corta que su título permita. Luego ejecuta clip.py check <spec> --words.

Hecho cuando: check --words imprime check: ok.

4. Filmar cada escena

Filma cada escena según las reglas en FILMING.md, con los comandos de construcción, siembra y captura del archivo del proyecto. Muestra solo lo que contiene este lanzamiento: nada detrás de un interruptor que se envía apagado, nada del siguiente lanzamiento.

Si la entrada real a través de la propia interfaz de usuario del producto no puede alcanzar un cambio, detente e informa al usuario: eso es un error, y un clip filmado alrededor de ello prometería lo que la gente no puede hacer.

Un cambio que la captura del proyecto no puede filmar en absoluto (una vista de cámara, un segundo dispositivo) se muestra a partir de una película guardada: consulta "Lo que la captura no puede filmar" en FILMING.md.

Coloca las películas en la carpeta de clips de este lanzamiento, fuera del repositorio. Establece el source, in y out de cada escena a partir del tiempo en que cada paso se registró mientras se ejecutaba, y mira antes de confiar en una marca:

clip.py peek <película> --from <segundo> --to <segundo> --out <una carpeta scratch nueva> --sheet <carpeta scratch>/peek.png

Muestra la película entre dos de sus segundos como render la leerá. Nunca extraigas esa imagen fija con una búsqueda propia: una grabación de pantalla solo mantiene un fotograma donde la imagen cambió, por lo que una búsqueda aterriza en el siguiente cambio, que puede estar segundos después.

Luego ejecuta clip.py check <spec> --media <carpeta de películas>.

Hecho cuando: check imprime check: ok con --media apuntando a las películas.

5. Renderizar

clip.py render <spec> --media <carpeta de películas> --out <carpeta de clips>/<producto, kebab-case>-<versión>-9x16.mp4

Renderiza cada formato adicional que el archivo del proyecto nombre con --size, como --size 1920x1080. Cuando render dice que una pantalla es demasiado pequeña para leerse en ese tamaño (una pantalla de teléfono en un marco ancho), ese formato necesita su propia especificación: consulta "Otro formato" en SPEC.md. El sonido es opcional y nunca lleva el mensaje: la mayoría de la gente mira con el sonido apagado, por lo que los títulos por sí solos deben contar la historia.

Hecho cuando: render imprimió Wrote ... para cada formato que el archivo del proyecto nombre.

6. Pase del revisor

Extrae imágenes fijas en una carpeta nueva: clip.py stills <clip> --spec <spec> --every 1 --safe --out <carpeta scratch> --sheet <carpeta scratch>/sheet.png. Escribe una imagen fija de la mitad de cada tarjeta y escena, una por segundo, y una hoja de todas ellas, con los bordes que cubre un feed teñidos. Examina cada una contra REVIEW.md, para cada formato.

Si tu entorno puede iniciar un subagente, dale este pase a uno iniciado con un contexto fresco, que contenga solo REVIEW.md, la especificación, las imágenes fijas y la hoja: ve lo que está en pantalla, no lo que pretendías filmar.

Corrige cada hallazgo como indica la tabla de REVIEW.md, luego renderiza y extrae las imágenes fijas de nuevo. Nunca expliques una imagen incorrecta en la transferencia.

Hecho cuando: cada imagen fija pasa cada elemento de REVIEW.md, y no hay ninguna corrección esperando.

7. Transferir

Envía al aprobador lo que REVIEW.md en "La transferencia" enumera, de la manera que dice el archivo del proyecto, y pide un OK o qué cambiar. El clip no se publica ni se adjunta a un lanzamiento hasta que ellos digan OK. La publicación la realiza quien nombre el archivo del proyecto.

En caso de No OK, toma sus cambios de vuelta al paso 2 (palabras) o paso 4 (imágenes), y filma de nuevo solo las escenas que cambian. Un No OK sin motivo: pregunta una vez qué no les gustó antes de cortar las mismas tomas de nuevo.

Hecho cuando: el aprobador ha dicho OK, o sus cambios están de vuelta en el paso 2 o 4.

8. Conservarlo para el próximo lanzamiento

La especificación permanece en el repositorio junto con los demás cambios del lanzamiento. Mantén las películas junto a los clips aprobados en la carpeta de clips. Añade cada lección que este clip enseñó como una línea bajo Lecciones en el archivo del proyecto.

Hecho cuando: la especificación está en el repositorio, las películas están junto a los clips aprobados, y cada nueva lección es una línea en docs/agents/whats-new-clip.md.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados