Communitygithub.com

BintzGavin/helios-skills

Workflow guidé de bout en bout pour créer une vidéo promotionnelle dynamique. Extrait l'identité de marque du dépôt, génère une musique synchronisée au rythme et produit une composition motion.dev haute énergie via Helios CLI. À utiliser pour réaliser des vidéos promotionnelles ou bandes-annonces alignées sur la marque.

Qu'est-ce que helios-skills ?

Cette compétence fournit un pipeline complet et structuré pour créer des vidéos promotionnelles dynamiques et alignées sur l'identité de marque, en s'appuyant sur Helios, ElevenLabs, ffmpeg et la bibliothèque motion.dev. Elle commence par recueillir le contexte auprès de l'utilisateur (dépôt ou URL de la marque), puis extrait les signaux de marque (palette, typographie, ton, etc.) et produit une spécification créative détaillée. Si l'utilisateur le souhaite, elle génère une musique instrumentale originale via ElevenLabs, analyse son tempo et ses battements avec ffmpeg, puis synchronise chaque animation sur la grille temporelle des battements. La composition finale est implémentée en HTML/CSS/motion.dev dans un fichier `composition.html`, exposée au runtime Helios via `helios.bindToDocumentTimeline()`, et rendue en vidéo MP4 via `npx @helios-project/cli render`. La compétence impose des règles strictes (pas de hasard, timing déterministe, respect des règles de conception motion lues depuis `skills/guided/motion-design-rules`) et est idéale pour les développeurs et créateurs souhaitant produire rapidement des vidéos promotionnelles professionnelles avec un fort impact visuel et sonore.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/promo-video

Demander à votre IA préférée

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

Documentation

Vous pouvez être en train de travailler dans le dépôt de la marque, ou à partir d'un contexte externe.

Ne devinez pas l'identité de la marque. Soit analysez la base de code, soit recherchez l'URL fournie.


PIPELINE D'EXÉCUTION

ÉTAPE 1 — Recueillir le contexte

⛔ STOP. Posez ces deux questions à l'utilisateur :

  1. « Sommes-nous dans le dépôt de votre marque, ou souhaitez-vous fournir une URL (par exemple votre site marketing) pour que je puisse étudier votre marque en ligne ? »

  2. « Souhaitez-vous générer une musique de fond ? Si oui, vous aurez besoin d'une variable d'environnement ELEVEN_LABS_API_KEY. Vous pouvez en obtenir une sur https://elevenlabs.io → Profil → Clés API. »

Attendez que l'utilisateur réponde aux deux questions.

N'essayez pas de lire les fichiers .env ou de vérifier les clés vous-même. Faites confiance aux réponses de l'utilisateur.

Si l'utilisateur fournit une URL, utilisez-la pour l'étude de la marque à l'ÉTAPE 3 au lieu d'analyser la base de code. Si l'utilisateur refuse la musique, sautez les ÉTAPES 4 et 5.


ÉTAPE 2 — Vérifier les dépendances d'exécution Helios

Installer les paquets requis :

npm install @helios-project/core @helios-project/renderer @helios-project/cli

Vous effectuerez le rendu en mode DOM.


ÉTAPE 3 — Extraire les informations de marque du dépôt

Si l'utilisateur a fourni une URL au lieu d'un dépôt, récupérez cette URL et extrayez les mêmes signaux de marque depuis le site en ligne. Ignorez les éléments spécifiques à la base de code (configuration Tailwind, jetons de design, etc.) et concentrez-vous sur les éléments de marque visibles.

Analyser :

• Configuration Tailwind ou variables CSS • Feuilles de style globales • Jetons de design • Actifs de logo • Favicon • Sections de héros • Texte marketing • Structure des appels à l'action • Positionnement du produit • Composants d'interface utilisateur • Utilisation existante de motion

Construire le profil interne de la marque :

• Proposition de valeur principale • Public cible • Ton de la voix • Densité visuelle • Palette primaire • Palette d'accentuation • Caractère typographique • Positionnement émotionnel

Toutes les décisions créatives doivent s'aligner sur cela.


ÉTAPE 4 — Générer la musique originale (Ignorer si pas de musique)

Utiliser ElevenLabs avec la clé ELEVEN_LABS_API_KEY existante.

Générer une piste instrumentale correspondant à :

• Le ton de la marque • L'arc émotionnel • La durée cible

Sauvegarder l'audio localement.


