Communitygithub.com

Biznomad/agent-skills

HyperFrames CLI Entwicklungszyklus — `npx hyperframes` zum Scaffolding (init), Validierung (lint, inspect), Vorschau, Rendern und Umgebungs-Fehlerbehebung (doctor, browser, info, upgrade). Verwende diesen Skill, wenn du diese Befehle ausführst oder die HyperFrames Build-/Render-Umgebung analysierst. Für Asset-Vorverarbeitungsbefehle (`tts`, `transcribe`, `remove-background`) verwende stattdessen den `hyperframes-media` Skill.

Was ist agent-skills?

Dieser Skill definiert den vollständigen CLI-Workflow für HyperFrames, ein Tool zur Erstellung programmatischer Videokompositionen. Er führt Entwickler und KI-Agenten durch die sechs Hauptschritte: Scaffolding eines neuen Projekts mit `npx hyperframes init` (inklusive interaktivem Assistenten, Beispielvorlagen und Tailwind-Support), Schreiben der HTML-Komposition, Linting mit `npx hyperframes lint` (prüft auf fehlende IDs, überlappende Tracks), visuelles Inspizieren mit `npx hyperframes inspect` (erkennt überlaufenden Text und Layout-Fehler in einem Headless-Chrome), Vorschau mit Live-Reload (`npx hyperframes preview`) und finales Rendern mit verschiedenen Qualitäts- und Ausgabeoptionen. Der Skill enthält detaillierte Referenzen zu allen CLI-Flags, Umgebungsvariablen (Node.js >=22, FFmpeg) und Fehlerbehebungsbefehle wie `doctor`, `browser` und `upgrade`. Plattformen: HyperFrames CLI. Er ist besonders wertvoll für Entwickler, die Video-Workflows automatisieren oder in CI/CD-Pipelines integrieren möchten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/hyperframes-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames CLI

Alles läuft über npx hyperframes. Erfordert Node.js >= 22 und FFmpeg.

Workflow

  1. Scaffold — npx hyperframes init my-video
  2. Schreiben — HTML-Komposition verfassen (siehe den hyperframes Skill)
  3. Lint — npx hyperframes lint
  4. Visuelles Inspizieren — npx hyperframes inspect
  5. Vorschau — npx hyperframes preview
  6. Rendern — npx hyperframes render

Lint und Inspect vor der Vorschau durchführen. lint erkennt fehlende data-composition-id, überlappende Tracks und nicht registrierte Timelines. inspect öffnet die gerenderte Komposition in Headless Chrome, durchsucht die Timeline und meldet Text, der aus Sprechblasen/Containern oder der Leinwand herausragt.

Scaffolding

npx hyperframes init my-video                        # interaktiver Assistent
npx hyperframes init my-video --example warm-grain   # ein Beispiel auswählen
npx hyperframes init my-video --video clip.mp4        # mit Videodatei
npx hyperframes init my-video --audio track.mp3       # mit Audiodatei
npx hyperframes init my-video --example blank --tailwind # mit Tailwind v4 Browser-Laufzeit
npx hyperframes init my-video --non-interactive       # Eingabeaufforderungen überspringen (CI/Agenten)

Vorlagen: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init erstellt die richtige Dateistruktur, kopiert Medien, transkribiert Audio mit Whisper und installiert KI-Coding-Skills. Verwende es anstatt Dateien von Hand zu erstellen.

Bei Verwendung von --tailwind den tailwind Skill aufrufen, bevor Klassen oder Theme-Tokens bearbeitet werden. Das Scaffold verwendet Tailwind v4.2 über die Browser-Laufzeit, nicht das Tailwind v3 Setup von Studio.

Linting

npx hyperframes lint                  # aktuelles Verzeichnis
npx hyperframes lint ./my-project     # bestimmtes Projekt
npx hyperframes lint --verbose        # Info-Level-Funde
npx hyperframes lint --json           # maschinenlesbar

Lintet index.html und alle Dateien in compositions/. Meldet Fehler (müssen behoben werden), Warnungen (sollten behoben werden) und Infos (mit --verbose).

Visuelles Inspizieren

npx hyperframes inspect                 # gerendertes Layout über die Timeline inspizieren
npx hyperframes inspect ./my-project    # bestimmtes Projekt
npx hyperframes inspect --json          # agentenlesbare Funde
npx hyperframes inspect --samples 15    # dichterer Timeline-Durchlauf
npx hyperframes inspect --at 1.5,4,7.25 # explizite Hero-Frame-Zeitstempel

Nach lint und validate verwenden, besonders bei Kompositionen mit Sprechblasen, Karten, Untertiteln oder enger Typografie. Es meldet:

  • Text, der außerhalb des nächsten visuellen Containers oder der Sprechblase verläuft
  • Text, der durch die eigene feste Breite/Höhe abgeschnitten wird
  • Text, der außerhalb der Kompositionsleinwand verläuft
  • Kindelemente, die aus Clip-Containern entweichen

