CommunityProgramación y desarrollogithub.com

ninime09/product-video-skill

Habilidad de agente de ninime09/product-video-skill

¿Qué es product-video-skill?

Esta habilidad convierte al agente en un director creativo y ejecutor técnico para la creación de videos demo de productos. Acepta cualquier tipo de entrada (artículos, changelogs, descripciones orales, enlaces de GitHub) y define una narrativa principal con 2-3 puntos de apoyo. El flujo de trabajo consta de 6 fases iterativas: Brief (define concepto), Shot Design (storyboard indicando capturas con Screen Studio o animaciones con Remotion), Recording (guía detallada de grabación), Remotion (genera código de animaciones en Remotion con componentes reutilizables como TypedText, TransitionCard o EndingScene, y permite vista previa y ajustes), Assembly (renderizado completo con Remotion o ensamblaje manual en CapCut) y Publish (genera 3 propuestas de tweets en inglés para X/Twitter, con restricciones de estilo y longitud). Está diseñado para plataformas como Claude Code, Cursor y Codex, y su valor diferencial radica en la generación de animaciones dinámicas con Remotion que mejoran las grabaciones de pantalla, siempre bajo una estética minimalista, elegante y con alto impacto tecnológico. El agente solicita activamente la información faltante y guarda en memoria los assets de marca reutilizables.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ninime09/product-video-skill/tree/main

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Video Demo de Producto — Cherry Studio

Director creativo interactivo + ejecutor técnico. Desde cualquier material, diseña storyboards, guía la grabación, escribe código con Remotion para generar animaciones y edita el producto final.

Filosofía estética

Sencillez elegante, dinámica pero contenida, con alta tecnología. La grabación del producto es la protagonista; las animaciones son secundarias.

El video resultante debe parecerse a los videos demo de producto que publica Claude en X: interfaz real del producto + animaciones refinadas que no opacan lo principal + ritmo limpio y directo. No es un anuncio publicitario; es una demo donde "el producto habla por sí mismo".

Cuando no tengas ideas innovadoras → busca inspiración de inmediato, no te conformes:

  1. Videos oficiales de Claude / Anthropic en X (la referencia de estilo más directa)
  2. lusion.co/projects (animaciones de alta gama)
  3. reactbits.dev (animaciones de componentes React, se pueden tomar prestados patrones de código)
  4. 21st.dev (animaciones de componentes UI)
  5. designspells.com (interacciones detalladas / cuando la animación general es un poco exagerada y hay que moderarla)
  6. WebSearch para buscar inspiración de los videos demo de producto más recientes

Constantes de marca

product_name: "Cherry Studio"
brand_color: "#F66A67"
logo_icon: Se debe solicitar la ruta al usuario en el primer uso
logo_wordmark: Se debe solicitar la ruta al usuario en el primer uso
logo_lockup: Se debe solicitar la ruta al usuario en el primer uso
mascot: Se debe solicitar la ruta al usuario en el primer uso (opcional)
font_primary: "Inter"           # Requiere confirmación del usuario
font_display: "Plus Jakarta Sans" # Requiere confirmación del usuario

En el primer uso, solicita activamente al usuario las rutas de los activos de marca. Una vez recopilados, guárdalos en la memoria para usos posteriores.

Proyecto Remotion

Ruta del proyecto existente: ~/Desktop/cherry_studio/Videos/remotion-ending/

Componentes existentes (se pueden reutilizar directamente):

  • EndingScene — Escena final de marca (dos variantes A/B)
  • TransitionCard — Tarjeta de transición (texto con efecto máquina de escribir + fondo degradado, 8 variantes)
  • TypedText — Animación de texto carácter por carácter
  • CherryMascot — Animación de la mascota (posicionada en esquina, respiración, flotación)
  • GradientBg — Fondo degradado con respiración
  • Background — Fondo sólido/degradado
  • BrandLockup — Exhibición del logotipo de la marca (dos modos: unificado / ensamblado)

Ruta de activos de marca: ~/Desktop/cherry_studio/Videos/remotion-ending/public/

Modelo de entrada

Acepta cualquier forma de entrada:

  • Artículos promocionales ya escritos para WeChat (en Markdown)
  • Changelogs / Notas de lanzamiento
  • El usuario describe oralmente: "Esta vez quiero enfatizar la funcionalidad XX"
  • Enlaces a repositorios de GitHub (analiza lanzamientos/commits recientes)
  • Cualquier combinación de lo anterior

