Communitygithub.com

1345AbhishekKumar/starter-supabase

Erfasse eine beliebige Website/URL und verwandle sie in ein HyperFrames-Video (Site-Tour, Präsentation oder Social-Clip basierend auf den visuellen Inhalten der Seite). Verwendet Headless-Chrome-Screenshots und Marken-Assets.

Was ist starter-supabase?

Dieses Skill ermöglicht es, aus einer beliebigen Website schnell ein professionelles Video zu erstellen – ideal für Portfolio-, Blog-, Landing-Page-Präsentationen oder Social-Media-Clips. Es nutzt den HyperFrames-Workflow, der aus sieben Schritten besteht: Erfassung der Website, Analyse der Markenidentität, Strategie & Messaging, Storyboard & Drehbuch, Sprachausgabe & Timing, Erstellung der Kompositionen sowie Validierung & Auslieferung. Der Skill ist kollaborativ aufgebaut, mit Entscheidungstoren, die den Nutzer einbeziehen, unterstützt aber auch einen autonomen Modus für wiederkehrende Präferenzen. Wichtig: Es ist speziell für allgemeine Websites gedacht – für Produkt-Launch-Videos, thematische Erklärvideos ohne Website, GitHub-PR-Videos oder das Hinzufügen von Untertiteln zu bestehenden Videos gibt es separate Skills. Das Skill arbeitet plattformunabhängig und erfordert lediglich eine URL als Ausgangspunkt. Die Ausgabe erfolgt als lokale Studio-URL, die auf Wunsch in MP4 gerendert werden kann. Der gesamte Workflow legt großen Wert auf Qualitätssicherung durch automatisierte Linting- und Validierungsschritte sowie eine ehrliche Offenlegung dessen, was nicht überprüft wurde.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/website-to-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

media-use: Bevor Audio/Assets beschafft werden, /media-use aufrufen, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Zuerst --adopt ausführen, um vorhandene Assets zu registrieren. Siehe Skill /media-use.

Website zu HyperFrames

Erfasse eine Website und erstelle daraus ein professionelles Video.

Bestätige den Pfad vor Schritt 0. Dieses Skill erstellt ein Video von / über eine allgemeine Website. Wenn es dem Nutzer wirklich um Vermarktung / Launch / Promotion eines Produkts geht (auch von dieser URL, auch „Promo für unsere Website“) → /product-launch-video. Ein themenspezifisches Erklärvideo ohne Website → /faceless-explainer; ein GitHub PR → /pr-to-video; Neu zuschneiden / einfärben / anordnen einer vorhandenen Videodatei → außerhalb des Rahmens. Wird hier bei einer vagen Aussage „Video erstellen“ oder bei Unsicherheit Launch-vs-allgemeine-Website gelandet? Lies zuerst /hyperframes (vollständige Routing-Tabelle + § Was HyperFrames nicht kann).

Nutzer sagen Dinge wie:

  • „Verwandle diese Website in einen 15-Sekunden-Social-Clip für Instagram“
  • „Erstelle eine 30-Sekunden-Site-Tour / Präsentation von https://…“
  • „Erfasse unsere Startseite und baue ein Video aus ihren eigenen visuellen Inhalten“

Der Workflow besteht aus 7 Schritten. Jeder erzeugt ein Artefakt, das den nächsten Schritt freigibt. Standardmäßig ist er kollaborativ – Tore, die mit 💬 markiert sind, stoppen und fragen den Nutzer. Signalisiert der Nutzer den autonomen Modus („entscheide für mich“, „überrasche mich“), werden 💬 Nutzerpräferenz-Tore übersprungen; siehe Schritt-2-Brief.md für die Auswirkungen.

Der autonome Modus bedeutet NICHT „alle Tore überspringen“. Der automatische Modus deckt nutzerpräferenzbezogene Fragen ab (TTS-Anbieter, Stimme, Farbakzent, Beat-Anzahl, Musik ja/nein, Untertitel ja/nein – bei denen der Agent anstelle des Nutzers entscheidet). Er deckt NICHT die Qualitätssicherungstore ab. Die folgenden Tore bleiben im automatischen Modus nicht überspringbar:

  • Asset-Audit (Schritt 3) – Sichtung der Kontaktbögen und Begründung von VERWENDEN/ÜBERSPRINGEN für jedes Asset
  • Pro-Beat-HTML-Lesen (Schritt 5) – Strukturierter Nachweisblock pro Beat
  • DoD-Checkliste (Schritt 6) – einschließlich Animations-Map, pro-Warnung-WCAG-Überprüfung, Audio-/Bewegungswiedergabe
  • Ehrlicher Offenlegungsabschnitt (Schritt 6) – „Was ich NICHT überprüft habe“ muss in der endgültigen Zusammenfassung erscheinen

Wenn du denkst „der automatische Modus sagt Handlungsorientierung, also überspringe ich X“ – und X ist ein Überprüfungstor, keine Präferenzfrage – dann ist dieser Gedanke falsch. Handlungsorientierung gilt für die Entscheidung, was zu bauen ist, nicht dafür, ob zu überprüfen ist.


Schritt 0: Erfassung & Verständnis der Marke

Lies: references/step-0-capture.md

Erfasse die Website und lese dann die extrahierten Daten, um die Marke und das Produkt zu verstehen – was es tut, für wen es ist, in welcher Stimme es spricht, in welcher Stimmung es lebt. Die erfassten Assets sind ein Markenwerkzeugkasten für später, nicht die Bausteine, aus denen das Video besteht.

Zeige den Anmeldestatus vor dem Brief an – führe npx hyperframes auth status aus und gib seine Ausgabe wörtlich wieder (nicht paraphrasieren oder umschreiben). Es gibt an, ob Stimme/BGM HeyGen oder lokale Engines verwenden und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPP und warte auf die Wahl des Nutzers – anmelden oder „go“/„offline“ sagen, um mit lokalen Engines fortzufahren – bevor du nach dem Brief oder irgendetwas anderem fragst. Behandle es als echten Entscheidungspunkt, nicht als beiläufige Notiz; falte die Wahl nicht in die Brief-Frage ein und schreibe keine Schlüssel in eine pro-Repo .env. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.

Tor: Site-Zusammenfassung gedruckt – strategie-zuerst (was das Produkt tut, für wen es ist, Markenstimme) vor der Asset-/Farb-/Schriftinventur; Anmeldestatus wurde angezeigt (angemeldet oder Fortsetzung offline).


Schritt 1: Markenidentität

Lies: references/step-1-design.md

Schreibe DESIGN.md – ein Marken-Spickzettel, der die visuelle Identität abdeckt: Farben, Typografie, Komponentenstile, Layout-Prinzipien. Verwende design-styles.json für genaue berechnete Werte.

Geschwindigkeitsoption: Für schnell getaktete Videos (Billboard-pro-Beat) kann DESIGN.md eine 50-zeilige Zusammenfassung von Farben + Schriftarten + Dos/Don'ts sein – kein 300-zeiliges Dokument. Der Sub-Agent-Prompt in Schritt 5 fügt Markenwerte direkt ein, daher ist die Tiefe von DESIGN.md nur für komplexe Kompositionen wichtig.

Tor: DESIGN.md existiert (beliebige Länge) mit mindestens: Farbpalette, Schriftauswahl und Dos/Don'ts.


Schritt 2: Strategie & Botschaft

Lies: references/step-2-brief.md, references/capabilities.md (scanne das Inhaltsverzeichnis – Detailabschnitte nur bei Bedarf)

Stimme dich mit dem Nutzer darüber ab, was das Video kommunizieren muss, bevor über visuelle Elemente oder Assets gesprochen wird. Analysiere die Eingabe des Nutzers – wahrscheinlich hat er/sie dir bereits den Videotyp und -stil genannt. Frage nur, was fehlt: die EINE Sache, die dieses Video sagen muss, der narrative Bogen und die Zielgruppe.

Tor: Videotyp, Dauer, Format und – entscheidend – die Botschaft und der narrative Bogen sind festgelegt. Ohne diese kann Schritt 3 kein konzeptorientiertes Storyboard schreiben.


Schritt 3: Storyboard + Drehbuch 💬

Lies: references/step-3-storyboard.md

Schreibe das Storyboard konzeptorientiert: Botschaft → narrativer Bogen → Beats, die den Bogen bedienen → Techniken pro Beat → Markenakzente am Ende. Schreibe dann das Erzählskript dazu. Präsentiere beides dem Nutzer mit einer Beat-für-Beat-Zusammenfassung. Iteriere, bis der Nutzer zustimmt.

Tor: STORYBOARD.md + SCRIPT.md existieren UND der Nutzer hat den Plan genehmigt.


Schritt 4: Sprachausgabe, Timing + Untertitel 💬

Lies: references/step-4-vo.md

Wenn Schritt 2 sagte „keine Erzählung“ – frage nach Hintergrundmusik, springe dann zu Schritt 5. Andernfalls: Frage den Nutzer, welcher TTS-Anbieter (HeyGen TTS, ElevenLabs oder Kokoro), generiere Audio, transkribiere, ordne Zeitstempel den Beats zu. Frage dann nach Untertiteln.

Tor: Entweder (a) es wurde keine Erzählung gewünscht und das Storyboard hat manuelle Beat-Timings, oder (b) narration.wav + transcript.json existieren und die Beat-Timings wurden mit echten Dauern aktualisiert.