Fehler sollten vor dem Rendern behoben werden. Warnungen werden zur Agentenprüfung angezeigt; füge --strict hinzu, um auch bei Warnungen abzubrechen. Wiederholte statische Probleme werden standardmäßig zusammengefasst, sodass die JSON-Ausgabe für LLM-Kontextfenster kompakt bleibt. Wenn ein Überlauf für eine Ein-/Ausgangsanimation beabsichtigt ist, markiere das Element oder den Vorfahren mit data-layout-allow-overflow. Wenn ein dekoratives Element nie geprüft werden soll, markiere es mit data-layout-ignore.

npx hyperframes layout bleibt als Kompatibilitätsalias für denselben visuellen Inspektionsdurchlauf verfügbar.

Vorschau

npx hyperframes preview                   # aktuelles Verzeichnis bereitstellen
npx hyperframes preview --port 4567       # benutzerdefinierter Port (Standard 3002)

Hot-Reload bei Dateiänderungen. Öffnet das Studio automatisch im Browser.

Wenn du ein Projekt an den Benutzer zurückgibst, verwende die Studio-Projekt-URL, nicht den Quell-index.html-Pfad:

http://localhost:<port>/#project/<project-name>

Verwende den tatsächlichen Port aus der Vorschauausgabe und den Projektverzeichnisnamen. Beispiel: Nach npx hyperframes preview --port 3017 in codex-openai-video melde http://localhost:3017/#project/codex-openai-video.

Behandle index.html nur als Quellcode-Kontext. Es ist in Ordnung, es als Implementierungsdatei zu verlinken, aber bezeichne es nicht als Projekt oder Vorschauoberfläche.

Rendern

npx hyperframes render                                # Standard MP4
npx hyperframes render --output final.mp4             # benannte Ausgabe
npx hyperframes render --quality draft                # schnelle Iteration
npx hyperframes render --fps 60 --quality high        # finale Auslieferung
npx hyperframes render --format webm                  # transparentes WebM
npx hyperframes render --docker                       # byte-identisch
FlagOptionenStandardAnmerkungen
--outputPfadrenders/name_timestamp.mp4Ausgabepfad
--fps24, 30, 603060fps verdoppelt Renderzeit
--qualitydraft, standard, highstandarddraft zum Iterieren
--formatmp4, webmmp4WebM unterstützt Transparenz
--workers1-8 oder autoautoJeder startet Chrome
--dockerFlagausReproduzierbare Ausgabe
--gpuFlagausGPU-beschleunigte Codierung
--strictFlagausBei Lint-Fehlern abbrechen
--strict-allFlagausBei Fehlern UND Warnungen abbrechen
--variablesJSON-Objekt—Überschreibt in data-composition-variables deklarierte Variablen
--variables-filePfad—JSON-Datei mit Variablenwerten (Alternative zu --variables)
--strict-variablesFlagausRendern bei nicht deklarierten Schlüsseln oder Typfehlern abbrechen

Qualitätsrichtlinie: draft beim Iterieren, standard zur Überprüfung, high für die finale Auslieferung.

Parametrisierte Renderings: Die Komposition deklariert ihre Variablen auf dem <html>-Root mit data-composition-variables — einem JSON-Array von Deklarationen ({id, type, label, default} pro Eintrag), das das Schema definiert. Skripte lesen die aufgelösten Werte über window.__hyperframes.getVariables(). Die CLI --variables '{"title":"Q4 Report"}' ist ein JSON-Objekt, das nach id indiziert ist und diese deklarierten Standardwerte für einen Render-Durchlauf überschreibt; fehlende Schlüssel fallen durch, sodass dieselbe Komposition unverändert in der Dev-Vorschau und in der Produktion läuft. (Sub-Comp-Hosts können auch pro Instanz mit data-variable-values überschreiben – gleiche Objektform, begrenzt auf eine Einbindung der Sub-Komposition. Siehe den hyperframes Skill für das vollständige Muster.)

Asset-Vorverarbeitung

npx hyperframes tts, transcribe und remove-background produzieren Assets (Erzähl-Audio, wortgenaue Transkripte, transparentes Video), die in eine Komposition eingefügt werden. Jedes lädt beim ersten Start sein eigenes Modell herunter. Für Sprachauswahl, Whisper-Modellregeln (der .en-übersetzt-nicht-Englisch-Haken), Ausgabeformatwahl (VP9 Alpha WebM vs ProRes) und die TTS → Transkription → Untertitel-Kette den hyperframes-media Skill aufrufen.

Fehlerbehebung

npx hyperframes doctor       # Umgebung prüfen (Chrome, FFmpeg, Node, Speicher)
npx hyperframes browser      # gebündeltes Chrome verwalten
npx hyperframes info         # Versions- und Umgebungsdetails
npx hyperframes upgrade      # nach Updates suchen

doctor zuerst ausführen, wenn das Rendern fehlschlägt. Häufige Probleme: Fehlendes FFmpeg, fehlendes Chrome, wenig Speicher.

Sonstiges

npx hyperframes compositions   # Kompositionen im Projekt auflisten
npx hyperframes docs           # Dokumentation öffnen
npx hyperframes benchmark .    # Render-Leistung benchmarken

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

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, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Verwandte Skills