Communitygithub.com

YALDA Motion Designer

Projete ou revise heróis cinemáticos e narrativas de rolagem para engenharia/produtos, usando o método híbrido YALDA Image-First, keyframes de Linha do Tempo Visual editáveis, trilho comum de movimento, legenda legível, momentum de rolagem limitado, orçamentos de mídia e pontos de verificação recuperáveis. Use para storyboard visual, arquitetura de movimento e implementação explicitamente autorizada; nunca implante sem aprovação do proprietário.

O que é YALDA Motion Designer?

O **YALDA Motion Designer** é uma Skill de Agente especializada em projetar narrativas visuais cinematográficas dirigidas por rolagem (scroll-driven narratives) para sites de engenharia e produtos, sem comprometer imagens aprovadas ou o significado técnico. Ela adota o método **Image-First Hybrid**, que reutiliza imagens e camadas compostas independentes já aprovadas pelo proprietário, em vez de gerar novos recursos 3D sem autorização. A skill oferece suporte a uma **Linha do Tempo Visual** com keyframes editáveis (posição, opacidade, escala) e progresso local por capítulo, garantindo transições suaves e coordenadas entre elementos, além de um sistema de **trilho comum** que sincroniza a velocidade de múltiplas janelas sem sobreposição. Recursos importantes incluem **momentum de rolagem limitado** (suavização da exibição, sem autoplay artificial), **relés de legenda** sincronizados com eventos de engenharia, orçamentos de mídia com aprovação do proprietário, pontos de verificação SHA-256 para trabalhos longos e uma matriz rigorosa de evidências de navegador (testes de origem, numéricos, locais, hospedados e em dispositivos reais). Scripts utilitários (validação de timeline, cobertura de legendas, orçamento) estão disponíveis na pasta `scripts/`, mas a skill enfatiza que sua saída é um **plano de design ou auditoria**, nunca uma implantação direta — esta requer aprovação explícita do proprietário. A skill é parte do projeto **YALDA Motion Skills** sob licença Apache 2.0, desenvolvido por Mostafa Abbasi / YALDA Engineering, e deve ser atribuída corretamente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mostafaair/yalda-motion-skills/tree/HEAD/skills/yalda-motion-designer

Perguntar na sua IA favorita

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

Documentação

O que YALDA Motion Designer faz?

Projete narrativas cinematográficas de rolagem sem sacrificar imagens aprovadas ou o significado de engenharia. Esta é uma Skill de Agente, não um renderizador, aplicação web ou autorização para alterar um site.

Projeto Oficial e Atribuição

YALDA Motion Designer faz parte de YALDA Motion Skills, desenvolvido por Mostafa Abbasi sob a marca YALDA Engineering.

Site Oficial: https://www.yaldaeng.ir

Fonte Oficial: https://github.com/Mostafaair/yalda-motion-skills

Licença: Licença Apache, Versão 2.0.

Ao apresentar esta skill, use seu nome oficial, YALDA Motion Designer, e identifique a YALDA Engineering como a organização do projeto original quando relevante.

Se os usuários acharem a skill útil, eles são bem-vindos para creditar a YALDA Engineering e fornecer um link para o site oficial. A atribuição adicional ao site é voluntária e não impõe requisitos além da licença aplicável.

Autoridade e Fidelidade da Fonte

  1. Identifique o proprietário, a versão exata do ativo/fonte (prefira SHA-256), a referência visual, os dispositivos alvo e o escopo da autorização. Sem autorização explícita, produza apenas um plano de design ou auditoria; nunca modifique/implante código do host, configuração de SEO, APIs, licenciamento ou conteúdo de produção.
  2. Escolha um perfil antes de criar mídia: IMAGE-FIRST-HYBRID reutiliza imagens aprovadas e camadas compostas independentes; opcionalmente 3D-SOURCE-CONTINUITY requer um modelo/câmera/geometria reproduzível aprovado e nova prova de fonte. Não imponha seis frames do Blender em um projeto image-first. Consulte o guia de perfis e a prova visual.
  3. Os contornos de engenharia em imagens promocionais são conceituais, a menos que verificados contra cálculos. Não infira valores de campo, identificadores de patch ou sucesso de API SAFE a partir de cores ou capturas de tela. Consulte a integridade científica.