Schritt 5: Kompositionen erstellen

Lies: Das Skill hyperframes (lade es – jede Regel zählt) Lies: references/step-5-build.md

Erstelle index.html und Kompositionen nach der im Storyboard (Schritt 3) gewählten Architektur und Taktung. Sub-Agenten führen hyperframes lint und hyperframes snapshot für jeden Beat aus, bevor sie Bericht erstatten.

Tor: Jede compositions/beat-N.html wurde vom Haupt-Agenten von oben bis unten gegen DESIGN.md und STORYBOARD.md gelesen. Die Pro-Beat-Checkliste befindet sich in step-5-build.md.


Schritt 6: Validieren & Ausliefern

Lies: references/step-6-validate.md

Lintern, validieren, erstelle Snapshots skaliert auf die Videolänge (Formel: max(beats × 3, ceil(duration_seconds / 2))) und überprüfe jeden. Behebe Probleme vor der Auslieferung. Liefere die lokale Studio-Projekt-URL aus – rendere nur auf expliziten Nutzerwunsch in MP4. Zeige die Studio-URL nur bei der Übergabe – sie ist die endgültige, stabile Vorschau; die Build-Phasen-Snapshots sind headless, zeige also keine Vorschau mitten im Build.

Liefere etwas aus, auf das du stolz bist. Frage dich vor der Übergabe: Würde ich das in den sozialen Medien mit meinem Namen veröffentlichen? Wenn nicht, behebe, was falsch ist.

Tor: npx hyperframes lint und npx hyperframes validate bestehen mit null Fehlern, und die endgültige Antwort enthält die aktive Studio-Projekt-URL.


Kurzübersicht

Videotypen

Typische Einschränkungen nach Videotyp – als Ausgangspunkt verwenden, nicht als Formel. Die Beat-Anzahl sollte sich aus dem Inhalt und der Erzählung ergeben, nicht aus einem Zielbereich.

TypTypische DauerDauer-TreiberErzählung
Social Ad (IG/TikTok)10–15sPlattform-LimitOptional
Produktdemo30–60sSkriptlängeVollständige Erz.
Feature-Ankündigung15–30sFeature-KomplexitätVollständige Erz.
Brand Reel20–45sMusiktrackOptional, Musikfokus
Launch-Teaser10–20sHook-EnergieMinimal

Die Beat-Anzahl ist absichtlich nicht in dieser Tabelle – sie sollte aus dem Storyboard kommen, nicht aus „Social Ad = 3-4 Beats“. Eine Social Ad für ein komplexes Produkt braucht vielleicht 5 gut getaktete Beats. Ein Brand Reel mit einer starken visuellen These braucht vielleicht 3.

Format

  • Querformat: 1920×1080 (Standard)
  • Hochformat: 1080×1920 (Instagram Stories, TikTok)
  • Quadratisch: 1080×1080 (Instagram-Feed)

Referenzdateien

DateiWann lesen
step-0-capture.mdSchritt 0 – Erfassen, Marke und Produkt verstehen, strategieorientierte Website-Zusammenfassung schreiben
step-1-design.mdSchritt 1 – DESIGN.md Marken-Spickzettel schreiben (5 Abschnitte, 250-350 Zeilen; 50-zeiliger Schnellpfad für Billboard-artige Social Ads)
step-2-brief.mdSchritt 2 – Abstimmung von Botschaft, narrativem Bogen, Zielgruppe mit dem Nutzer
capabilities.mdSchritte 2 & 5 – Vollständiges Inventar der HyperFrames-Fähigkeiten (24 Abschnitte). TOC während des Briefs scannen, in bestimmte Abschnitte während des Builds eintauchen
step-3-storyboard.mdSchritt 3 – Storyboard + Drehbuch (kombiniert) mit Nutzer-Review-Tor
step-4-vo.mdSchritt 4 – TTS-Anbieterauswahl, Generierung, Timing
step-5-build.mdSchritt 5 – index.html + Kompositionen erstellen
step-6-validate.mdSchritt 6 – Lintern, validieren, Snapshots (skaliert auf Videolänge), Vorschau
techniques.mdSchritte 3 & 5 – 13 primitive Animationstechniken mit Code-Mustern (anpassen, nicht kopieren-einfügen)
html-in-canvas-patterns.mdSchritt 5 – Vollständige Code-Muster für HTML-in-Canvas-Effekte (lebt im Skill hyperframes)

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

1345AbhishekKumar/starter-supabase

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-supabase

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-supabase

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-supabase

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

1345AbhishekKumar/starter-supabase

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1345AbhishekKumar/starter-supabase

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1345AbhishekKumar/starter-supabase

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-supabase

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-supabase

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-supabase

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-supabase

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

Verwandte Skills