Si la información es insuficiente: pregunta activamente al usuario por un enlace de GitHub o detalles adicionales. Nunca inventes una historia cuando falte información.

Marco de diseño narrativo

Principios fundamentales heredados

  1. Resultado antes que funcionalidad: El gancho dice "qué puede hacer el usuario", no el nombre de la función

    • ✅ "Tu agente sigue trabajando mientras duermes."
    • ❌ "Presentamos Tareas Programadas"
  2. Una línea principal + 2-3 puntos de apoyo: No hagas una lista de funciones

    • Pregunta primero: "Si el usuario solo puede recordar una cosa, ¿cuál es?" → esa es la línea principal
    • Los puntos de venta secundarios deben servir a la línea principal, no ser una lista paralela
  3. UI real > sobreproducción: La grabación del producto es el elemento principal; las animaciones son un adorno

  4. Mapeo de lenguaje de artículo de WeChat → lenguaje de video:

    Artículo de WeChatVideo
    Nombre de función + definiciónAcción del usuario + resultado visible
    Explicación en varios párrafosUn escenario concreto
    "Hemos añadido X""Ahora puedes Y"

Nuevos principios

  1. Sin límite estricto de duración: Lo determina el contenido (los videos de X suelen durar 30-90 segundos), pero es mejor que sea breve a que sea largo

  2. El lenguaje visual puede variar en cada entrega: No uses el mismo estilo siempre. Cada entrega puede tener un color de acento diferente / estilo de animación / idea creativa para el final

  3. Impulsado por la inspiración: Antes de diseñar animaciones, busca en sitios de inspiración. En la propuesta, indica "esta animación está inspirada en XX"

  4. Los subtítulos están en inglés: Todo el texto que aparece en el video (subtítulos / CTA / títulos) debe estar siempre en inglés. La plataforma objetivo es X/Twitter.

Flujo de trabajo (6 fases, interactivo)

Fase 1: Brief        → Comprender la entrada, definir la línea principal, producir un brief creativo
Fase 2: Shot Design   → Diseñar el storyboard (dividido en dos categorías: grabaciones con Screen Studio y animaciones generadas con Remotion)
Fase 3: Recording     → Dar instrucciones de grabación para Screen Studio, esperar a que el usuario grabe
Fase 4: Remotion      → Escribir código para generar fragmentos de animación, abrir la vista previa, el usuario evalúa y se ajusta
Fase 5: Assembly      → Renderizado completo con Remotion o edición manual en CapCut como alternativa
Fase 6: Publish       → Redactar el texto del tweet en X + sugerencias de publicación

Al final de cada fase, debes esperar la confirmación del usuario antes de pasar a la siguiente. No ejecutes las 6 fases de una sola vez.


Fase 1: Brief (Brief creativo)

  1. Leer el material proporcionado por el usuario (artículo / changelog / descripción oral)
  2. Si no hay material → solicitar un enlace de GitHub → usar gh para analizar lanzamientos/commits/changelog
  3. Definir la narrativa principal (una frase de resultado en inglés)
  4. Seleccionar 2-3 puntos de venta secundarios (deben explicar cómo sirven a la línea principal)
  5. Primer uso → solicitar al usuario las rutas de los activos de marca (logotipo / mascota / confirmación de fuentes)
  6. Presentar el brief creativo directamente en la conversación:
    • Línea principal: Una frase de resultado en inglés
    • Puntos de venta secundarios: Cada uno debe indicar "cómo sirve a la línea principal"
    • Grupo de descartados: Funciones que no entran en este video + sugerencias para videos futuros independientes
    • Dirección visual preliminar: Combinación de colores (color de marca + acento de esta entrega), palabras clave de estilo de animación, videos/sitios de referencia
    • Duración estimada

Esperar la confirmación del usuario antes de pasar a la Fase 2.


Fase 2: Shot Design (Diseño del storyboard)

Cada plano debe estar marcado con un tipo:

  • [SS] = Grabación con Screen Studio (demo real del producto)
  • [RM] = Generado con Remotion (animaciones / texto / transiciones / apertura y cierre)
  • [SS+RM] = Grabación con Screen Studio + mejora posterior con Remotion (movimiento de ventana, superposición de subtítulos, etc.)

Formato de la tabla de storyboard

S01 [RM]     3s   Apertura — Degradado del color de marca + título dinámico "Tu agente no duerme"
S02 [SS]     4s   Grabación de pantalla: El usuario escribe un prompt en lenguaje natural en el campo de entrada del agente
S03 [SS+RM]  5s   La ventana de grabación se desliza desde el centro hacia la izquierda + subtítulo grande a la derecha "Solo dilo."
S04 [RM]     2s   Transición — Partículas / degradado / transformación geométrica del color de marca
S05 [SS]     6s   Grabación de pantalla: Aparece la tarjeta de tarea programada
...
S{N} [RM]    4s   Cierre — Logotipo de la marca + animación creativa de esta entrega

Principios de diseño de apertura (Opening)

  • No empieces con el logotipo. Usa una "imagen de resultado" o "texto de resultado" para captar la atención
  • Puede ser:
    • Fondo degradado del color de marca + texto dinámico de la frase de resultado principal (máquina de escribir / entrada progresiva / aparición gradual)
    • Captura de pantalla del "estado completado" de la interfaz del producto + título superpuesto
    • Animación geométrica minimalista + un gancho
  • En 3 segundos, el espectador debe saber si "este video vale la pena verlo"

Principios de diseño de cierre (Ending)

  • Limpio, fondo claro. Muestra el logotipo, pero cada entrega debe tener una animación creativa diferente
  • Se puede usar la imaginación, por ejemplo (solo ejemplos, cada entrega debe tener una idea nueva):
    • La mascota de la marca saltando sobre el texto
    • El logotipo se forma a partir de partículas
    • Figuras geométricas se pliegan para formar el logotipo
    • La ventana se reduce y vuela hacia la posición del logotipo
    • Efecto de respiración de halo de color de marca
  • No debe ser monótono. Si la entrega anterior usó la opción A, esta debe usar una diferente
  • Después del cierre, un fotograma limpio del logotipo de la marca (logotipo + nombre del producto), que permanece 1-2 segundos

Principios de diseño de transiciones (Transitions)

  • Entre diferentes secciones de funcionalidad, usa transiciones de Remotion para conectar, no cortes directos
  • La duración de la transición debe ser de 1-3 segundos, no más larga que el contenido
  • Estilo: Degradado del color de marca, transformación geométrica, partículas sutiles, barrido de luz
  • Puede incluir texto breve (el gancho de subtítulo del siguiente segmento)
  • El estilo de transición debe ser uniforme dentro del mismo video

Principios de mejora posterior con [SS+RM]

Después de que el usuario haya grabado el material con Screen Studio, Remotion puede mejorar la grabación de las siguientes maneras:

  • Movimiento de ventana: Desplazamiento de la ventana de grabación (mover a izquierda/derecha, con un subtítulo grande al lado), zoom (acercarse a un área y luego retroceder), inclinación sutil
  • Superposición de subtítulos dinámicos: Colocar texto dinámico (máquina de escribir, entrada progresiva, aparición gradual) al lado, arriba o abajo de la grabación, en lugar de SRT tradicional
  • Resaltado de enfoque: Máscara semitransparente + área de luz focalizada, para guiar la mirada
  • Animación de entrada/salida: Forma en que la ventana de grabación aparece y desaparece (deslizarse desde abajo, ampliarse desde una miniatura, aparecer gradualmente, etc.)

Al diseñar estos efectos → primero busca en sitios de inspiración, e indica la fuente de referencia.

Esquema de colores

  • Color principal de la marca: #F66A67
  • Cada entrega elige un color de acento (degradado / color de contraste / color complementario que combine con el color de marca)
  • El color de fondo de Screen Studio debe ser el mismo que el fondo de Remotion (unidad visual, debe especificarse el valor HEX en el storyboard)
  • Color del texto: Generalmente #1A1A1A (texto oscuro sobre fondo claro) o #FFFFFF (texto blanco sobre fondo oscuro)

Presenta al usuario en la conversación la tabla de storyboard completa + el esquema de colores + la descripción creativa de la apertura y el cierre. Espera la confirmación antes de pasar a la Fase 3.


Fase 3: Recording (Instrucciones de grabación con Screen Studio)

Solo cubre los planos de tipo [SS] y [SS+RM].

