Communitygithub.com

Criação de Gráficos em Movimento (ChatCut)

Use esta skill quando o Codex utilizar o plugin ChatCut (servidor MCP chatcut) para adicionar, criar, editar manualmente, corrigir ou posicionar ativos JSX de Motion Graphics. Abrange navegação por referências, criação direta de JSX inline, propriedades editáveis, vinculação de ativos, posicionamento na linha do tempo e verificação composta.

O que é Criação de Gráficos em Movimento (ChatCut)?

Esta skill capacita o agente Codex a criar e editar Motion Graphics (MGs) diretamente como JSX inline, utilizando o servidor MCP `chatcut`, sem depender de fluxos nativos como o `motion-graphic-gen` do próprio ChatCut. Ela é projetada para o editor Web do ChatCut, incluindo URLs de desenvolvimento local, e não deve ser usada com o ChatCut Desktop para projetos Web. A skill enfatiza uma abordagem orientada por referências: o agente deve primeiro navegar pelo catálogo visual (`browse_library`) para confirmar um estilo e encontrar instâncias adequadas antes de codificar. Após a seleção, a skill fornece orientações detalhadas sobre a aplicação do Design Style, interpretação de referências de instância e composição visual. Para a implementação real, o agente usa ferramentas como `create_motion_graphic_from_code` para novos ativos ou `edit_asset` para patches, sempre passando o código JSX diretamente na chamada da ferramenta, sem etapas de arquivos intermediários. A skill também cobre princípios fundamentais como expor propriedades editáveis, garantir compatibilidade de fontes com o renderizador do ChatCut, planejar a ordem das camadas e verificar o estado do projeto antes de codificar.

Funciona com~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/ChatCut-Inc/agent-plugin/tree/HEAD/claude/skills/create-motion-graphics

Perguntar na sua IA favorita

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

Documentação

Criar Gráficos em Movimento

Host do plugin e projeto

Use o servidor MCP chatcut e o ID do projeto a partir da URL do editor do usuário ou do resultado do projeto do plugin. Este plugin funciona com o editor Web, incluindo URLs de desenvolvimento local. Não abra o ChatCut Desktop nem use chatcut_desktop para um projeto Web. Se as ferramentas chatcut não estiverem disponíveis, reporte a falha de conexão; não envie a tarefa para o Agente nativo do editor como substituto.

Encontre referências de MG antes de projetar

Navegue e confirme uma direção visual

Para produção, reutilize um estilo de projeto aceito ou marca/referência fornecida pelo usuário. Use manage_design_style get quando sua especificação completa não for conhecida. Edições rotineiras de texto/posicionamento não precisam de nova seleção de estilo ou reescaneamento do catálogo.

Quando uma nova direção for necessária ou o usuário pedir para navegar por alternativas, comece com browse_library references: {view: "style-overview"}. Leia TODAS as folhas de contato numeradas, seguindo nextOffset até complete. Elas contêm representantes de estilo habilitados para agente e publicados, incluindo Design Styles vinculados existentes. list_presets é apenas o subconjunto do catálogo legado; não pode substituir esta visão geral visual. Tente novamente uma página com falha; reporte uma visão geral incompleta em vez de pulá-la silenciosamente.

Para vídeo guiado por fala, entenda o conteúdo falado e inspecione quadros de vídeo representativos antes de selecionar estilos. Reutilize evidências de transcrição e quadro já no contexto. Considere o tópico, tom de entrega, idioma na tela e a cor, enquadramento do assunto e fundo da filmagem junto com as prévias de estilo.

Quando a direção visual ainda não estiver acordada, selecione até 6 opções distintas adequadas para o conteúdo e filmagem atuais, e leia suas partes hero. Carregue a skill widget-forms do host e mostre imagens reais heroPreview.url com nomes curtos. Imagens retornadas pela ferramenta são evidências para o agente, não um seletor voltado para o usuário; escolhas apenas textuais não mostram as diferenças visuais. Mantenha cada escolha mapeada para seu ID de referência; use o ramo "Outro" do formulário para preferências ou outro lote sem repetir escolhas ou adicionar uma opção separada "Mostrar mais". Aguarde a seleção antes de aplicar um novo estilo e produzir o MG, a menos que o usuário já tenha escolhido uma direção ou delegado explicitamente a escolha do estilo. Uma resposta "Outro" não é aceitação.

Aplique o estilo selecionado

Leia o summary, hero e members do representante selecionado. Siga seu designStyleAction com manage_design_style:

  • apply_preset: use o presetId retornado diretamente; não clone ou atualize o preset meramente para salvar metadados de referência.
  • apply: reutilize o designStyleId retornado para um estilo de usuário salvo existente.
  • create: apenas uma referência independente precisa de um novo estilo de propriedade do usuário. Defina e salve sua paleta, fontes e regras visuais reutilizáveis a partir da referência selecionada. Reutilize a paleta documentada da referência; se ausente, derive uma paleta coerente de sua imagem representativa. Salve designSpec.referenceSources: [{id: "<ID da referência>"}] e o heroPreview.url individual em AMBOS thumbnailUrl e designSpec.images: [{role: "style reference", url: "<heroPreview.url>"}]. Use applyToProject: true; preserve imagens existentes ao corrigir um array.

Após aplicar, chame get para a especificação completa atualizada e IDs de origem; não carregue regras em cache do estilo anterior. Para um novo estilo, verifique se sua paleta, fontes, origem, capa e imagem de referência foram salvos. Apenas um ID de origem não salva uma imagem. Imagens de referência são evidências visuais, não filmagens/fundos para incorporar ou texto de exemplo para reproduzir.

Use fontRecommendations["zh-Hans"] / .en de acordo com o texto real na tela, incluindo texto bilíngue e números latinos. Reutilize um plano de fontes aceito; um grupo de idioma vazio não está resolvido. Combine o caráter tipográfico e a hierarquia de título/corpo da referência, e verifique a cobertura de glifos e disponibilidade em tempo de execução. Salve famílias/papéis selecionados em designSpec.fonts, e idioma, peso, itálico e eixos necessários em styleGuide. Um exemplo de formulário entre estilos não pode substituir este plano. Apenas ao selecionar fontes ausentes ou adaptar tipografia explicitamente, leia Font matching; a correspondência chinesa começa a partir de uma imagem de efeito chinesa gerada, não de letras inglesas.

Corresponda instâncias às formas de MG necessárias

Use o conteúdo falado e os quadros alvo para decidir quais formas de MG são úteis; deixe as prévias de referência refinar essas escolhas. Mantenha a linguagem visual confirmada em todo o vídeo e encontre instâncias adequadas para cada forma necessária. Escolha as instâncias você mesmo, a menos que o usuário peça para compará-las. Formas diferentes podem usar instâncias diferentes; componentes recorrentes podem reutilizar uma já inspecionada. Siga nextReferenceSearch quando retornado:

  • Com membros relacionados, navegue por kind: "instance", styleId: "<UUID do representante>" ou leia IDs de membros relevantes.
  • Se uma forma necessária não tiver um membro adequado, pesquise TODA a biblioteca de instâncias por consulta de conteúdo/forma query ou facets.form, omitindo styleId, facets.style e termos de nome de estilo, mesmo que outras formas já tenham correspondências do mesmo estilo.
  • Compare a colagem de capa, então leia IDs selecionados com parts: ["summary", "hero"]. Adicione motion para animação e code para implementação. Se uma referência com código retornar templateInspection, use sua chamada somente leitura para esquema/padrões de propriedade salvos; JSX pode ler props sem declarar seus valores. legacyTemplateRefs são IDs de modelo: manage_template get lê metadados, e list_assets lê propriedades de MG. Nenhum deles aplica ou copia um modelo. inspect_asset é para mídia/MGs do projeto atual, não IDs de origem do catálogo.

Adapte a composição, hierarquia, espaçamento e estrutura de revelação da instância às fontes fixas do projeto, paleta, materiais e tomada real. Se a busca mais ampla de formas também não tiver adequação, estenda o quadro de estilo e declare essa limitação. Realize leituras de detalhes relevantes em lote; encontrar uma instância não cobre formas não relacionadas. Siga pendingIds para respostas divididas; known pode incluir apenas versões retornadas e partes ainda em contexto. Cada folha de movimento é UM design em timestamps reais; uma montagem não é um layout, e uma imagem estática não estabelece animação.

