Communitygithub.com

datassthou64-source/blue-motion-kit

Les deux lois qui régissent chaque graphique animé HyperFrames — (1) le visuel d'abord, le texte ensuite, et (2) chaque entité nommée dans la narration gagne un actif réel sourcé à l'écran. À utiliser lors de la création ou la révision de tout graphique animé, storyboard ou séquence à partir d'une narration, lorsque l'orateur nomme une entreprise, un produit, un outil, un site web ou un dépôt GitHub, lorsque vous décidez ce qui apparaît à l'écran pour une ligne, lorsqu'une séquence dérive vers des cartes de texte ou des listes à puces, ou lors du sourçage de logos, d'interfaces utilisateur de produits ou de captures de sites. S'applique à chaque workflow HyperFrames.

Qu'est-ce que blue-motion-kit ?

Ce skill encode les deux lois fondamentales de conception pour les graphiques animés HyperFrames, garantissant que chaque visuel communique efficacement sans recourir à un excès de texte. La première loi, « Le visuel d'abord, le texte ensuite », impose que le mouvement et la métaphore visuelle portent le sens principal ; le texte ne sert que de support, avec un maximum de 1 à 3 mots par objet majeur et pas de listes à puces ni de paragraphes. La seconde loi exige que chaque entité nommée en ligne (entreprise, produit, outil, site web, dépôt GitHub) soit représentée par un actif réel sourcé — logo, capture d'écran ou capture de site — plutôt que par du texte brut ou un graphique générique. Le skill fournit des méthodes automatisées pour sourcer ces actifs via un résolveur de logos et un outil de capture de site, avec des vérifications de provenance et de qualité. Il s'applique à toutes les étapes du workflow : sélection des sources, storyboard, construction et révision. Il s'intègre aux workflows HyperFrames, en s'appuyant sur les scripts fetch-logo.py et l'outil hyperframes capture, et travaille de pair avec un guide de style maison séparé (library/design.md) pour la mise en scène finale.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/datassthou64-source/blue-motion-kit/tree/HEAD/.claude/skills/motion-visual-sourcing

Demander à votre IA préférée

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

Documentation

Le visuel d'abord. Le texte ensuite. Chaque nom gagne un actif réel.

Deux lois. Elles s'appliquent à chaque séquence et à chaque workflow.


Loi 1 — Le visuel d'abord, le texte ensuite

Les gens ne lisent pas. Ils scannent. Un graphique animé est une image qui bouge, pas un diaporama avec animation dessus. Le mécanisme porte le sens ; les mots ne font que l'étiqueter.

Le test, appliqué à chaque séquence avant de la construire :

Supprimez chaque mot du cadre. L'idée passe-t-elle encore ? Si non, le visuel ne fait pas encore son travail — corrigez le visuel, n'ajoutez pas de mots.

Le texte est un élément de support. Il nomme ce que le spectateur regarde déjà. Il ne porte jamais une affirmation que l'image ne fait pas déjà.

À faire

  • Montrez le mécanisme en mouvement : route, transforme, remplit, compte, trie, converge, bifurque.
  • Utilisez de vrais logos, de vraies interfaces utilisateur, de vrais écrans comme preuve.
  • Une étiquette courte par objet majeur — 1 à 3 mots.
  • Un chiffre principal, uniquement lorsque la narration le prononce.

À ne pas faire

  • Coller la narration à l'écran. Les légendes font deux lignes maximum, jamais de paragraphes.
  • Construire une liste à puces, une carte d'ordre du jour ou un mur de cartes de texte. Une liste est une constellation ou un hub convergent, pas des puces empilées.
  • Utiliser une carte de texte parce que l'idée était difficile à visualiser. C'est le moment de travailler plus dur sur le visuel, pas d'abandonner et de taper.
  • Laisser une étiquette énoncer quelque chose que le mécanisme ne montre pas.

Rapport d'attention : budgettez environ 80 % de votre effort de construction sur l'objet en mouvement et 20 % sur le texte. Si vous avez fait l'inverse, la séquence est erronée.


Loi 2 — Chaque entité nommée gagne un actif réel sourcé

Lorsque la narration nomme quoi que ce soit qui existe en ligne — une entreprise, un produit, un outil, un site web, un dépôt GitHub, un modèle, un framework — allez chercher la chose réelle et mettez-la à l'écran.

