Communitygithub.com

BintzGavin/helios-skills

End-to-end geführter Workflow zur Erstellung eines Erklär- oder Walkthrough-Videos. Extrahiert die Markenidentität aus dem Repository, generiert einen maßgeschneiderten Soundtrack und produziert eine narrative, motion.dev-basierte Komposition, die über die Helios CLI gerendert wird. Ideal für „Wie funktioniert es“-, Feature-Walkthrough- oder Lehrvideos.

Was ist helios-skills?

Dieses Skill führt einen vollständig geführten Workflow zur Erstellung professioneller Erklär- und Walkthrough-Videos direkt aus dem Kontext einer Marke oder eines Produkt-Repositories heraus aus. Es automatisiert die Extraktion der Markenidentität – entweder durch Analyse des Codebestands (Tailwind-Konfiguration, CSS-Variablen, Design-Tokens, Logos, Favicon usw.) oder durch Recherche einer bereitgestellten URL. Anschließend können auf Wunsch mit einem ElevenLabs-API-Key ein passender, dezent unterstützender Hintergrund-Soundtrack generiert und dessen Tempo (BPM, Beats, Downbeats) via ffmpeg analysiert werden. Basierend auf den Regeln der integrierten motion-design-rules erstellt das Skill eine detaillierte kreative Spezifikation mit narrativem Bogen (Hook → Problem → Lösung → Walkthrough → CTA), exakten Zeitstempeln, Voiceover-Text und präzisen motion.dev-Animationen. Die finale HTML+CSS+motion.dev-Komposition wird automatisch ausgegeben und über die offizielle Helios CLI zu einem synchronisierten MP4-Video in 16:9 gerendert. Das Skill folgt einem strikten, deterministischen Pipeline-Ansatz – keine Zufälligkeit, keine überflüssigen Erklärungen – und stellt sicher, dass Schlüsselbotschaften mindestens 3 Sekunden sichtbar bleiben. Es wird dringend empfohlen, dass der Benutzer vor Beginn zwei Fragen zu Repository/URL und Musikwunsch beantwortet.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/explainer-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 Repositorys der Marke oder von einem externen Kontext aus.

Rate nicht die Markenidentität. Analysiere entweder den Codebestand oder recherchiere die bereitgestellte URL.


AUSFÜHRUNGS-PIPELINE

SCHRITT 1 — Kontext sammeln

⛔ STOP. Stelle dem Benutzer diese zwei Fragen:

  1. „Befinden wir uns in Ihrem Marken-Repository oder möchten Sie eine URL (z. B. Ihre Marketingseite) angeben, damit ich Ihre Marke online recherchieren kann?“

  2. „Möchten Sie generierte Hintergrundmusik? Wenn ja, benötigen Sie einen ELEVEN_LABS_API_KEY in Ihrer Umgebung. Sie erhalten 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 sie für die Markenrecherche in SCHRITT 3 anstelle der Codebestandsanalyse. Wenn der Benutzer Musik ablehnt, überspringe SCHRITT 4 und SCHRITT 5.


SCHRITT 2 — Helios-Laufzeitabhängigkeiten sicherstellen

Installiere erforderliche Pakete:

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

Du wirst im DOM-Modus rendern.


SCHRITT 3 — Markenintelligenz aus dem Repository extrahieren

Wenn der Benutzer anstelle eines Repositorys eine URL angegeben hat, rufe diese URL ab und extrahiere die gleichen Markensignale von der Live-Seite. Überspringe codespezifische 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 • Dokumentationsstruktur • Feature-Beschreibungen • Onboarding-Abläufe • Hilfetexte und Mikrotexte • Informationsarchitektur • UI-Komponenten • Vorhandene Motion-Nutzung

Erstelle ein internes Markenprofil:

• Kernnutzenversprechen • Zielgruppe • Sprachlicher Ton (instruktiv, unterstützend, autoritär) • Visuelle Dichte • Primäre Palette • Akzentpalette • Typografie-Charakter • Muster der Informationshierarchie • Erklärstil (visuell-lastig vs. textlastig)

