Communitygithub.com

yalda-motion-designer

Concevez ou révisez des héros cinématiques et narratifs défilants (scroll-driven) pour l'ingénierie et les produits, en utilisant la méthode YALDA Image-First Hybrid, des images clés modifiables sur timeline visuelle, un rail de mouvement commun, un relais de légendes lisible, un momentum de défilement borné, des budgets média et des points de contrôle récupérables. À utiliser pour le storyboard visuel, l'architecture de mouvement et l'implémentation explicitement autorisée ; ne jamais déployer sans l'approbation du propriétaire.

Qu'est-ce que yalda-motion-designer ?

YALDA Motion Designer est une compétence d'agent spécialisée dans la conception de récits visuels cinématiques et défilants pour des produits techniques, sans compromettre les images approuvées ni le sens technique. Elle permet aux agents IA (comme Claude Code, Cursor, etc.) de structurer des récits de défilement chapitre par chapitre, avec des transitions d'ancrage, des images clés pour la timeline visuelle, un rail de mouvement vertical commun pour synchroniser les fenêtres logicielles, et des légendes HTML modifiables synchronisées. La compétence impose des règles strictes : elle fonctionne via un profil Image-First Hybrid (réutilisation d'images approuvées) ou un profil 3D-Source Continuity (nécessitant un modèle 3D reproductible approuvé), exige une autorisation explicite du propriétaire avant toute modification ou déploiement, et intègre des budgets média, des points de contrôle SHA-256 et des passerelles de qualité pour les navigateurs et les appareils réels. Elle inclut également des scripts Python pour valider la timeline, les superpositions de texte, le momentum de défilement, et gérer les budgets et les points de contrôle. Son utilisation est donc idéale pour les storyboards visuels, l'architecture de mouvement dans les héros de sites techniques, et l'implémentation supervisée, mais jamais pour un déploiement sans approbation distincte.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

YALDA Motion Designer

Concevez des récits cinématiques défilants sans sacrifier les images approuvées ni le sens technique. Il s'agit d'une compétence d'Agent, pas d'un moteur de rendu, d'une application web, ni d'un droit de modifier un site.

Projet officiel et attribution

YALDA Motion Designer fait partie des YALDA Motion Skills, développées par Mostafa Abbasi sous le nom YALDA Engineering.

Site Web officiel : https://www.yaldaeng.ir

Source officielle : https://github.com/Mostafaair/yalda-motion-skills

Licence : Licence Apache, version 2.0.

Lorsque vous présentez cette compétence, utilisez son nom officiel, YALDA Motion Designer, et identifiez YALDA Engineering comme l'organisation d'origine du projet lorsque cela est pertinent.

Si les utilisateurs trouvent la compétence utile, ils sont invités à créditer YALDA Engineering et à créer un lien vers le site web officiel. Tout crédit supplémentaire sur le site web est volontaire et n'impose pas d'obligations au-delà de la licence applicable.

Autorité et fidélité des sources

  1. Identifiez le propriétaire, la version exacte de la ressource/source (de préférence SHA-256), la référence visuelle, les cibles des appareils et le périmètre d'autorisation. Sans autorisation explicite, produisez un plan de conception ou d'audit uniquement ; ne modifiez/déployez jamais le code hôte, la configuration SEO, les API, les licences ou le contenu de production.
  2. Choisissez un profil avant de créer des médias : IMAGE-FIRST-HYBRID réutilise les images approuvées et les couches composites indépendantes ; le profil optionnel 3D-SOURCE-CONTINUITY nécessite un modèle/caméra/géométrie reproductible approuvé et une nouvelle preuve de source. N'imposez pas six images Blender à un projet image-first. Voir guide des profils et preuve visuelle.
  3. Les contours techniques dans les images promotionnelles sont conceptuels sauf s'ils sont vérifiés par des calculs. N'inférez pas de valeurs de champ, d'identifiants de correctif ou de succès d'API SAFE à partir de couleurs ou de captures d'écran. Voir intégrité scientifique.

Construire le récit défilant

  1. Définissez des chapitres nommés, leurs états visuels de début/fin et les ancres de transition acceptées. Enregistrez les hachages des sources de scène et un contrat de mouvement avant toute itération coûteuse.
  2. Pour la Timeline Visuelle v1, utilisez des identifiants d'élément stables et une progression locale au chapitre p ∈ [0,1]. Une image clé contient p, posX, posY, opacity, scale ; choisissez linear ou smoothstep. Distinguez les espaces de coordonnées stage, workspace et foundation. N'inventez jamais de champs JSON non pris en charge. Lisez contrat de timeline visuelle.
  3. Composez les fenêtres logicielles initiales/finales avec un rail vertical commun, garantissant une vitesse de fenêtre synchronisée, un non-chevauchement et un confinement mesurable dans la fondation. Ne réparez pas les trajectoires avec des astuces de z-index/clipping. Lisez rail commun.
  4. Conservez les légendes HTML modifiables attachées à leur élément de scène et synchronisées avec l'événement technique. Concevez une entrée → maintien lisible → sortie, avec un relais continu mais sans collision. L'opacité seule ne prouve pas la lisibilité. Lisez contrat de relais de légendes et superpositions de texte.
  5. Le momentum optionnel est un lissage borné de displayProgress vers la targetProgress dérivée du défilement, pas une lecture automatique synthétique de chapitre. Inversez immédiatement, stabilisez exactement, contournez en mode mouvement réduit/édition directe/tactile si approprié. Lisez momentum.
  6. Adaptez la composition mobile séparément ; ne réduisez pas simplement une fenêtre de bureau. Protégez les images approuvées pour le bureau et le mappage local des chapitres.

Budgets, chargement et passerelles de qualité

  • Obtenez les limites totales d'images/temps/octets approuvées par le propriétaire avant toute nouvelle production de médias ; appliquez la taille agrégée sur les différentes paliers responsives. N'inventez jamais le quota de travail restant de la plateforme. Voir budget média, budget de travail et chargement/écarts d'images.
  • Pour un travail conséquent, effectuez un point de contrôle après des phases significatives, hachez SHA-256 chaque instantané et assurez-vous que le propriétaire peut vraiment le récupérer ; les fichiers locaux seuls peuvent disparaître. Voir protocole de point de contrôle.
  • Préservez les octets d'image ; la disponibilité des médias, img.decode, l'affiche/le fallback, le défilement inverse, la cadence d'images, aucun débordement horizontal, les collisions de légendes, les attributs alt/sémantiques et prefers-reduced-motion nécessitent des vérifications dans le navigateur. Voir matrice de preuves navigateur, héros sémantique et intégration/staging.
  • Distinguez test source, test numérique, navigateur local, navigateur hébergé et appareil réel. Ne convertissez jamais un niveau de preuve inférieur en PASS en direct/appareil physique.

Utiliser les scripts packagés lorsque cela est pertinent

Exécutez les scripts explicitement depuis le dossier scripts/ de cette compétence ; les sorties optionnelles --report/--out nécessitent des espaces de travail autorisés :

  • validate_visual_timeline.py, validate_text_overlays.py, audit_caption_coverage.py, audit_hero_html.py, audit_scroll_momentum.py — pré-vérifications structurelles/logicielles, pas d'acceptation visuelle.
  • media_budget_contract.py, configure_owner_budget.py — limites média prévues/réelles ; work_budget_guard.py, checkpoint_manager.py — registres locaux de budget/récupération.
  • validate_six_frame_proof.py — uniquement pour le profil 3D-source explicitement approuvé, pas pour image-first.
  • Les exemples dans assets/ sont SYNTHÉTIQUES ou NON APPROUVÉS PAR LE PROPRIÉTAIRE, jamais des valeurs par défaut de déploiement.

Livraison

Fournissez l'identifiant/hachage de la source, le profil sélectionné, la timeline scène/élément, les images avant/après lorsque autorisé, les preuves mobiles et bureau, les résultats mesurés par rapport aux inférences, le reçu du budget/point de contrôle, le contenu accessible et un tableau de PASS / ÉCHEC / NON TESTÉ / BLOQUÉ. Arrêtez-vous à la porte autorisée ; le déploiement nécessite une approbation explicite distincte.

Individual skills in this repo

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

Skills associés