Les entités nommées sont des preuves. Un spectateur qui entend « Clay » et voit la marque réelle de Clay vous croit. Un spectateur qui entend « Clay » et voit le mot « Clay » en Inter ne vous croit pas.

Ne dessinez jamais une boîte générique, n'inventez pas une marque, n'approchez pas un logo de mémoire, et ne laissez pas le nom en simple texte quand un actif réel existe.

Quoi sourcer, par ordre de valeur

Entité nomméeObtenez ceci
Une entreprise ou un outilSon vrai logo en couleur
Un produit avec une interface utilisateurUn véritable écran de cette interface, plus le logo
Un site webUne capture du site réel — npx hyperframes capture <url>
Un dépôt GitHubL'avatar/marque propre du dépôt, et le README ou la surface du dépôt
Un modèle / frameworkLa marque du fournisseur (Anthropic, OpenAI, …)
Une personneSeulement avec un actif fourni. Ne récupérez pas la photo de quelqu'un.

Comment sourcer

Vérifiez d'abord la bibliothèque figée. Les marques vérifiées se trouvent dans library/assets/logos/ (provenance dans son SOURCES.md). Ne récupérez jamais ce qui est déjà figé et vérifié.

Logos — utilisez le résolveur, ne chassez pas à la main :

cat > logos.txt <<'EOF'
clay      clay.com
anthropic wikipedia:Anthropic
linkedin  commons:LinkedIn icon
acme      https://acme.com/press/logo.svg
EOF
python3 KIT/.claude/skills/blue-motion/scripts/fetch-logo.py --manifest logos.txt <projet>/assets/logos

Échelle : URL explicite → Wikipedia → Wikimedia Commons → l'icône d'application du site → simple-icons → favicon. Préférez les quatre premières ; simple-icons est monochrome et la plupart des styles maison veulent de la couleur.

Sites et surfaces de produits — capturez la page réelle :

npx hyperframes capture https://<site> --json --max-screenshots 12

Les captures d'écran atterrissent localement sous forme de scènes en couches avec les actifs téléchargés. Traitez un code de sortie non nul, ok:false ou un BLOCKED.md comme un arrêt sec — n'inférez jamais le design d'une marque à partir d'une capture partielle.

Vérifiez avant de construire — toujours

  • Ouvrez chaque actif qui revient. Un mauvais logo est pire que pas de logo.
  • Le récupérateur émet un avertissement sous 6 Ko, et une recherche Commons peut renvoyer une quasi-erreur (mauvaise entreprise, ancienne marque, fan art). Regardez-le.
  • Préférez la marque actuelle. Les entreprises changent de nom ; Wikipedia est en retard.
  • Enregistrez la provenance. fetch-logo.py ajoute automatiquement à assets/logos/SOURCES.md — gardez-le.

Gardez-le local et légal

  • Copiez chaque actif dans le dossier assets/ du clip. Pas de CDN, pas de réseau au moment du rendu, jamais.
  • Les marques tierces sont utilisées de manière nominative — pour désigner la chose dont on parle. Ne restylez pas un logo, n'impliquez pas un aval, et n'utilisez pas une marque comme votre propre branding.
  • Si aucun actif réel ne peut être trouvé ou vérifié, dites-le et utilisez plutôt le visuel de la classe d'objet. N'inventez pas une marque pour combler le trou.

Où cela s'applique dans le workflow

  1. Sélection des sources — pour chaque fenêtre, enregistrez quelles entités la ligne nomme. Cette liste est le manifeste de récupération. Une fenêtre nommant une entité sans actif planifié est une sélection incomplète.
  2. Storyboard — chaque image énonce sa thèse visuelle et les actifs réels dont elle a besoin. Si la thèse d'une image n'est exprimable que par une phrase à l'écran, repensez l'image.
  3. Construction — les actifs vont dans assets/, référencés localement, vérifiés à l'œil.
  4. Révision — plissez les yeux sur l'instantané. Si vous ne pouvez dire ce que la séquence signifie qu'en la lisant, la Loi 1 est brisée. Si une marque nommée apparaît en simple texte, la Loi 2 est brisée.

Le style maison prime toujours

Ces lois régissent ce qui va à l'écran. Comment cela se présente est dans library/design.md : sourcez l'actif réel, puis mettez-le en scène dans le style maison (sur un plateau, sous la vignette en bassin profond, à l'intérieur d'une carte en verre).

Individual skills in this repo

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

Skills associés