Alle kreativen Entscheidungen müssen damit übereinstimmen.


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

Verwende ElevenLabs mit dem vorhandenen ELEVEN_LABS_API_KEY.

Generiere einen Instrumentaltrack, der folgendem entspricht:

• Ruhiger, unterstützender Ton • Stetiger Fortschritt ohne dramatische Spitzen • Subtile Hintergrundpräsenz (darf nicht mit der Erzählung konkurrieren) • Ziellaufzeit

Speichere Audio lokal.


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

Extrahiere:

• BPM • Beat-Zeitstempel • Downbeats • Energie-Spitzen

Erstelle eine Beat-Timing-Karte.

Abschnittsübergänge sollten auf Downbeats ausgerichtet sein. Einblendungen von Bildschirmtext sollten auf Beats ausgerichtet 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 leitender Creative Director und Instructional Design Architect, der für Helios mit motion.dev entwirft.

Eingabebeispiel: Erklären Sie, wie unser Checkout-Ablauf in 60 Sekunden funktioniert

Ausgabe:

• Eine strukturierte kreative Spezifikation • In einem einzelnen Codeblock • Keine Erklärung außerhalb

Die Spezifikation muss Folgendes enthalten:

• Dauer • Seitenverhältnis (16:9) • Markenzusammenfassung • Narrativer Bogen (Einführung → Problem → Lösung → Wie es funktioniert → CTA) • Bewegungssprache (abgemessen, bewusst, fortschreitend) • Beat-synchronisierte Abschnittsaufteilung • Exakte Zeitstempel pro Abschnitt • Voiceover-Skript (konversationell, klar) • Bildschirmtext (Abschnittsüberschriften, Feature-Bezeichnungen, Schrittnummern) • Visuelle Komposition (saubere Layouts, großzügiger Weißraum) • Explizites motion.dev-Animationsverhalten • Überblendungslogik (sanfte Crossfades zwischen Abschnitten, Slide-Ins für Inhalt) • Anordnung der Ebenen • Audio-Regie • Asset-Anforderungen • Schrittindikatoren oder Fortschrittsmarker

Verwende nur motion.dev-kompatible Terminologie.

Anforderungen an die narrative Struktur:

• Einstiegshaken (erste 5 Sekunden) • Problemidentifikation • Lösungseinführung • Schritt-für-Schritt-Walkthrough • Zusammenfassung und CTA


SCHRITT 8 — DOM-basierte Helios-Komposition implementieren

Erstelle unter Verwendung der kreativen Spezifikation:

Eine Datei composition.html, die:

• HTML + CSS + motion.dev verwendet • Animationen mit WAAPI / CSS / motion.dev implementiert • Abschnittsübergänge an Downbeats ausrichtet • Klare Abschnittsüberschriften mit Schrittnummerierung verwendet • Die generierte Audiodatei einbindet • Die genaue Dauer hat • Lesbarkeit und visuelle Klarheit priorisiert

Lege die Helios-Laufzeit offen:

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 werden • Keine Zufälligkeit • Deterministisches Timing • Text muss lange genug auf dem Bildschirm bleiben, um gelesen zu werden (mindestens 3 Sekunden pro Schlüsselbotschaft)


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

Rendere mit:

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

Anforderungen:

• 16:9 Seitenverhältnis • Korrekte Dauer • Audio angehängt • CSS und WAAPI vollständig synchronisiert • Hochwertige MP4-Ausgabe

Die Ausgabedatei muss sein:

output.mp4


LAUFZEITREGELN

Wenn Dauer ≤ 30 Sekunden Komprimiere auf: Haken → Kernkonzept → CTA.

Wenn keine Dauer angegeben Standard auf 60 Sekunden.

Maximal 5 Abschnitte für jede Dauer. Jeder Abschnitt muss eine klare Bildschirmüberschrift haben. Das Tempo muss Verständnis ermöglichen – überschütte niemals mit Informationen.

Wiederhole niemals die ursprüngliche Aufforderung. Erkläre niemals die Argumentation. Die kreative Spezifikation muss nur innerhalb eines einzelnen Codeblocks 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

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.

Verwandte Skills