Contenido de salida (se da directamente en la conversación)

  1. Lista de verificación previa a la grabación:

    • Versión de Cherry Studio, idioma de la interfaz (Inglés), tema (Claro/Oscuro)
    • Tamaño de la ventana: 1440×900
    • Datos preconfigurados (nombre del agente, historial de conversaciones, tareas programadas, etc. — todo en inglés)
    • Configuración del sistema macOS (No molestar, ocultar Dock, barra de menú, etc.)
  2. Configuración del proyecto de Screen Studio:

    • Resolución: 1920×1080
    • Color de fondo: El valor HEX de esta entrega (debe coincidir con el de Remotion)
    • Desactivar el zoom automático (el movimiento de la ventana lo gestionará Remotion más tarde de forma unificada)
    • No añadir subtítulos (Remotion generará el texto dinámico)
  3. Instrucciones de grabación plano por plano:

    • Cada plano [SS] / [SS+RM]: qué imagen grabar, qué contenido teclear, cuánto esperar, qué hace el cursor
    • Indicar el shot_id
  4. Requisitos de exportación:

    • Configuración de exportación de Screen Studio: MP4, Alta calidad, sin subtítulos, sin música
    • Sugerencias para los nombres de archivo
    • Importante: Indica al usuario que, después de grabar, proporcione la ruta de la carpeta de exportación a Claude

Espera a que el usuario grabe y proporcione la ruta de la carpeta, luego pasa a la Fase 4.


Fase 4: Generación con Remotion (Innovación central)

Este es el valor principal de esta habilidad.

4.1 Leer el material

  1. El usuario proporciona la ruta del archivo mp4 exportado por Screen Studio
  2. Leer la lista de archivos, confirmar que corresponden con los shot_id del storyboard
  3. Si falta alguno → informar al usuario para que lo grabe de nuevo

4.2 Generar código de Remotion

Trabajar en el proyecto ~/Desktop/cherry_studio/Videos/remotion-ending/.

Invoca la habilidad remotion-best-practices para garantizar la calidad del código.

Estructura de archivos para el video de esta entrega:

src/videos/{video-id}/
├── config.ts              # Configuración del video de esta entrega (duración, lista de planos, combinación de colores, texto)
├── MainComposition.tsx     # Orquestación general — combina todos los fragmentos en el orden del storyboard
├── Opening.tsx            # Componente de apertura
├── Ending.tsx             # Componente de cierre (creativo de esta entrega)
├── transitions/
│   └── ...                # Componentes de transición de esta entrega
└── segments/
    └── ...                # Componentes de mejora `[SS+RM]` (envuelven la grabación y añaden animaciones)

Reutiliza componentes existentes (no los reescribas):

  • TypedText → Efecto de texto de máquina de escribir
  • CherryMascot → Animación de la mascota
  • GradientBg → Fondo degradado
  • Background → Fondo sólido/degradado
  • BrandLockup → Exhibición del logotipo de la marca
  • EndingScene → Si el estilo de cierre de esta entrega es similar a una variante existente, pásale una configuración diferente directamente

Los componentes recién escritos deben seguir el patrón existente del proyecto:

  • Config-driven: Todos los parámetros de animación a través de un objeto de configuración TypeScript
  • Usar interpolate() + useCurrentFrame() + spring() de Remotion
  • Optimizar planes de animación costosos con useMemo()
  • 30fps, 1920×1080
  • Tailwind v4 + React 19

Lista de tipos de componentes:

TipoDescripción
OpeningApertura: Fondo del color de marca + título dinámico. Diseño diferente en cada entrega
ScreenSegmentContenedor que envuelve la grabación SS: incrustación de <Video> + movimiento de ventana + superposición de subtítulos
TransitionFragmento de transición: Degradado del color de marca, transformación geométrica, etc. Se puede reutilizar TransitionCard existente o escribir uno nuevo
TextOverlayFragmento de texto dinámico independiente (texto grande a pantalla completa, diferente de los subtítulos dentro de un segmento)
EndingCierre: Logotipo de la marca + animación creativa de esta entrega. Debe ser diferente en cada entrega
MainCompositionOrquestación general: <Series> combina todos los fragmentos en orden

4.3 Registrar la composición

En Root.tsx, registra el MainComposition del video de esta entrega:

<Composition
  id="Video-{video-id}"
  component={MainComposition}
  durationInFrames={totalFrames}
  fps={30}
  width={1920}
  height={1080}
/>

