Communitygithub.com

CambridgeMonorail/WallRun

Construisez et éditez des vidéos de démonstration Remotion pour WallRun dans le répertoire demos du monorepo Nx.

Qu'est-ce que WallRun ?

Cette compétence permet de créer et maintenir des vidéos de démonstration Remotion pour WallRun, situées dans le répertoire `demos/wallrun-video` d'un monorepo Nx. Elle offre une structure claire pour la création de scènes, la composition, les composants de mouvement réutilisables et le rythme vidéo. Destinée aux développeurs frontend, elle assume une connaissance de React, TypeScript et de l'architecture des composants. La vidéo adopte un ton éditorial minimal et moderne, privilégiant la lisibilité et la clarté. Les animations sont simples et déterministes (fondu, glissement, dévoilement progressif), évitant les effets de spectacle. Cette compétence guide l'utilisateur dans la conception de scènes (4 à 8 secondes, une idée par scène), le respect de conventions de codage (composants React fonctionnels, TypeScript, exports nommés, types explicites) et l'utilisation des cibles Nx pour la prévisualisation (`nx preview wallrun-video`), le rendu (`nx render wallrun-video`) et la vérification de type (`nx type-check wallrun-video`). Chaque scène est considérée comme terminée lorsque son message est immédiatement clair, la typographie lisible à l'échelle vidéo, l'animation sobre, les minutages faciles à modifier et le code proprement structuré.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CambridgeMonorail/WallRun/tree/HEAD/skills/remotion-demo-video

Demander à votre IA préférée

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

Documentation

Compétence Vidéo de Démonstration Remotion

Cette compétence aide à construire et maintenir la vidéo de démonstration Remotion située dans :

demos/wallrun-video

Elle fournit une structure pour :

  • la création de scènes
  • la structure de composition
  • les composants de mouvement réutilisables
  • le rythme vidéo
  • les explications destinées aux développeurs

Cette compétence doit être utilisée lorsque vous travaillez sur :

  • des compositions Remotion
  • des composants de scène
  • des segments d'explication animés
  • la structure ou le séquencement vidéo
  • les primitives de mouvement utilisées par la démo

Contexte du projet

Ce dépôt est un monorepo Nx.

La vidéo Remotion se trouve dans :

demos/wallrun-video

Le projet rend une vidéo explicative destinée aux développeurs pour WallRun.

Le public est constitué de développeurs frontend, pas de spécialistes du marketing.

On suppose que le spectateur comprend :

  • React
  • TypeScript
  • l'architecture des composants
  • les systèmes de mise en page
  • les outils pour développeurs

Évitez d'expliquer les concepts JavaScript de base.


Intention de conception

La vidéo doit ressembler à un contenu pour développeurs, pas à une publicité produit.

Bon ton :

  • éditorial
  • minimal
  • moderne
  • confiant
  • mouvement retenu

Mauvais ton :

  • promotion SaaS générique
  • effets de bande-annonce cinématographique
  • animations lourdes de particules
  • texte marketing dense

Priorisez :

  • la lisibilité
  • la hiérarchie
  • le rythme
  • la clarté

Structure du projet

Tout le code doit se trouver dans :

demos/wallrun-video/src

Structure :

  • components/ — Primitives de présentation réutilisables
  • scenes/ — Sections chronométrées de la vidéo
  • data/ — Script, texte, constantes de tempo
  • Root.tsx — Enregistre les compositions
  • index.ts — Fichier d'entrée pour la CLI Remotion

Règles de conception des scènes

Chaque scène doit communiquer une seule idée.

Durée typique : 4 à 8 secondes

Les scènes doivent :

  • se lire rapidement
  • avoir une typographie large
  • éviter l'encombrement
  • garder le mouvement subtil

Types de scènes préférés :

  • cartes-titres
  • captures d'écran de dépôt scénarisées
  • gros plans de composants
  • superpositions d'encadrés
  • diagrammes d'architecture
  • panneaux de statistiques

Évitez :

  • les petites interfaces utilisateur
  • les longs paragraphes
  • les transitions trop compliquées

Directives d'animation

Préférez une animation simple et déterministe.

Exemples :

  • fondu
  • glissement vers le haut
  • dévoilement progressif
  • échelle subtile

Évitez :

  • les effets de rebond
  • le mouvement physique complexe
  • les courbes d'assouplissement lourdes

Le but est la clarté, pas le spectacle.


Conventions de codage

Utilisez :

  • des composants fonctionnels React
  • TypeScript
  • des exports nommés
  • des types explicites
  • des wrappers de mouvement réutilisables

Évitez :

  • le code d'animation dupliqué
  • les nombres magiques
  • le cadrage temporel des scènes codé en dur

Extrayez les constantes de tempo lorsque c'est pratique.

Exemple :

const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;

Workflow par défaut pour créer une nouvelle scène

  1. Définissez le message de la scène
  2. Définissez la durée en images
  3. Bloquez la mise en page
  4. Ajoutez le mouvement principal
  5. Ajoutez le mouvement secondaire uniquement s'il améliore la clarté
  6. Vérifiez la lisibilité
  7. Assurez-vous que le code est réutilisable

Cibles Nx

  • preview — nx preview wallrun-video ouvre Remotion Studio
  • render — nx render wallrun-video rend la vidéo complète dans dist/demos/wallrun-video/
  • type-check — nx type-check wallrun-video exécute le compilateur TypeScript

Définition de terminé

Une scène est terminée lorsque :

  • le message est immédiatement clair
  • la typographie se lit à l'échelle vidéo
  • l'animation est sobre
  • les minutages sont faciles à modifier
  • le code est structuré proprement

Skills associés