Para uma nova sobreposição de cabeça falante/substancialmente redesenhada, leia Overlay composition. Importe apenas arquivos de produção de materials que aparecerão no resultado; use seus IDs de ativo do projeto. Revise o MG composto com a filmagem alvo.

Use as referências ao criar

Leia o code da instância selecionada ao emprestar sua implementação, ou leia propriedades de modelo vinculadas com manage_template list_assets. Use-a como referência no fluxo de trabalho de código abaixo, preservando o estilo do projeto.

Inspecione também imagens selecionadas: uma URL, ID ou resultado de busca por si só não é uma referência visualizada. Mantenha evidências de ESTILO para aparência e evidências de FORMA entre estilos para estrutura. Se uma referência selecionada falhar, tente novamente ou reporte a evidência faltante em vez de alegar que foi inspecionada.

Use esta skill quando uma tarefa do plugin ChatCut exigir um ativo de Motion Graphic criado ou corrigido como JSX inline. O Agente ChatCut embutido tem seu próprio fluxo de trabalho motion-graphic-gen; não mude para ele a partir desta tarefa de plugin.

Motion Graphics do plugin Codex são criados diretamente. Use create_motion_graphic_from_code para novos ativos JSX e edit_asset para JSX MG existentes. Esta superfície não fornece submit_motion_graphic; não traduza a solicitação em um prompt Gemini ou resumo de geração. Se as ferramentas de criação direta estiverem faltando, pare e reporte as ferramentas indisponíveis do plugin ChatCut.

Passe o código fonte do Motion Graphic inline através das ferramentas MCP chatcut. Não armazene código no repositório ChatCut, ai-working/, /tmp, um servidor HTTP local, arquivos de código gerados ou caminhos de aplicativo adivinhados quando a ferramenta aceita JSX inline diretamente.

Princípios Fundamentais

  • Inspecione o estado do projeto quando o tamanho da tela, fps, linguagem visual existente, posicionamento ou conflitos de linha do tempo não forem conhecidos.
  • Identifique as entradas necessárias em Antes de Codificar antes de criar o JSX.
  • Crie ou atualize ativos de Motion Graphics através do fluxo de trabalho de ativos de código inline disponível; use esquemas atuais de ferramentas para formas exatas de payload.
  • Posicione ou mova ativos através do fluxo de trabalho de edição de linha do tempo quando a edição exigir posicionamento na linha do tempo.
  • Releia o estado do projeto e verifique o quadro visível após mudanças estruturais ou visuais.

Antes de Codificar

Antes de escrever JSX, identifique apenas as informações necessárias para esta edição:

  • Posicionamento: hora de início, duração, camada alvo se conhecida, e o quadro alvo com o qual o gráfico deve compor.
  • Papel na edição: qual trabalho este Motion Graphic performa no vídeo.
  • Conteúdo: texto, números, mídia ou fatos visuais exatos que devem aparecer.
  • Tempo: se o movimento interno deve sincronizar com fala, música ou um evento visual.
  • Fonte visual: estilo fornecido pelo usuário, Design Style do projeto, cores/fontes da marca ou um Motion Graphic aceito existente.
  • Campos editáveis: quais valores de texto, cores, números, booleanos, imagem ou vídeo devem se tornar propriedades.

Pergunte apenas por entradas faltantes e de alto impacto que alterariam materialmente o resultado.

Sistema visual e posicionamento

Use o Design Style completo confirmado e as referências inspecionadas acima. Para uma nova direção personalizada, estabeleça um resultado composto antes de fazer em lote; direções aceitas e correções rotineiras não precisam de renovação de estilo.

Escolha cada composição, posição, tamanho e tempo de leitura a partir da tomada real e do trecho de fala. Mantenha tipografia, paleta, materiais e movimento compartilhados, adaptando a forma da referência ao conteúdo. Uma âncora fixa esquerda/direita ou contêiner de cartão é apropriado apenas quando a composição o exige.

Reutilize um ativo com propriedades por item para um componente recorrente intencional com a mesma estrutura de informação. Novas estruturas precisam de sua própria referência de instância e composição. Os limites da sobreposição devem conter o gráfico de forma justa; use dimensões da linha do tempo apenas para um design que visivelmente abrange o quadro.

Corresponda a duração do ativo e batidas internas ao trecho de linha do tempo colocado. Se o tempo mudar materialmente, atualize o MG em vez de truncar animação inacabada. Revise quadros compostos estabelecidos lado a lado para um lote, corrigindo colisões, legibilidade e repetição não intencional antes de relatar conclusão.

Propriedades Editáveis

Exponha valores visíveis ao usuário e propensos a mudança como propriedades editáveis.

  • Texto visível, cores primárias, cores de destaque e valores numéricos chave devem ser propriedades.
  • Escolhas de fontes devem ser propriedades font quando os usuários podem razoavelmente alterá-las.
  • Fontes de imagem e vídeo devem ser propriedades image / video.
  • As chaves de código devem corresponder exatamente às chaves do esquema de propriedade.
  • Leia valores de item.props; não codifique conteúdo visível que o usuário possa razoavelmente querer alterar depois.
  • Use sobrescritas de propriedade em nível de item apenas para componentes recorrentes intencionais com a mesma tarefa do visualizador, estrutura de informação e forma visual. Se qualquer um desses diferir, crie outro ativo MG e compartilhe lógica de paleta, tipo e movimento.

As entradas de propriedade devem declarar uma chave estável, rótulo visível ao usuário, tipo e valor padrão. Tipos de propriedade suportados incluem texto, número, cor, booleano, seleção, fonte, imagem e vídeo.

Fontes

Motion Graphics devem usar fontes disponíveis no renderizador do ChatCut para que a prévia e a exportação local permaneçam consistentes. Não confie em fontes de sistema específicas da máquina como STKaiti, PingFang SC, Microsoft YaHei, Arial, Helvetica, Comic Sans MS, system-ui, -apple-system ou famílias CSS genéricas como a fonte primária renderizada; a disponibilidade difere entre máquinas e pode causar fallback.

Ao escolher ou substituir uma fonte, chame search_fonts e use o nome de família canônico retornado textualmente como o valor fontFamily e o defaultValue da propriedade font correspondente. Use Google Fonts ou fontes personalizadas do projeto retornadas pelo catálogo. Se uma fonte específica da máquina solicitada não estiver no catálogo, explique que a renderização local consistente não pode ser garantida, pesquise por uma alternativa suportada com sensação semelhante e use-a a menos que o usuário aceite explicitamente o fallback de fonte.

Ativos e composição

Uma instância de referência pode descrever uma composição completa feita de vários itens de linha do tempo. Não implica um ativo MG autocontido. Mantenha capturas de tela de referência, materiais de produção e filmagem do projeto atual distintos.

Padrão para itens separados quando o design combina mídia comum com gráficos:

  • Papel/textura/fundo reutilizável: um item de imagem ou vídeo atrás da composição.
  • Foto atual do projeto, imagem de produto ou filmagem: seu próprio item de mídia. O agente seleciona/substitui, corta, posiciona e aplica efeitos suportados a ele; não se espera que o usuário monte as camadas manualmente.
  • Tipografia, formas e decoração animada: item(ns) MG transparente(s). Separe a decoração de fundo do texto em primeiro plano quando a mídia deve ficar entre eles.

Planeje a ordem das camadas, retângulo de mídia alvo, início/duração e tempo de entrada antes de criar. Declare no escopo do código/brief do MG quais camadas já existem fora do MG, para que a foto ou papel da referência não seja gerado novamente. Aplique preto-e-branco/cor/granulado ao item de mídia pretendido em vez de afetar acidentalmente o texto em primeiro plano. Verifique o suporte a efeitos na superfície real de reprodução/exportação; dividir camadas não prova por si só paridade Web/Desktop.

  1. Reutilize ativos de browse_assets no projeto atual. Importe apenas arquivos de produção necessários na saída para Meus Ativos. Carregue asset-import e use seu helper de sessão/upload import_media. Registrar mídia do projeto não a publica na biblioteca de recursos pública.
  2. Posicione mídia normal de produção através de edit_item, usando os IDs de ativos do projeto atual retornados. O agente lida com a substituição de pessoas de exemplo, cópia, e dados com o conteúdo da tarefa atual. Não use a conclusão da referência.

Individual skills in this repo

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

Habilidades Relacionadas