ÉTAPE 5 — Analyser l'audio avec ffmpeg (Ignorer si pas de musique)

Extraire :

• BPM • Horodatages des battements • Contretemps • Pics d'énergie

Créer une carte temporelle des battements.

Toutes les animations doivent s'aligner sur cette carte temporelle.


ÉTAPE 6 — Lire les règles de conception motion

Avant de produire la spécification créative, lire et intérioriser :

skills/guided/motion-design-rules

Chaque règle de cette compétence est obligatoire pour cette composition.


ÉTAPE 7 — Produire la spécification créative

Vous êtes un directeur créatif senior et un architecte de systèmes motion, concevant pour Helios en utilisant motion.dev.

Exemple d'entrée : faire une vidéo promotionnelle de 15 secondes

Sortie :

• Une spécification créative structurée • Encapsulée dans un seul bloc de code • Aucune explication en dehors

La spécification doit inclure :

• Durée • Format d'image • Résumé de la marque • Langage motion • Répartition des scènes synchronisées sur les battements • Horodatages exacts • Voix off • Texte à l'écran • Composition visuelle • Comportement d'animation motion.dev explicite • Logique de transition • Ordre des calques • Direction audio • Besoins en actifs

Utilisez uniquement une terminologie compatible motion.dev.


ÉTAPE 8 — Implémenter la composition Helios basée sur le DOM

En utilisant la spécification créative :

Créer un fichier composition.html qui :

• Utilise HTML + CSS + motion.dev • Implémente les animations avec WAAPI / CSS / motion.dev • Aligne les animations sur les horodatages des battements • Inclut le fichier audio généré • A une durée exacte

Exposer le runtime Helios :

import { helios } from "@helios-project/core";

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

Exigences :

• window.helios doit être défini • helios.bindToDocumentTimeline() doit être appelé • autoSyncAnimations: true doit être activé • Toutes les animations CSS et WAAPI doivent se synchroniser correctement • Pas d'aléatoire • Timing déterministe


ÉTAPE 9 — Rendre avec Helios CLI officiel (mode DOM)

Rendre avec :

npx @helios-project/cli render ./composition.html -o output.mp4

Exigences :

• Format d'image correct • Durée correcte • Audio attaché • CSS et WAAPI entièrement synchronisés • Sortie MP4 de haute qualité

Le fichier de sortie doit être :

output.mp4


RÈGLES D'EXÉCUTION

Si la durée ≤ 15 secondes Privilégier l'impact et la clarté.

Si aucune durée n'est spécifiée Par défaut : 30 secondes.

Ne reformulez jamais la consigne initiale. N'expliquez jamais le raisonnement. La spécification créative doit être produite uniquement dans un seul bloc de code.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

BintzGavin/helios-skills

Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code. Write one HTML page that draws any frame from its time t, render it frame-exact to MP4 with Helios, check stills and contact sheets, and add a soundtrack. Use whenever the user asks for a video or an animation file.

BintzGavin/helios-skills

>- Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic or motion-driven video (Helios, Remotion, explainers, loops, UI capture, logo reveals), or when the user asks for motion direction, pacing, or visual-story structure.

BintzGavin/helios-skills

>- End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished brand films for any SaaS or consumer product—not category-specific; pair with skills/design/animated-video-philosophy for broader motion principles.

BintzGavin/helios-skills

Patterns for using Helios with Framer Motion. Use when you want to use Framer Motion's physics and transitions but need frame-perfect synchronization with Helios.

BintzGavin/helios-skills

Patterns for using Helios with GSAP (GreenSock). Use when integrating GSAP timelines with the Helios timeline for precise scrubbing and rendering.

BintzGavin/helios-skills

End-to-end guided workflow for creating an explainer or walkthrough video. Extracts brand identity from the repo, generates a measured soundtrack, and produces a narrative-driven motion.dev composition rendered via Helios CLI. Use when making how-it-works, feature walkthrough, or educational videos.

BintzGavin/helios-skills

Motion design framework for programmatic video. Defines anti-slideshow architecture, visual layering, physics-based easing, choreography rules, and quality validation. Reference this skill from any guided video skill.

BintzGavin/helios-skills

End-to-end guided workflow for creating a social proof or testimonial video. Extracts brand identity from the repo, generates a warm soundtrack, and produces a trust-building motion.dev composition rendered via Helios CLI. Use when making customer testimonial, review highlight, or social proof videos.

BintzGavin/helios-skills

Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

Skills associés