Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI-Entwicklungsablauf – `npx hyperframes` für Gerüstbau (init), Validierung (lint, inspect), Vorschau, Rendering und Fehlerbehebung der Umgebung (doctor, browser, info, upgrade). Verwenden Sie dieses Skill beim Ausführen dieser Befehle oder bei der Fehlerbehebung der HyperFrames-Build-/Render-Umgebung. Für Asset-Vorverarbeitungsbefehle (`tts`, `transcribe`, `remove-background`) rufen Sie stattdessen das Skill `hyperframes-media` auf.

Was ist Tony-Claude-Code-Skills?

Dieses Skill für KI-Agenten wie Claude Code, Cursor oder Codex automatisiert den vollständigen Entwicklungsablauf von HyperFrames-Kompositionen über die CLI. Es skaffoldet Projekte mit `init` (inklusive Vorlagen, Medienimport und Whisper-Transkription), validiert sie mit `lint` und `inspect` (erkennt fehlende `data-composition-id`, überlappende Spuren, Textüberläufe in Sprechblasen oder am Canvas), startet einen Vorschau-Server mit Hot-Reload und rendert finale MP4- oder WebM-Videos mit anpassbaren Parametern wie FPS, Qualität und Auflösung. Das Skill unterstützt parametrisierte Renderings über `--variables` und bietet umfassende Befehle zur Fehlerbehebung (`doctor`, `browser`, `info`, `upgrade`). Es läuft auf Node.js >= 22 und FFmpeg und ist für alle Plattformen geeignet, die `npx` ausführen können – einschließlich CI/CD-Pipelines und Agenten-Workflows.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-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.

Arbeitsablauf

  1. Gerüstbau — npx hyperframes init my-video
  2. Schreiben — HTML-Komposition verfassen (siehe Skill hyperframes)
  3. Linten — npx hyperframes lint
  4. Visuelle Inspektion — npx hyperframes inspect
  5. Vorschau — npx hyperframes preview
  6. Rendern — npx hyperframes render

Linten und inspizieren vor der Vorschau. lint erkennt fehlende data-composition-id, überlappende Spuren und nicht registrierte Zeitlinien. inspect öffnet die gerenderte Komposition in einem kopflosen Chrome, durchläuft die Zeitlinie und meldet Text, der aus Blasen/Containern oder vom Canvas überläuft.

Gerüstbau

npx hyperframes init my-video                        # interaktiver Assistent
npx hyperframes init my-video --example warm-grain   # 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-Runtime
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. Verwenden Sie es, anstatt Dateien manuell zu erstellen.

Bei Verwendung von --tailwind rufen Sie das Skill tailwind auf, bevor Sie Klassen oder Theme-Tokens bearbeiten. Das Gerüst verwendet Tailwind v4.2 über die Browser-Runtime, 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-Ergebnisse
npx hyperframes lint --json           # maschinenlesbar

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

Visuelle Inspektion

npx hyperframes inspect                 # gerendertes Layout über die Zeitlinie inspizieren
npx hyperframes inspect ./my-project    # bestimmtes Projekt
npx hyperframes inspect --json          # agentenlesbare Ergebnisse
npx hyperframes inspect --samples 15    # dichterer Zeitliniendurchlauf
npx hyperframes inspect --at 1.5,4,7.25 # explizite Heldenbild-Zeitstempel

Verwenden Sie dies nach lint und validate, insbesondere bei Kompositionen mit Sprechblasen, Karten, Untertiteln oder enger Typografie. Es meldet:

  • Text, der sich außerhalb des nächsten visuellen Containers oder der Blase erstreckt
  • Text, der durch seine eigene feste Breite/Höhe abgeschnitten wird
  • Text, der sich außerhalb des Kompositions-Canvas erstreckt
  • Kinder, die aus Begrenzungscontainern entkommen

Fehler sollten vor dem Rendern behoben werden. Warnungen werden zur Agentenüberprüfung angezeigt; fügen Sie --strict hinzu, um auch bei Warnungen fehlzuschlagen. Wiederholte statische Probleme werden standardmäßig zusammengefasst, damit die JSON-Ausgabe für LLM-Kontextfenster kompakt bleibt. Wenn ein Überlauf für eine Ein-/Ausgangsanimation beabsichtigt ist, markieren Sie das Element oder den Vorfahren mit data-layout-allow-overflow. Wenn ein dekoratives Element nie auditiert werden soll, markieren Sie 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 Sie ein Projekt an den Benutzer zurückgeben, verwenden Sie die Studio-Projekt-URL, nicht den Quellpfad index.html:

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

Verwenden Sie den tatsächlichen Port aus der Vorschauausgabe und den Projektverzeichnisnamen. Zum Beispiel, geben Sie nach npx hyperframes preview --port 3017 in codex-openai-video http://localhost:3017/#project/codex-openai-video an.

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

Rendering

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 die Renderzeit
--qualitydraft, standard, highstandarddraft zum Iterieren
--formatmp4, webmmp4WebM unterstützt Transparenz
--workers1-8 oder autoautoJeder startet Chrome
--dockerFlagausReproduzierbare Ausgabe
--gpuFlagausGPU-beschleunigte Kodierung
--strictFlagausFehlschlagen bei Lint-Fehlern
--strict-allFlagausFehlschlagen bei Fehlern UND Warnungen
--variablesJSON-Objekt—Überschreibt in data-composition-variables deklarierte Variablenwerte
--variables-filePfad—JSON-Datei mit Variablenwerten (Alternative zu --variables)
--strict-variablesFlagausFehlschlagen des Renderings bei nicht deklarierten Schlüsseln oder Typkonflikten in --variables

Qualitätshinweis: draft während des Iterierens, 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 im Inneren lesen die aufgelösten Werte über window.__hyperframes.getVariables(). Die CLI --variables '{"title":"Q4 Bericht"}' ist ein JSON-Objekt, das nach id verschlüsselt ist und diese deklarierten Standardwerte für ein Rendering überschreibt; fehlende Schlüssel greifen durch, sodass dieselbe Komposition unverändert in der Entwicklungsvorschau 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 das Skill hyperframes für das vollständige Muster.)

Asset-Vorverarbeitung

npx hyperframes tts, transcribe und remove-background erzeugen Assets (Erzähl-Audio, wortgenaue Transkripte, transparentes Video), die in eine Komposition eingefügt werden. Jedes lädt beim ersten Durchlauf sein eigenes Modell herunter. Für Stimmauswahl, Whisper-Modellregeln (die .en-übersetzt-nicht-Englisch-Falle), Ausgabeformatwahl (VP9 Alpha WebM vs. ProRes) und die TTS → transcribe → captions-Kette rufen Sie das Skill hyperframes-media auf.

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

Führen Sie zuerst doctor aus, 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 .    # Renderleistung benchmarken

Individual skills in this repo

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

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

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

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-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.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-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.

Verwandte Skills