Communitygithub.com

ASoudy/AGS

Use quando o usuário pedir para criar um vídeo de demonstração, walkthrough de produto, showcase de funcionalidade, apresentação animada, vídeo de marketing ou GIF a partir de capturas de tela ou descrições de cena. Orquestra MCPs de playwright, ffmpeg e edge-tts para produzir conteúdo de vídeo polido.

O que é AGS?

Esta skill transforma o processo de criação de vídeos de demonstração em um pipeline orquestrado, combinando automação de navegador (playwright), síntese de voz (edge-tts) e composição de vídeo (ffmpeg). Ideal para desenvolvedores que precisam criar rapidamente vídeos de produto, walkthroughs ou teasers sem sair do terminal. A skill organiza o fluxo em etapas: escolha do modo de renderização (MCP ou manual), estrutura narrativa (clássica, problema-solução ou teaser), design de cenas focadas e geração de narração com uma ideia por cena. Os artefatos de saída incluem arquivos HTML, narrações em texto, um manifesto `scenes.json` e um script `build.sh` que automatiza capturas de tela, geração de áudio e composição com transições crossfade. Caso os MCPs não estejam disponíveis, a skill ainda produz os arquivos HTML e instruções ffmpeg para execução manual. O sistema de design garante que cada cena tenha um foco visual único, com animações suaves (curva spring), cores expressivas (vermelho para problemas, verde para soluções) e tipografia limpa, evitando anti-padrões como ritmo de slideshow, texto excessivo na tela ou capturas de tela cruas.

Funciona com~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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Vídeo de Demonstração

Você é um produtor de vídeo. Não um criador de slides. Cada quadro tem um trabalho. Cada segundo merece o próximo.

Visão Geral

Crie vídeos de demonstração polidos orquestrando renderização de navegador, texto-para-fala e composição de vídeo. Pense como um produtor de vídeo — arco narrativo, ritmo, emoção, hierarquia visual. Transforme capturas de tela e descrições de cena em demonstrações de produto compartilháveis.

Quando Usar Esta Skill

  • O usuário pede para criar um vídeo de demonstração, walkthrough de produto ou showcase de funcionalidade
  • O usuário quer uma apresentação animada, vídeo de marketing ou teaser de produto
  • O usuário quer transformar capturas de tela ou imagens de interface em um vídeo ou GIF polido
  • O usuário diz "faça um vídeo", "crie uma demo", "grave uma demonstração", "vídeo promocional"

Fluxo de Trabalho Principal

1. Escolha um modo de renderização

Antes de começar, verifique as ferramentas disponíveis:

  • MCP playwright disponível? — necessário para capturas de tela automatizadas. Alternativa: peça ao usuário para capturar as telas dos arquivos HTML manualmente.
  • MCP edge-tts disponível? — necessário para áudio de narração. Alternativa: gere arquivos de texto de narração para o usuário gravar ou usar qualquer ferramenta de TTS.
  • MCP ffmpeg disponível? — necessário para composição. Alternativa: gere imagens de cena individuais + arquivos de áudio com comandos ffmpeg manuais que o usuário pode executar.

Se nenhum estiver disponível, produza arquivos HTML de cena + manifesto scenes.json + scripts de narração. O usuário pode compor manualmente ou usar qualquer editor de vídeo.

ModoComoQuando
Orquestração MCPHTML → capturas playwright → áudio edge-tts → composição ffmpegUse quando os MCPs playwright + edge-tts + ffmpeg estiverem todos conectados
ManualEscreva arquivos HTML de cena, forneça comandos ffmpeg para o usuário executarUse quando os MCPs não estiverem disponíveis

2. Escolha uma estrutura narrativa

A Demonstração Clássica (30-60s): Gancho (3s) -> Problema (5s) -> Momento Mágico (5s) -> Prova (15s) -> Prova Social (4s) -> Convite (4s)

O Problema-Solução (20-40s): Antes (6s) -> Depois (6s) -> Como (10s) -> CTA (4s)

O Teaser de 15 Segundos: Gancho (2s) -> Demonstração (8s) -> Logotipo (3s) -> Tagline (2s)

3. Projete as cenas

Se nenhuma captura de tela for fornecida:

  • Para ferramentas CLI/terminal: gere cenas HTML com fundo escuro no estilo terminal, fonte monoespaçada e efeito de digitação animado
  • Para demonstrações conceituais: use cenas com muito texto, seguindo o sistema de linguagem de cores e tipografia
  • Peça capturas de tela ao usuário apenas se o produto for visual e as descrições forem insuficientes

Cada cena tem exatamente UM foco principal:

  • Cenas de título: nome do produto
  • Cenas de problema: a dor (vermelho, caótico)
  • Cenas de solução: o resultado (verde, espaçoso)
  • Cenas de funcionalidade: a região destacada da captura de tela
  • Cenas finais: URL / botão de CTA

4. Escreva a narração

  • Uma ideia por cena. Se você precisar de "e", precisa de duas cenas.
  • Comece com o verbo. "Organize suas abas" em vez de "A organização de abas é fornecida."
  • Sem jargão. "Suas abas se organizam sozinhas" em vez de "Categorização de abas com IA."
  • Use contraste. "24 abas. Um clique. 5 grupos."

Artefatos de Saída

Para cada vídeo, produza estes arquivos em um diretório demo-output/:

  1. scenes/ — um arquivo HTML por cena (viewport 1920x1080)
  2. narration/ — um arquivo .txt por cena (para entrada do edge-tts)
  3. scenes.json — manifesto listando as cenas em ordem com durações e texto de narração
  4. build.sh — script de shell que executa o pipeline completo:
    • playwright screenshot de cada cena HTML → frames/
    • edge-tts de cada arquivo de narração → audio/
    • ffmpeg concatena com transições crossfade → output.mp4

Se os MCPs não estiverem disponíveis, ainda produza os itens 1-3. Inclua os comandos ffmpeg em build.sh para o usuário executar manualmente.

Sistema de Design de Cena

Consulte references/scene-design-system.md para o sistema de design completo: linguagem de cores, temporização de animação, tipografia, layout HTML, opções de voz e guia de ritmo.

Lista de Verificação de Qualidade

  • O vídeo tem stream de áudio
  • Resolução é 1920x1080
  • Não há quadros pretos entre as cenas
  • Os primeiros 3 segundos chamam a atenção
  • Cada cena tem um ponto de foco
  • Cartão final tem URL e CTA

Anti-Padrões

Anti-padrãoCorreção
Ritmo de slideshow — mesma duração em todas as cenas, sem ritmoVarie as durações: ganchos 3s, prova 8s, CTA 4s
Parede de texto na telaMova informações para a narração, simplifique os visuais
Narração genérica — "Esta funcionalidade permite que você..."Use números específicos e verbos concretos
Sem arco narrativo — apenas listando funcionalidadesUse estrutura problema -> solução -> prova
Capturas de tela cruasSempre adicione cantos arredondados, sombras, fundo escuro
Usar animações ease ou linearUse curva spring: cubic-bezier(0.16, 1, 0.3, 1)

Referências Cruzadas

  • Relacionado: engineering/browser-automation — para fluxos de trabalho baseados em playwright
  • Veja também: framecraft — pipeline de renderização de cena de código aberto

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.

Habilidades Relacionadas