Communitygithub.com

pragma-sh/pragma

Utilisez pour éditer, prévisualiser, valider ou restituer le film de lancement de Pragma basé sur Remotion pour le README.

Qu'est-ce que pragma ?

Cette compétence gère la maintenance et la reproductibilité du film de lancement de Pragma dans le README du dépôt, en utilisant le framework Remotion. Elle définit l'ensemble du pipeline de production vidéo : conception des compositions (PragmaLaunch, 1920×1080, 30 ips), gestion des timelines, rendu des artefacts, et vérification de cohérence. Le workflow est conçu pour les développeurs travaillant sur des projets Remotion, offrant des commandes Bun dédiées (studio, typecheck, render) afin de garantir que les modifications de scènes, de timing ou d'assets restent synchronisées. La compétence prend en charge le rendu local, le rendu dans GitHub Actions, et inclut même la génération déterministe de la bande-son. Elle empêche les divergences en reliant les durées des compositions aux durées des scènes, et en exigeant des vérifications de formatage avant validation. Idéale pour quiconque édite le film de lancement de Pragma ou maintient sa reproductibilité pixel-perfect.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pragma-sh/pragma/tree/HEAD/skills/launch-video

Demander à votre IA préférée

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

Documentation

Maintenir le film de lancement Pragma

Assurez-vous que le film de lancement du README reste reproductible à partir des sources et des actifs appartenant au dépôt.

Structure du projet

  • launch-video/index.ts enregistre la racine de Remotion.
  • launch-video/Root.tsx définit la composition PragmaLaunch en 1920×1080 et 30 ips.
  • launch-video/PragmaLaunch.tsx gère la timeline, les durées des scènes et la présentation.
  • remotion.config.ts utilise apps/www/public comme répertoire public de Remotion. Résolvez les clips, l'audio et les marqueurs d'agent avec staticFile() depuis ce répertoire ; ne dupliquez pas les actifs sous launch-video.
  • .github/assets/pragma-launch.mp4 est l'artefact rendu du README.

Les fichiers .tsx porteurs de composants utilisent le PascalCase. Gardez l'ID de composition PragmaLaunch aligné avec la commande de rendu racine, et dérivez la durée totale de la composition à partir des durées des scènes afin que les modifications de la timeline ne laissent pas le registre obsolète.

Flux de travail

Exécutez les commandes depuis la racine du dépôt :

bun run video:studio
bun run video:typecheck
bun run video:render

Utilisez Studio pour examiner l'ensemble de la timeline après avoir modifié les scènes, le timing, la typographie ou les actifs. Exécutez le typecheck ciblé avant le rendu. La commande de rendu écrit le film README suivi dans .github/assets/pragma-launch.mp4 en utilisant les paramètres de codec et de qualité dans remotion.config.ts.

La bande-son est générée de manière déterministe par launch-video/generate-lofi.ts. Lorsque vous modifiez ce générateur, exécutez bun run video:music ; il remplace apps/www/public/media/pragma-lofi.wav. Ne régénérez pas la bande-son pour des modifications vidéo non liées.

Les enregistrements de produits se trouvent dans apps/www/public/media. Lorsque vous remplacez un enregistrement, vérifiez sa lecture complète dans Studio et mettez à jour la durée de scène correspondante dans PragmaLaunch.tsx pour qu'elle ne soit ni écourtée ni suivie d'une queue figée. Terminez en exécutant les vérifications de format et de qualité habituelles du dépôt pour chaque fichier source modifié.

Skills associés