Communitygithub.com

shotglass

Grave demos de aplicativos e navegadores no macOS com o ShotGlass. Use para solicitações como "filmar um demo", "gravar um passo a passo" ou "mostrar como usar este aplicativo" com o ShotGlass, e para editar ou exportar um projeto ShotGlass existente.

O que é shotglass?

O ShotGlass é uma skill para agentes de IA que permite gravar demos de aplicativos e navegadores no macOS, integrando-se a ferramentas MCP (Model Context Protocol). É particularmente útil para desenvolvedores e criadores que precisam automatizar a criação de tutoriais em vídeo, walkthroughs e demonstrações de software diretamente de um agente de IA. A skill suporta um fluxo de trabalho simplificado de duas chamadas: `recording_prepare` para configurar a gravação e obter o estado inicial, e `compose` para enviar uma sequência completa de ações (como cliques, teclas, texto) que o ShotGlass filma automaticamente. Além disso, oferece opções para renderização direta em vídeo, aplicação de estilos automáticos e edição de projetos existentes através de ferramentas do editor. A skill prioriza o uso de referências de estado para ações em segundo plano e requer atenção a permissões e alertas do sistema, preservando o projeto retornado em caso de interrupções.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/jakemanger/shotglass-skills/tree/main/skills/shotglass

Perguntar na sua IA favorita

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

Documentação

O que shotglass faz?

Filme através das ferramentas MCP conectadas do ShotGlass. Use os esquemas atuais do servidor instalado para nomes e parâmetros de ferramentas.

Comece aqui

Para um novo demo, use duas chamadas:

  1. recording_prepare({app:"Notes", allowSystemDisplayPrompt:true}) — substitua pelo aplicativo solicitado. Leia a captura de tela retornada, referências e snapshotId.
  2. compose({snapshotId, beats}) — envie a sequência completa de uma vez. O ShotGlass filma, restaura as janelas e abre o projeto em seu editor.

Construa os beats a partir do estado retornado: {ref:"<referência retornada>"}, {type:"text"}, {key:"cmd+s"}, ou {point:{x,y},action:"click"}. Substitua placeholders pelos valores reais retornados. Os pontos da captura de tela são screenshot.origin + coordenadas da imagem. Use navegação estável por teclado para diálogos e inclua expectedFiles quando a tarefa demonstrada salvar arquivos.

Entregue o que foi solicitado

  • Filmar um demo: deixe as opções de estilo e saída não definidas. Mantenha o enquadramento original e o cursor editável, depois abra o editor.
  • Filmar e renderizar: defina output:{mode:"video"} na mesma chamada compose. Informe o delivery.videoPath retornado.
  • Aplicar estilo automático ou zoom: defina naturalStyle:true apenas quando solicitado.
  • Editar uma gravação existente: inspecione o projeto pretendido com as ferramentas do editor e aplique as edições solicitadas. Renderize apenas quando solicitado.

Prefira referências para ações em segundo plano. Ações de coordenadas podem exigir entrada real. Defina allowRealInput:true apenas com autorização existente do usuário; caso contrário, deixe o ShotGlass solicitar aprovação. Reutilize uma única instância do ShotGlass e envie ações planejadas em conjunto, em vez de usar um loop de ação do host ou um gravador diferente.

Se bloqueado

Se as ferramentas estiverem faltando, leia a configuração. O aplicativo e o servidor MCP devem estar em execução no Mac que está sendo filmado.

Se permissões, um alerta ou cancelamento interromperem a gravação, preserve o projeto retornado e relate o bloqueador específico. Não tente novamente cegamente nem dispense um alerta que altere dados do usuário. O caminho de duas chamadas se aplica a um demo preparado e planejável, não a uma exigência de fingir que uma tomada falhou foi concluída.

Habilidades Relacionadas