Communitygithub.com

BintzGavin/helios-skills

End-to-End-gesteuerter Workflow zur Erstellung eines werblichen Hype-Videos. Extrahiert die Markenidentität aus dem Repository, generiert taktsynchrone Musik und erzeugt eine hochoktanige motion.dev-Komposition, die über die Helios CLI gerendert wird. Verwende dies für markenkonforme Promo- oder Hype-Videos.

Was ist helios-skills?

Dieser Skill führt einen vollständig gesteuerten, schrittweisen Workflow aus, um aus einem Code-Repository oder einer angegebenen URL ein professionelles Hype-Video zu erstellen. Er analysiert die Markenidentität (Farbpalette, Design-Tokens, Logo, Tonalität), generiert optional mit ElevenLabs taktsynchrone Hintergrundmusik, analysiert diese mit ffmpeg auf BPM und Beats und erstellt dann eine präzise motion.dev-Komposition. Der Skill ist für Entwickler gedacht, die in Marken-Repositories arbeiten oder eine externe URL zur Markenrecherche nutzen. Unterstützt werden Helios CLI und DOM-Rendering im motion.de-Framework. Besonders nützlich für die schnelle, reproduzierbare und markenkonforme Erstellung von Werbe- oder Hype-Videos ohne manuelles Design oder Schnittarbeit. Der gesamte Prozess ist deterministisch und skriptgesteuert – von der Kontextanalyse bis zum finalen MP4-Output.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Möglicherweise arbeitest du innerhalb des Marken-Repositorys oder aus einem externen Kontext heraus.

Rate nicht die Markenidentität. Analysiere entweder die Codebasis oder recherchiere die angegebene URL.


AUSFÜHRUNGSPIPELINE

SCHRITT 1 — Kontext sammeln

⛔ STOPP. Stelle dem Benutzer diese beiden Fragen:

  1. "Befinden wir uns in deinem Marken-Repository, oder möchtest du eine URL angeben (z. B. deine Marketing-Website), damit ich deine Marke online recherchieren kann?"

  2. "Möchtest du generierte Hintergrundmusik? Wenn ja, benötigst du einen ELEVEN_LABS_API_KEY in deiner Umgebung. Du erhältst einen unter https://elevenlabs.io → Profil → API-Schlüssel."

Warte auf die Antwort des Benutzers auf beide Fragen.

Versuche nicht, .env-Dateien zu lesen oder Schlüssel selbst zu überprüfen. Vertraue den Antworten des Benutzers.

Wenn der Benutzer eine URL angibt, verwende diese für die Markenrecherche in SCHRITT 3 anstelle der Codebase-Analyse. Wenn der Benutzer Musik ablehnt, überspringe SCHRITT 4 und SCHRITT 5.


SCHRITT 2 — Helios-Laufzeitabhängigkeiten sicherstellen

Erforderliche Pakete installieren:

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

Du renderst im DOM-Modus.


SCHRITT 3 — Markenintelligenz aus dem Repository extrahieren

Wenn der Benutzer eine URL anstelle eines Repositorys angegeben hat, rufe diese URL ab und extrahiere die gleichen Markensignale von der Live-Seite. Überspribe codebasespezifische Elemente (Tailwind-Konfiguration, Design-Tokens usw.) und konzentriere dich auf sichtbare Markenelemente.

Analysiere:

• Tailwind-Konfiguration oder CSS-Variablen • Globale Stylesheets • Design-Tokens • Logo-Assets • Favicon • Hero-Bereiche • Marketingtexte • CTA-Struktur • Produktpositionierung • UI-Komponenten • Vorhandene motion.dev-Nutzung

Erstelle internes Markenprofil:

• Kernwertversprechen • Zielgruppe • Tonalität • Visuelle Dichte • Primäre Palette • Akzentpalette • Typografie-Charakter • Emotionale Positionierung

Alle kreativen Entscheidungen müssen darauf abgestimmt sein.


SCHRITT 4 — Originalmusik generieren (Überspringen, wenn keine Musik gewünscht)

Verwende ElevenLabs mit vorhandenem ELEVEN_LABS_API_KEY.

Generiere instrumentalen Track passend zu:

• Marken-Tonalität • Emotionalem Bogen • Ziel-Laufzeit

Speichere Audio lokal.


SCHRITT 5 — Audio mit ffmpeg analysieren (Überspringen, wenn keine Musik)

Extrahiere:

• BPM • Beat-Zeitstempel • Downbeats • Energie-Peaks

Erstelle Beat-Timing-Karte.

Alle Animationen müssen auf diese Timing-Karte abgestimmt sein.


SCHRITT 6 — Motion-Design-Regeln lesen

Bevor du die kreative Spezifikation erstellst, lies und verinnerliche:

skills/guided/motion-design-rules

Jede Regel in diesem Skill ist für diese Komposition verbindlich.


SCHRITT 7 — Kreative Spezifikation erstellen

Du bist ein Senior Creative Director und Motion-System-Architekt, der für Helios mit motion.dev entwirft.

Eingabebeispiel: erstelle ein 15-sekündiges Hype-Video

Ausgabe:

• Eine strukturierte kreative Spezifikation • In einem einzigen Code-Block • Keine Erklärung außerhalb dieses Blocks

Die Spezifikation muss enthalten:

• Dauer • Seitenverhältnis • Markenzusammenfassung • Bewegungssprache • Taktsynchrone Szenenaufteilung • Genaue Zeitstempel • Voiceover • Text auf dem Bildschirm • Visuelle Komposition • Explizites motion.dev-Animationsverhalten • Übergangslogik • Schichtungsreihenfolge • Audio-Richtung • Asset-Anforderungen

Verwende ausschließlich motion.dev-kompatible Terminologie.


SCHRITT 8 — DOM-basierte Helios-Komposition implementieren

Basierend auf der kreativen Spezifikation:

Erstelle eine Datei composition.html, die:

• HTML + CSS + motion.dev verwendet • Animationen mit WAAPI / CSS / motion.dev implementiert • Animationen auf Beat-Zeitstempel abstimmt • Die generierte Audiodatei einbindet • Die exakte Dauer hat

Helios-Laufzeit exposen:

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

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

Anforderungen:

• window.helios muss definiert sein • helios.bindToDocumentTimeline() muss aufgerufen werden • autoSyncAnimations: true muss aktiviert sein • Alle CSS- und WAAPI-Animationen müssen korrekt synchronisiert sein • Keine Zufälligkeit • Deterministisches Timing


SCHRITT 9 — Mit der offiziellen Helios CLI rendern (DOM-Modus)

Rendern mit:

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

Anforderungen:

• Korrektes Seitenverhältnis • Korrekte Dauer • Audio eingebettet • CSS und WAAPI vollständig synchronisiert • Hochwertige MP4-Ausgabe

Ausgabedatei muss sein:

output.mp4


LAUFZEITREGELN

Wenn Dauer ≤ 15 Sekunden Priorisiere Wucht und Klarheit.

Wenn keine Dauer angegeben Standard: 30 Sekunden.

Wiederhole niemals die ursprüngliche Eingabeaufforderung. Erkläre niemals die Argumentation. Die kreative Spezifikation muss ausschließlich in einem einzigen Code-Block ausgegeben werden.

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.

Verwandte Skills