Communitygithub.com

BintzGavin/helios-skills

Workflow guidé de bout en bout pour créer une vidéo explicative ou de démonstration. Extrait l'identité de marque du dépôt, génère une bande-son mesurée et produit une composition motion.dev narrative rendue via Helios CLI. À utiliser pour les vidéos « comment ça marche », de présentation de fonctionnalités ou éducatives.

Qu'est-ce que helios-skills ?

Cette compétence est conçue pour les développeurs et créateurs de contenu qui souhaitent produire des vidéos explicatives professionnelles de manière automatisée, en s'appuyant sur l'identité visuelle d'une marque et sur une bande-son générée par IA. Elle prend en charge les plateformes Helios et ElevenLabs, et fonctionne aussi bien à l'intérieur d'un dépôt de code qu'à partir d'une URL externe. Le pipeline en neuf étapes commence par la collecte du contexte (dépôt ou URL), l'installation des dépendances Helios, puis l'extraction des signaux de marque (palette, typographie, ton, composants d'interface). Si l'utilisateur le souhaite, une musique de fond est générée via l'API ElevenLabs, et ses caractéristiques temporelles (BPM, temps forts) sont analysées avec ffmpeg pour synchroniser les transitions et les animations. La partie créative est pilotée par un fichier de règles de conception motion.dev, qui dicte une spécification détaillée incluant l'arc narratif, le script voix-off, le texte à l'écran et les comportements d'animation. La composition finale est implémentée en HTML/CSS avec motion.dev, puis rendue en vidéo MP4 via la CLI Helios. Les règles d'exécution imposent une durée minimale de 3 secondes par message clé, une absence d'aléatoire, et l'adaptation du nombre de sections à la durée totale (maximum 5).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/explainer-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 opérer à l'intérieur du dépôt de la marque, ou travailler à partir d'un contexte externe.

Ne devinez pas l'identité de la marque. Analysez le code source ou recherchez l'URL fournie.


PIPELINE D'EXÉCUTION

ÉTAPE 1 — Recueillir le contexte

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

  1. « Sommes-nous à l'intérieur du dépôt de votre marque, ou souhaitez-vous fournir une URL (par exemple votre site marketing) afin que je puisse rechercher votre marque en ligne ? »

  2. « Souhaitez-vous une musique de fond générée ? Si oui, vous aurez besoin d'une clé ELEVEN_LABS_API_KEY dans votre environnement. 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 ni 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 marque à l'ÉTAPE 3 au lieu d'analyser le code source. Si l'utilisateur refuse la musique, sautez l'ÉTAPE 4 et l'ÉTAPE 5.


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

Installez les paquets requis :

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

Vous effectuerez le rendu en mode DOM.


ÉTAPE 3 — Extraire l'intelligence de marque depuis le 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 au code source (config Tailwind, tokens de design, etc.) et concentrez-vous sur les éléments de marque visibles.

Analysez :

• Configuration Tailwind ou variables CSS • Feuilles de style globales • Tokens de design • Assets du logo • Favicon • Structure de la documentation • Descriptions des fonctionnalités • Flux d'intégration • Texte d'aide et microcopie • Architecture de l'information • Composants d'interface utilisateur • Utilisation existante du motion design

Construisez un profil de marque interne :

• Proposition de valeur principale • Public cible • Ton de la voix (instructif, bienveillant, autoritaire) • Densité visuelle • Palette primaire • Palette d'accentuation • Caractère typographique • Modèles de hiérarchie de l'information • Style d'explication (d'abord visuel ou plutôt textuel)

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


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

Utilisez ElevenLabs avec la clé ELEVEN_LABS_API_KEY existante.

Générez une piste instrumentale correspondant à :

• Ton calme et bienveillant • Progression régulière sans pics dramatiques • Présence subtile en arrière-plan (ne doit pas concurrencer la narration) • Durée cible

Enregistrez l'audio localement.


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

Extrayez :

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

Créez une carte temporelle des temps forts.

Les transitions de section doivent s'aligner sur les contretemps. Les révélations de texte à l'écran doivent s'aligner sur les temps.


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

Avant de produire le cahier des charges créatif, lisez et intériorisez :

skills/guided/motion-design-rules

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


ÉTAPE 7 — Produire le cahier des charges créatif

Vous êtes un directeur créatif senior et un architecte pédagogique spécialisé dans la conception pour Helios utilisant motion.dev.

Exemple d'entrée : expliquer le fonctionnement de notre flux de paiement en 60 secondes

Sortie :

• Un cahier des charges créatif structuré • Enveloppé dans un seul bloc de code • Aucune explication en dehors

Le cahier des charges doit inclure :

• Durée • Format d'image (16:9) • Résumé de marque • Arc narratif (Introduction → Problème → Solution → Fonctionnement → Appel à l'action) • Langage motion (mesuré, délibéré, progressif) • Décomposition synchronisée des sections sur les temps forts • Horodatages exacts par section • Script voix-off (conversationnel, clair) • Texte à l'écran (en-têtes de section, étiquettes de fonctionnalités, numéros d'étape) • Composition visuelle (mises en page nettes, espaces généreux) • Comportement d'animation motion.dev explicite • Logique de transition (fondus enchaînés fluides entre les sections, glissements pour le contenu) • Ordre de superposition • Direction audio • Besoins en assets • Indicateurs d'étape ou marqueurs de progression

Utilisez uniquement une terminologie compatible motion.dev.

Exigences de structure narrative :

• Accroche d'ouverture (5 premières secondes) • Identification du problème • Présentation de la solution • Démonstration pas à pas • Résumé et appel à l'action


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

En utilisant le cahier des charges créatif :

Créez un fichier composition.html qui :

• Utilise HTML + CSS + motion.dev • Implémente les animations via WAAPI / CSS / motion.dev • Aligne les transitions de section sur les contretemps • Utilise des en-têtes de section clairs avec numérotation des étapes • Inclut le fichier audio généré • A une durée exacte • Privilégie la lisibilité et la clarté visuelle

Exposez 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 • Aucun aléatoire • Synchronisation déterministe • Le texte doit rester à l'écran suffisamment longtemps pour être lu (minimum 3 secondes par message clé)


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

Effectuez le rendu avec :

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

Exigences :

• Format 16:9 • 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 ≤ 30 secondes Compressez en : Accroche → Concept clé → Appel à l'action.

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

Maximum 5 sections pour toute durée. Chaque section doit avoir un en-tête clair à l'écran. Le rythme doit permettre la compréhension — ne précipitez jamais l'information.

Ne reformulez jamais la demande originale. N'expliquez jamais votre raisonnement. Le cahier des charges créatif doit être produit uniquement à l'intérieur d'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

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 promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

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