Communitygithub.com

ASoudy/AGS – Generación Automatizada de Demos en Video

Úsalo cuando el usuario solicite crear un video demo, un recorrido de producto, una demostración de funciones, una presentación animada, un video de marketing o un GIF a partir de capturas de pantalla o descripciones de escenas. Orquesta los MCP de Playwright, ffmpeg y edge-tts para producir contenido de video pulido.

¿Qué es AGS – Generación Automatizada de Demos en Video?

Este skill, ASoudy/AGS, permite a un agente de IA actuar como un productor de video profesional, transformando descripciones textuales o capturas de pantalla en demos de producto pulidas y compartibles. Su función principal es orquestar tres herramientas MCP —Playwright para renderizar y capturar pantallas de escenas HTML, edge-tts para generar locuciones narradas, y ffmpeg para componer el video final con transiciones—. Cuando estas herramientas no están disponibles, el skill genera todos los archivos intermedios y comandos manuales para que el usuario los ejecute. La utilidad clave radica en su enfoque narrativo: no solo automatiza la producción técnica, sino que guía al agente para elegir una estructura de historia (clásica, problema-solución o teaser), diseñar escenas con un único foco visual y escribir locuciones concisas sin jerga. El resultado es un conjunto de artefactos: HTML por escena, archivos de texto para locución, un manifiesto JSON y un script bash que ejecuta el pipeline completo. Está diseñado para plataformas como Claude Code, Cursor, Codex y otros agentes que integren MCPs, y su principal valor es eliminar el trabajo repetitivo de edición de video, asegurando consistencia visual, ritmo dramático y una experiencia de producto profesional.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/nginity-skills-library/engineering/demo-video/skills/demo-video

Preguntar en tu IA favorita

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

Documentación

Video de Demostración

Eres un productor de video. No un creador de presentaciones. Cada fotograma tiene un trabajo. Cada segundo se gana el siguiente.

Descripción General

Crea videos de demostración pulidos orquestando renderizado del navegador, texto a voz y composición de video. Piensa como un productor de video: arco narrativo, ritmo, emoción, jerarquía visual. Convierte capturas de pantalla y descripciones de escenas en demos de producto compartibles.

Cuándo Usar Este Skill

  • El usuario solicita crear un video demo, un recorrido de producto o una demostración de funciones
  • El usuario quiere una presentación animada, un video de marketing o un avance de producto
  • El usuario quiere convertir capturas de pantalla o capturas de interfaz en un video pulido o un GIF
  • El usuario dice "haz un video", "crea una demo", "graba una demo", "video promocional"

Flujo de Trabajo Principal

1. Elegir un modo de renderizado

Antes de comenzar, verificar las herramientas disponibles:

  • ¿MCP de playwright disponible? — necesario para capturas de pantalla automatizadas. Alternativa: pedir al usuario que tome las capturas manualmente de los archivos HTML.
  • ¿edge-tts disponible? — necesario para audio de narración. Alternativa: generar archivos de texto de narración para que el usuario los grabe o use cualquier herramienta TTS.
  • ¿ffmpeg disponible? — necesario para la composición. Alternativa: generar archivos de imagen de cada escena + archivos de audio con comandos manuales de ffmpeg que el usuario pueda ejecutar.

Si ninguna está disponible, producir archivos HTML de escena + manifiesto scenes.json + guiones de narración. El usuario puede componer manualmente o usar cualquier editor de video.

ModoCómoCuándo
Orquestación MCPHTML → capturas de playwright → audio de edge-tts → composición con ffmpegUsar cuando los MCPs de playwright + edge-tts + ffmpeg estén todos conectados
ManualEscribir archivos HTML de escena, proporcionar comandos de ffmpeg para que el usuario los ejecuteUsar cuando los MCPs no estén disponibles

2. Elegir una estructura narrativa

La demo clásica (30-60 s): Gancho (3 s) -> Problema (5 s) -> Momento mágico (5 s) -> Prueba (15 s) -> Prueba social (4 s) -> Invitación (4 s)

Problema-Solución (20-40 s): Antes (6 s) -> Después (6 s) -> Cómo (10 s) -> Llamada a la acción (4 s)

El avance de 15 segundos: Gancho (2 s) -> Demo (8 s) -> Logotipo (3 s) -> Eslogan (2 s)

3. Diseñar escenas

Si no se proporcionan capturas de pantalla:

  • Para herramientas CLI/terminal: generar escenas HTML con fondo oscuro estilo terminal, fuente monoespaciada y efecto de escritura animada
  • Para demos conceptuales: usar escenas con mucho texto, aplicando el lenguaje cromático y el sistema tipográfico
  • Preguntar al usuario por capturas de pantalla solo si el producto es visual y las descripciones son insuficientes

Cada escena tiene EXACTAMENTE un enfoque principal:

  • Escenas de título: nombre del producto
  • Escenas de problema: el dolor (rojo, caótico)
  • Escenas de solución: el resultado (verde, espacioso)
  • Escenas de función: la región de la captura resaltada
  • Escenas finales: URL / botón de llamada a la acción

4. Escribir la narración

  • Una idea por escena. Si necesitas "y", necesitas dos escenas.
  • Empieza con el verbo. "Organiza tus pestañas" no "La organización de pestañas se proporciona."
  • Sin jerga. "Tus pestañas se organizan solas" no "Categorización de pestañas impulsada por IA."
  • Usa contraste. "24 pestañas. Un clic. 5 grupos."

Artefactos de Salida

Para cada video, producir estos archivos en un directorio demo-output/:

  1. scenes/ — un archivo HTML por escena (viewport de 1920x1080)
  2. narration/ — un archivo .txt por escena (para entrada de edge-tts)
  3. scenes.json — manifiesto que lista las escenas en orden con duraciones y texto de narración
  4. build.sh — script de shell que ejecuta el pipeline completo:
    • playwright screenshot de cada escena HTML → frames/
    • edge-tts de cada archivo de narración → audio/
    • ffmpeg concatenar con transiciones de fundido cruzado → output.mp4

Si los MCPs no están disponibles, aun así producir los elementos 1-3. Incluir los comandos de ffmpeg en build.sh para que el usuario los ejecute manualmente.

Sistema de Diseño de Escenas

Ver references/scene-design-system.md para el sistema de diseño completo: lenguaje cromático, temporización de animaciones, tipografía, diseño HTML, opciones de voz y guía de ritmo.

Lista de Verificación de Calidad

  • El video tiene flujo de audio
  • La resolución es 1920x1080
  • No hay fotogramas negros entre escenas
  • Los primeros 3 segundos captan la atención
  • Cada escena tiene un punto de enfoque
  • La tarjeta final tiene URL y llamada a la acción

Antipatrones

AntipatrónCorrección
Ritmo de presentación — cada escena misma duración, sin ritmoVariar duraciones: ganchos 3 s, prueba 8 s, CTA 4 s
Muro de texto en pantallaMover información a la narración, simplificar las imágenes
Narración genérica — "Esta función te permite..."Usar números específicos y verbos concretos
Sin arco narrativo — solo enumerar funcionesUsar estructura problema -> solución -> prueba
Capturas de pantalla en brutoAgregar siempre esquinas redondeadas, sombras, fondo oscuro
Usar animaciones ease o linearUsar curva de resorte: cubic-bezier(0.16, 1, 0.3, 1)

Referencias Cruzadas

  • Relacionado: engineering/browser-automation — para flujos de trabajo de navegador basados en playwright
  • Ver también: framecraft — pipeline de renderizado de escenas de código abierto

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados