Communitygithub.com

BintzGavin/helios-skills

End-to-End geführter Workflow zur Erstellung eines Social-Proof- oder Testimonial-Videos. Extrahiert die Markenidentität aus dem Repository, generiert einen warmen Soundtrack und erstellt eine vertrauensbildende motion.dev-Komposition, die über die Helios-CLI gerendert wird. Verwenden Sie dies, um Kundenstimmen, Bewertungs-Highlights oder Social-Proof-Videos zu erstellen.

Was ist helios-skills?

Dieses Skillpaket bietet einen vollständig geführten, mehrstufigen Arbeitsablauf zur Erstellung von professionellen Testimonial- und Social-Proof-Videos. Es beginnt mit der Erfassung des Kontexts durch den Benutzer: Entweder analysiert das Tool das Code-Repository der Marke oder eine bereitgestellte URL, um wichtige Markenattribute wie Wertversprechen, Zielgruppe, Sprachton und visuelle Identität zu extrahieren. Anschließend kann optional mit dem ElevenLabs-Dienst ein warmer, vertrauensbildender Hintergrundsoundtrack generiert werden, wobei ein ELEVEN_LABS_API_KEY erforderlich ist. Wenn ein Soundtrack vorhanden ist, wird dessen BPM und Beat-Timing (inklusive Downbeats und Energie-Peaks) mittels ffmpeg analysiert, um die Animationen später zu synchronisieren. Basierend auf einer umfangreichen Marken- und Bewegungsdesign-Bibliothek (motion-design-rules) erstellt das Skill dann eine detaillierte kreative Spezifikation für das Video. Diese Spezifikation wird anschließend in einer motion.dev-Komposition (HTML + CSS + WAAPI) umgesetzt, die als composition.html-Datei vorliegt und mittels der offiziellen Helios CLI (DOM-Modus) zu einem MP4-Video gerendert wird. Das Skill unterstützt die Plattformen Helios (CLI, Renderer, Core) und motion.dev für Animationen und ist besonders nützlich für Entwickler, die automatisiert Social-Proof-Inhalte aus ihren Marken-Assets generieren möchten.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Möglicherweise arbeiten Sie im Repository der Marke oder aus einem externen Kontext.

Erraten Sie nicht die Markenidentität. Analysieren Sie entweder die Codebasis oder recherchieren Sie die angegebene URL.


AUSFÜHRUNGSPIPELINE

SCHRITT 1 — Kontext sammeln

⛔ STOP. Stellen Sie dem Benutzer diese beiden Fragen:

  1. „Befinden wir uns im Repository Ihrer Marke, oder möchten Sie eine URL (z. B. Ihre Marketing-Website) 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.“

Warten Sie auf die Antworten des Benutzers auf beide Fragen.

Versuchen Sie nicht, .env-Dateien zu lesen oder Schlüssel selbst zu überprüfen. Vertrauen Sie den Antworten des Benutzers.

Wenn der Benutzer eine URL bereitstellt, verwenden Sie diese für die Markenrecherche in SCHRITT 3 anstelle der Codebase-Analyse. Wenn der Benutzer die Musik ablehnt, überspringen Sie SCHRITT 4 und SCHRITT 5.


SCHRITT 2 — Helios-Laufzeitabhängigkeiten sicherstellen

Installieren Sie die erforderlichen Pakete:

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

Sie rendern im DOM-Modus.


SCHRITT 3 — Markenintelligenz aus dem Repository extrahieren

Wenn der Benutzer eine URL anstelle eines Repos bereitgestellt hat, rufen Sie diese URL ab und extrahieren Sie dieselben Markensignale von der Live-Site. Überspringen Sie codebasisspezifische Elemente (Tailwind-Konfiguration, Design-Tokens usw.) und konzentrieren Sie sich auf sichtbare Markenelemente.

Analysieren Sie:

• Tailwind-Konfiguration oder CSS-Variablen • Globale Stylesheets • Design-Tokens • Logo-Assets • Favicon • Testimonial-Abschnitte oder -Komponenten • Bewertungs-/Rating-Anzeigen • Kundenlogos oder Partnerbereiche • Vertrauensbadges oder Zertifizierungsmarken • Social-Proof-Muster (Zähler, Statistiken, Logos) • Marketingtexte und Wertversprechen • CTA-Struktur

Erstellen Sie ein internes Markenprofil:

• Zentrales Wertversprechen • Zielgruppe • Sprachton (warm, authentisch, vertrauenswürdig) • Visuelle Dichte • Primäre Palette • Akzentpalette (warme Töne für Vertrauen) • Typografie-Charakter • Social-Proof-Strategie (Zitate, Statistiken, Logos oder eine Kombination)

Alle kreativen Entscheidungen müssen damit übereinstimmen.


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

Verwenden Sie ElevenLabs mit dem vorhandenen ELEVEN_LABS_API_KEY.

Generieren Sie einen Instrumentaltrack, der Folgendem entspricht:

• Warmer, aufbauender Ton • Sanfter Aufbau zu einem emotionalen Höhepunkt • Inspirierend, aber nicht aggressiv • Ziellaufzeit

Speichern Sie das Audio lokal.


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

Extrahieren Sie:

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

Erstellen Sie eine Beat-Timing-Karte.

Zitate müssen auf Downbeats erscheinen. Name-/Titel-Einblendungen sollten auf Beats ausgerichtet sein.


SCHRITT 6 — Bewegungsdesign-Regeln lesen

Lesen und verinnerlichen Sie vor der Erstellung der kreativen Spezifikation:

skills/guided/motion-design-rules

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


SCHRITT 7 — Kreative Spezifikation erstellen

Sie sind ein leitender Kreativdirektor und Markenvertrauensarchitekt, der für Helios mit motion.dev entwirft.

Eingabebeispiel: erstelle ein 30-Sekunden-Testimonial-Video

Ausgabe:

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

Die Spezifikation muss Folgendes enthalten:

• Dauer • Seitenverhältnis (16:9) • Markenzusammenfassung • Bewegungssprache (warm, elegant, bewusst) • Taktsynchronisierte Szenenaufteilung • Genaue Zeitstempel • Voiceover (optional — möglicherweise reiner Text-Ansatz) • Text auf dem Bildschirm (Zitate, Namensnennung, Statistiken, CTA) • Visuelle Komposition (Zitatkarten, Avatare, Sternbewertungen, Kundenlogos) • Explizites motion.dev-Animationverhalten • Übergangslogik (sanfte Überblendungen, weiche Folien, subtile Skalierung) • Schichtreihenfolge (Hintergrundtextur → Zitatkarte → Avatar/Foto → Namensnennung → Statistiken) • Audio-Richtung • Asset-Anforderungen • Typografie-Hierarchie (Zitattext groß, Namensnennung kleiner, Statistiken prominent)

Verwenden Sie nur motion.dev-kompatible Terminologie.

Anforderungen an die Testimonial-Struktur:

• Eröffnungs-Markenmoment oder Kontextsetzer (2-3 Sekunden) • Zitat 1: Vollständiges Zitat mit Namensnennung • Zitat 2: Vollständiges Zitat mit Namensnennung (falls die Dauer es erlaubt) • Social-Proof-Statistiken (Zahlen, Bewertungen, Kundenzahl) • Abschließender CTA mit Markenzeichen

Jeder Zitatabschnitt: • Zitattext wird animiert eingeblendet (Schreibmaschinen-Effekt oder zeilenweises Einblenden) • Kurze Pause zum Lesen • Namensnennung erscheint (Name, Titel, Unternehmen) • Optional: Kundenunternehmenslogo oder Avatar


SCHRITT 8 — DOM-basierte Helios-Komposition implementieren

Erstellen Sie basierend auf der kreativen Spezifikation eine composition.html-Datei, die:

• HTML + CSS + motion.dev verwendet • Animationen mittels WAAPI / CSS / motion.dev implementiert • Zitatenblendungen auf Downbeats ausrichtet • Elegante Zitatkarten-Typografie verwendet • Dekorative Anführungszeichen-Elemente enthält • Die generierte Audiodatei einbindet • Die genaue Dauer hat

Stellen Sie die Helios-Laufzeit bereit:

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 • Zitate müssen mindestens 4 Sekunden lang lesbar bleiben • Sternbewertungen sollten nacheinander animiert werden


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

Rendern mit:

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

Anforderungen:

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

Ausgabedatei muss sein:

output.mp4


LAUFZEITREGELN

Wenn Dauer ≤ 15 Sekunden Zeigen Sie 1 Zitat + 1 Statistik + CTA. Priorisieren Sie das stärkste Zitat.

Wenn keine Dauer angegeben Standardmäßig 30 Sekunden.

Maximal 3 Zitate für jede Dauer. Zitate müssen echt oder repräsentativ sein — niemals erfunden. Wenn im Repository keine Testimonials vorhanden sind, verwenden Sie eine Platzhalterstruktur mit klaren Bezeichnungen.

Wiederholen Sie nie die ursprüngliche Aufforderung. Erklären Sie nie Ihre Argumentation. Die kreative Spezifikation darf 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

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.

Verwandte Skills