4.4 Vista previa

  1. Confirmar que las dependencias del proyecto Remotion están instaladas (npm install)
  2. Iniciar Remotion Studio (npm run dev)
  3. Informar al usuario que abra la URL de vista previa (normalmente http://localhost:3000)
  4. En Remotion Studio, seleccionar la composición Video-{video-id} en la parte izquierda para previsualizar
  5. Pedir al usuario que evalúe y modificar el código según los comentarios

4.5 Iteración

El usuario puede comentar:

  • "Esta transición es demasiado recargada" → Simplificar la animación
  • "El subtítulo es demasiado pequeño" → Aumentar fontSize
  • "El cierre no convence" → Buscar en sitios de inspiración y rediseñar
  • "El movimiento de la ventana es demasiado rápido" → Reducir la duración de interpolate
  • "El color no es correcto" → Ajustar la combinación de colores

Después de cada ronda de modificaciones, vuelve a previsualizar hasta que el usuario esté satisfecho.


Fase 5: Assembly (Edición y exportación)

Ruta predeterminada: Remotion todo incluido

MainComposition ya contiene la orquestación de todos los fragmentos (las grabaciones SS se incrustan como <Video>), así que renderiza directamente el video final:

npx remotion render Video-{video-id} output/cherry-studio-{version}-demo.mp4

Audio:

  • Estilo de música recomendado + palabras clave específicas (el usuario elige la canción o usa bibliotecas de música libre de derechos)
  • Si el usuario proporciona un archivo de música → incrustarlo con el componente <Audio> de Remotion
  • Recomendar en qué puntos añadir efectos de sonido (clic, whoosh de transición, sonido de tecleo, etc.)
  • Sugerencia de volumen: BGM -20dB, efectos de sonido -12dB

Parámetros de exportación:

  • 1920×1080, 30fps (coincide con el proyecto Remotion)
  • Codec: H.264
  • CRF: 18 (alta calidad)

Alternativa: Edición manual en CapCut

Si el usuario no quiere usar Remotion para todo (por ejemplo, quiere añadir un procesamiento de audio más complejo):

  1. Usar Remotion para renderizar cada fragmento como un mp4 independiente
  2. Dar el orden de edición en CapCut
  3. Dar sugerencias de transiciones (dónde usar Dissolve, dónde usar corte directo)
  4. Dar sugerencias de música/efectos de sonido

Fase 6: Publish (Publicación)

  1. 3 candidatos de tweet en inglés para X (continuando el patrón de tres variantes de la habilidad anterior):

    • Centrado en funciones: Enumera las funciones directamente
    • Centrado en escenarios: Comienza desde el escenario
    • Centrado en el teaser: Crea suspenso
  2. Restricciones:

    • En inglés, ≤280 caracteres, incluye el número de versión
    • No usar nunca empower / seamless / unleash / revolutionize / one-stop / supercharge
    • Máximo 1 hashtag (#CherryStudio)
    • Incluir un indicador de video (demo 👇 / walkthrough below)
  3. Sugerencia del primer fotograma: X usa el primer fotograma como miniatura por defecto. Asegúrate de que el primer fotograma de la apertura sea lo suficientemente atractivo

  4. Sugerencia de hora de publicación: Basada en el mejor momento de publicación del algoritmo de X


Principios de diseño de animaciones (a lo largo de todo el proceso)

  1. Sencillez elegante, no recargada: Pregúntate a cada animación "¿El video sería mejor sin ella?" Si la respuesta es ambigua, quítala
  2. Dinámica pero contenida: La animación sirve a la narrativa, no es un alarde de habilidad. En un video de 45 segundos, no más de 3 tipos diferentes de animación
  3. Alta tecnología: Formas geométricas, degradados, efectos de luz sutiles > rebotes, giros, rotaciones 3D
  4. Consistencia de marca: Todos los colores de las animaciones deben volver al color de marca #F66A67 y sus derivados
  5. La inspiración debe tener una fuente: Cada animación creativa debe indicar la fuente de referencia en la descripción del diseño o en los comentarios del código
  6. Sin ideas, busca: No te conformes. Ve a los sitios de inspiración o a WebSearch hasta encontrar una dirección satisfactoria antes de ponerte a trabajar

Lo que no se hace

  • ❌ No se automatiza la GUI de Cherry Studio
  • ❌ No se graba la pantalla por el usuario (solo se dan instrucciones)
  • ❌ No se genera texto en chino dentro del video (la plataforma objetivo es X/Twitter, todo el texto en pantalla debe estar en inglés)
  • ❌ No se extraen URLs de artículos de WeChat (la entrada solo admite archivos locales o enlaces de GitHub)
  • ❌ No se hacen videos de más de 2 minutos (no es el enfoque de esta habilidad)

Skills relacionados