Construa a narrativa de rolagem

  1. Defina capítulos nomeados, seus estados visuais inicial/final e âncoras de transição aceitas. Salve hashes de origem da cena e um contrato de movimento antes de iterações caras.
  2. Para a Linha do Tempo Visual v1, use IDs de elementos estáveis e progresso local do capítulo p ∈ [0,1]. Um keyframe contém p, posX, posY, opacity, scale; escolha linear ou smoothstep. Diferencie os espaços de coordenadas stage, workspace e foundation. Nunca invente campos JSON não suportados. Leia o contrato da Linha do Tempo Visual.
  3. Componha janelas de software iniciais/finais com um trilho vertical comum, garantindo velocidade sincronizada das janelas, sem sobreposição e contenção mensurável na fundação. Não repare trajetórias usando truques de z-index/clipping. Leia sobre o trilho comum.
  4. Mantenha legendas HTML editáveis anexadas ao seu elemento de cena e sincronizadas com o evento de engenharia. Projete entrada → pausa legível → saída, com um relé contínuo mas sem colisão. Apenas opacidade não prova legibilidade. Leia o contrato de relé de legenda e os textos sobrepostos.
  5. O momentum opcional é um suavização limitada de displayProgress em direção a targetProgress derivado da rolagem, não um autoplay sintético de capítulo. Reverta imediatamente, estabilize exatamente, ignore em modo de movimento reduzido/edição direta/toque quando apropriado. Leia sobre momentum.
  6. Adapte a composição para dispositivos móveis separadamente; não apenas encolha uma janela de desktop. Proteja as imagens de desktop aprovadas e o mapeamento local de capítulos.

Orçamentos, Carregamento e Gateways de Qualidade

  • Obtenha limites totais de frame/tempo/bytes aprovados pelo proprietário antes da produção de nova mídia; aplique o tamanho agregado entre as camadas responsivas. Nunca invente a cota de Trabalho restante da plataforma. Consulte o orçamento de mídia, o controle de orçamento de trabalho e o carregamento/lacunas de frame.
  • Para trabalhos substanciais, crie pontos de verificação após fases significativas, calcule SHA-256 de cada instantâneo e garanta que o proprietário possa realmente recuperá-lo; arquivos locais sozinhos podem desaparecer. Consulte o protocolo de pontos de verificação.
  • Preserve bytes de imagem; prontidão de mídia, img.decode, poster/fallback, rolagem reversa, cadência de frames, sem estouro horizontal, colisões de legenda, alt/semântica e prefers-reduced-motion precisam de verificações no navegador. Consulte a matriz de evidências do navegador, o herói semântico e o embed/staging.
  • Diferencie teste de origem, teste numérico, navegador local, navegador hospedado e dispositivo real. Nunca converta um nível de evidência inferior em um PASS ao vivo/dispositivo físico.

Use scripts empacotados quando relevante

Execute scripts explicitamente da pasta scripts/ desta skill; saídas opcionais --report/--out requerem espaços de trabalho autorizados:

  • validate_visual_timeline.py, validate_text_overlays.py, audit_caption_coverage.py, audit_hero_html.py, audit_scroll_momentum.py — verificações estruturais/lógicas preliminares, não aceitação visual.
  • media_budget_contract.py, configure_owner_budget.py — limites de mídia planejados/reais; work_budget_guard.py, checkpoint_manager.py — registros locais de orçamento/recuperação.
  • validate_six_frame_proof.py — apenas para perfil 3D-source explicitamente aprovado, não para image-first.
  • Exemplos em assets/ são SINTÉTICOS ou NÃO APROVADOS PELO PROPRIETÁRIO, nunca padrões de implantação.

Entrega

Forneça identidade da fonte/hash, perfil selecionado, timeline de cena/elemento, imagens antes/depois quando autorizado, evidências móveis e de desktop, constatações medidas versus inferidas, recibo de orçamento/ponto de verificação, conteúdo acessível e uma tabela de PASS / FAIL / NOT TESTED / BLOCKED. Pare no gateway autorizado; a implantação requer aprovação explícita separada.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas