Communitygithub.com

1345AbhishekKumar/starter-nextjs

Erfasse eine allgemeine Website/URL und verwandle sie in ein HyperFrames-Video (Site-Tour, Showcase oder Social Clip aus den eigenen visuellen Inhalten der Seite).

Was ist starter-nextjs?

Dieses Skill wandelt eine beliebige Website (z. B. Portfolio, Blog, Landing Page) in ein professionelles HyperFrames-Video um – ideal für Site-Touren, Showcases oder Social-Media-Clips. Es nutzt Headless Chrome für Screenshots und Marken-Assets der Seite. Das Skill ist nicht geeignet für Produkt-Launches oder Promo-Videos (dafür gibt es `/product-launch-video`), themenbasierte Erklärvideos ohne Website (`/faceless-explainer`), GitHub-PR-Videos (`/pr-to-video`) oder das Hinzufügen von Untertiteln zu bestehenden Videos (`/embedded-captions`). Der Workflow umfasst 7 Schritte: Erfassung und Markenverständnis, Markenidentität, Strategie, Storyboard & Skript, Sprachausgabe & Timing, Erstellung der Kompositionen sowie Validierung und Auslieferung. Der Agent arbeitet kollaborativ mit Benutzerentscheidungen an bestimmten Toren, kann aber auch autonom Benutzereinstellungen wie TTS-Anbieter oder Musikauswahl übernehmen. Wichtige Qualitätstore wie Asset-Prüfung, HTML-Kontrolle pro Beat und eine ehrliche Offenlegung nicht verifizierter Punkte bleiben auch im autonomen Modus obligatorisch.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/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-/Bildquellen besorgt werden, rufe /media-use auf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Führe zuerst --adopt aus, 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 / aus einer allgemeinen Seite. Wenn der Nutzer tatsächlich ein Produkt vermarktet / launched / bewirbt (selbst von dieser URL, selbst „Promo für unsere Seite“) → /product-launch-video. Ein Themen-Erklärvideo ohne Seite → /faceless-explainer; ein GitHub PR → /pr-to-video; Nachbearbeitung / Neufärbung / Neuanordnung einer bestehenden Videodatei → außerhalb des Rahmens. Bei unklarem „Video erstellen“ oder Unsicherheit Launch-vs-allgemeine-Seite? Lies zuerst /hyperframes (vollständige Routingtabelle + § Was HyperFrames nicht kann).

Nutzer sagen Dinge wie:

  • „Mach aus dieser Website einen 15-Sekunden-Social-Clip für Instagram“
  • „Erstelle eine 30-Sekunden-Site-Tour / ein Showcase von https://...“
  • „Erfasse unsere Startseite und baue ein Video aus ihren eigenen visuellen Inhalten“

Der Workflow hat 7 Schritte. Jeder erzeugt ein Artefakt, das den nächsten Schritt öffnet. Standardmäßig ist er kollaborativ – mit 💬 markierte Tore stoppen und fragen den Benutzer. Wenn der Benutzer den autonomen Modus signalisiert („entscheide für mich“, „überrasche mich“), werden 💬 Benutzereinstellungstore übersprungen; siehe step-2-brief.md für die Auswirkungen.

Der autonome Modus bedeutet NICHT „alle Tore überspringen.“ Der Auto-Modus deckt Benutzereinstellungsfragen ab (TTS-Anbieter, Stimme, Farbbetonung, Beat-Anzahl, Musik ja/nein, Untertitel ja/nein – wo der Agent im Namen des Benutzers entscheidet). Er deckt NICHT die Qualitätsprüfungstore ab. Die folgenden bleiben im Auto-Modus nicht überspringbar:

  • Asset-Prüfung (Schritt 3) – Betrachten von Kontaktblättern und Begründung von VERWENDEN/ÜBERSPRINGEN für jedes Asset
  • Pro-Beat HTML-Lesen (Schritt 5) – strukturierter Evidenzblock pro Beat
  • DoD-Checkliste (Schritt 6) – einschließlich Animationskarte, WCAG-Überprüfung pro Warnung, Audio/Bewegungswiedergabe
  • Ehrlicher Offenlegungsabschnitt (Schritt 6) – „Was ich NICHT verifiziert habe“ muss in deiner endgültigen Zusammenfassung erscheinen

Wenn du denkst „der Auto-Modus sagt Voreingenommenheit fürs Handeln, also überspringe ich X“ – und X ist ein Verifikationstor, keine Präferenzfrage – dann ist diese Überlegung falsch. Voreingenommenheit fürs Handeln gilt für die Entscheidung, was gebaut wird, nicht für die Entscheidung, ob verifiziert wird.


Schritt 0: Erfassen & Verstehen der Marke

Lies: references/step-0-capture.md

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

Zeige den Anmeldestatus vor dem Brief – führe npx hyperframes auth status aus und gib seine Ausgabe wörtlich wieder (paraphrasiere oder schreibe sie nicht um). Es meldet, ob Stimme/BGM HeyGen oder lokale Engines verwendet und, wenn nicht angemeldet, wie man sich anmeldet. Wenn nicht angemeldet, STOPP und warte auf die Wahl des Benutzers – 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 ein pro-Repo .env. (Im autonomen Modus notiere den Status und fahre offline fort.) Siehe ../hyperframes-media → Preflight für die kanonische Anleitung.

Tor: Zusammenfassung der Seite gedruckt – zuerst die Strategie (was das Produkt tut, für wen es ist, Markenstimme) vor dem Asset-/Farb-/Schriftinventar; Anmeldestatus wurde gezeigt (angemeldet oder offline fortgesetzt).


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 exakte 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 – tiefgehende Abschnitte nur bei Bedarf)

Stimme mit dem Benutzer ab, was das Video kommunizieren muss, bevor du über visuelle Elemente oder Assets sprichst. Analysiere die Eingabe des Benutzers – er hat dir wahrscheinlich bereits den Videotyp und -stil genannt. Frage nur nach dem, was fehlt: das EINE, was 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 konzeptbasiertes Storyboard schreiben.


Schritt 3: Storyboard + Skript 💬

Lies: references/step-3-storyboard.md

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

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


Schritt 4: Sprachausgabe, Timing + Untertitel 💬

Lies: references/step-4-vo.md

Wenn Schritt 2 keine Erzählung vorsieht – frage nach Hintergrundmusik, springe dann zu Schritt 5. Andernfalls: Frage den Benutzer nach dem 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-Zeitangaben, oder (b) narration.wav + transcript.json existieren und Beat-Zeitangaben wurden mit echten Dauern aktualisiert.


Schritt 5: Kompositionen erstellen

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

Erstelle index.html und Kompositionen gemäß der in Schritt 3 gewählten Architektur und Taktung. Sub-Agenten führen hyperframes lint und hyperframes snapshot für jeden Beat aus, bevor sie zurückmelden.

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

Linte, validiere, mache Screenshots skaliert auf die Videolänge (Formel: max(Beats × 3, ceil(Dauer_Sekunden / 2))) und überprüfe jeden einzelnen. Behebe Probleme vor der Auslieferung. Liefere die lokale Studio-Projekt-URL – rendere nur auf expliziten Benutzerwunsch in MP4. Gib diese Studio-URL nur bei der Übergabe aus – es ist die endgültige, stabile Vorschau; die Build-Phasen-Screenshots sind Headless, also zeige keine Vorschau während des Baus.

Liefere etwas, auf das du stolz bist. Frage dich vor der Übergabe: Würde ich das in sozialen Medien mit meinem Namen posten? 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.


Kurzreferenz

Videotypen

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

TypTypische DauerTreiber der DauerErzählung
Social Ad (IG/TikTok)10–15sPlattformlimitOptional
Produktdemo30–60sSkriptlängeVollständig
Feature-Announcement15–30sFeature-KomplexitätVollständig
Brand-Reel20–45sMusiktitelOptional, 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 getimte Beats. Ein Brand-Reel mit einer starken visuellen These braucht vielleicht 3.

Format

  • Querformat: 1920x1080 (Standard)
  • Hochformat: 1080x1920 (Instagram Stories, TikTok)
  • Quadratisch: 1080x1080 (Instagram Feed)

Referenzdateien

DateiWann lesen
step-0-capture.mdSchritt 0 – erfassen, Marke und Produkt verstehen, zuerst-strategische Zusammenfassung schreiben
step-1-design.mdSchritt 1 – DESIGN.md Marken-Spickzettel schreiben (5 Abschnitte, 250-350 Zeilen; 50-zeiliger Schnellpfad für Billboard-Style-Social Ads)
step-2-brief.mdSchritt 2 – Botschaft, narrativen Bogen, Zielgruppe mit Benutzer abstimmen
capabilities.mdSchritte 2 & 5 – vollständiges Inventar der HyperFrames-Fähigkeiten (24 Abschnitte). Scanne das Inhaltsverzeichnis während des Briefs, lies tiefgehend während des Baus
step-3-storyboard.mdSchritt 3 – Storyboard + Skript (kombiniert) mit Benutzer-Review-Tor
step-4-vo.mdSchritt 4 – TTS-Anbieterwahl, Generierung, Timing
step-5-build.mdSchritt 5 – index.html + Kompositionen erstellen
step-6-validate.mdSchritt 6 – linten, validieren, Screenshots (skaliert auf Videolänge), Vorschau
techniques.mdSchritte 3 & 5 – 13 primitive Animationstechniken mit Code-Mustern (adaptieren, nicht kopieren)
html-in-canvas-patterns.mdSchritt 5 – vollständige Code-Muster für HTML-in-Canvas-Effekte (lebt im hyperframes Skill)

Individual skills in this repo

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

1345AbhishekKumar/starter-nextjs

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

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

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

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

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

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

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

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

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

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

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

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

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