Communitygithub.com

BintzGavin/helios-skills

Guide de bout en bout pour créer une vidéo de preuve sociale ou de témoignage. Extrais l'identité de marque depuis le dépôt, génère une bande sonore chaleureuse et produit une composition motion.dev optimisée pour la confiance, rendue via Helios CLI.

Qu'est-ce que helios-skills ?

Cette compétence guide un assistant IA à travers un pipeline complet pour produire une vidéo de témoignage client ou de preuve sociale. Elle commence par extraire l'identité de marque soit en analysant un dépôt de code existant (config Tailwind, tokens de design, logos, sections de témoignages), soit en étudiant un site web fourni par l'utilisateur. Le pipeline comprend la génération optionnelle d'une musique de fond via l'API ElevenLabs (nécessite une clé API), l'analyse de l'audio avec ffmpeg pour aligner les révélations de citations sur les temps forts, et la production d'un cahier des charges créatif détaillé. Ce cahier, qui respecte des règles de conception de mouvement strictes, décrit une composition motion.dev synchronisée avec la musique. La compétence se termine par l'implémentation d'une composition HTML utilisant motion.dev, puis le rendu vidéo via la CLI Helios en mode DOM, produisant un fichier MP4 de haute qualité. Elle est conçue pour les environnements de développement où un outil comme Claude Code ou Cursor peut exécuter des étapes, installer des dépendances npm et lancer des commandes CLI.

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

Ne devinez pas l'identité de la marque. Analysez soit le codebase, soit recherchez l'URL fournie.


PIPELINE D'EXÉCUTION

ÉTAPE 1 — Rassembler le Contexte

⛔ ARRÊTEZ-VOUS. 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 une musique de fond générée ? Si oui, vous aurez besoin de la 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 la recherche de marque à l'ÉTAPE 3 au lieu d'analyser le codebase. Si l'utilisateur refuse la musique, passez les ÉTAPE 4 et ÉTAPE 5.


ÉTAPE 2 — S'assurer des 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 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 à partir du site en direct. Ignorez les éléments spécifiques au codebase (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 • Actifs du logo • Favicon • Sections ou composants de témoignages • Affichages d'avis/évaluations • Logos clients ou sections partenaires • Badges de confiance ou marques de certification • Modèles de preuve sociale (compteurs, statistiques, logos) • Texte marketing et propositions de valeur • Structure des CTA

Construisez le profil interne de la marque :

• Proposition de valeur principale • Public cible • Ton de la voix (chaleureux, authentique, digne de confiance) • Densité visuelle • Palette primaire • Palette d'accentuation (tons chauds pour la confiance) • Personnalité typographique • Stratégie de preuve sociale (citations, statistiques, logos, ou combinaison)

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 chaleureux et optimiste • Montée en puissance douce vers un pic émotionnel • Inspirant mais pas agressif • Durée cible

Sauvegardez l'audio localement.


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

Extrayez :

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

Créez une carte de synchronisation des temps forts.

Les révélations de citations doivent atterrir sur les contretemps. Les révélations de noms/titres doivent s'aligner sur les temps forts.


ÉTAPE 6 — Lire les Règles de Conception de Mouvement

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

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 de confiance de marque concevant pour Helios en utilisant motion.dev.

Exemple d'entrée :

réalisateur: fais une vidéo de témoignage de 30 secondes

Sortie :

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

Le cahier des charges doit inclure :

• Durée • Ratio d'aspect (16:9) • Résumé de la marque • Langage de mouvement (chaleureux, élégant, délibéré) • Décomposition des scènes synchronisées sur les temps forts • Horodatages exacts • Voix off (optionnelle – peut utiliser une approche textuelle uniquement) • Texte à l'écran (citations, attribution, statistiques, CTA) • Composition visuelle (cartes de citation, avatars, évaluations par étoiles, logos clients) • Comportement d'animation motion.dev explicite • Logique de transition (fondus en douceur, glissements légers, échelle subtile) • Ordre des couches (fond texturé → carte de citation → avatar/photo → attribution → statistiques) • Direction audio • Actifs requis • Hiérarchie typographique (texte de citation grand, attribution plus petit, statistiques proéminentes)

Utilisez uniquement une terminologie compatible motion.dev.

Exigences de structure du témoignage :

• Moment d'ouverture de la marque ou mise en contexte (2-3 secondes) • Citation 1 : Citation complète avec attribution • Citation 2 : Citation complète avec attribution (si la durée le permet) • Statistiques de preuve sociale (chiffres, évaluations, nombre de clients) • CTA de clôture avec marque

Chaque segment de citation : • Le texte de la citation apparaît en animation (machine à écrire ou fondu par ligne) • Brève pause pour la lecture • L'attribution apparaît (nom, titre, entreprise) • Optionnel : logo de l'entreprise cliente ou avatar


É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 des animations via WAAPI / CSS / motion.dev • Aligne les révélations de citations sur les contretemps • Utilise une typographie élégante de carte de citation • Inclut des éléments décoratifs de guillemets • Inclut le fichier audio généré • A une durée exacte

Exposez l'exécution 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 de hasard • Synchronisation déterministe • Les citations doivent rester lisibles pendant au moins 4 secondes chacune • Les évaluations par étoiles doivent s'animer de manière séquentielle


ÉTAPE 9 — Effectuer le Rendu avec la CLI Helios Officielle (Mode DOM)

Effectuez le rendu avec :

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

Exigences :

• Ratio d'aspect 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 ≤ 15 secondes Affichez 1 citation + 1 statistique + CTA. Priorisez la citation la plus forte.

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

Maximum 3 citations pour toute durée. Les citations doivent être réelles ou représentatives – ne jamais les fabriquer. Si aucun témoignage n'existe dans le dépôt, utilisez une structure d'espace réservé avec des étiquettes claires.

Ne reformulez jamais l'invite originale. N'expliquez jamais votre raisonnement. Le cahier des charges créatif doit être produit à l'intérieur d'un seul bloc de code uniquement.

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 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

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