Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Erstelle einen neuen HyperFrames Registry-Block (Caption-Stil, VFX-Block, Übergang, Lower Third) oder eine Komponente (Texteffekt, Overlay, Snippet) und reiche ihn als Upstream-PR im hyperframes-Repository ein. Nur verwenden, wenn der Benutzer zum öffentlichen Katalog beitragen möchte – für die lokale Erstellung von Captions/Übergängen innerhalb eines Projekts das 'hyperframes'-Skill verwenden, für die Installation bestehender Registry-Elemente das 'hyperframes-registry'-Skill.

Was ist Tony-Claude-Code-Skills?

Dieses Skill führt den Benutzer durch den gesamten Prozess, einen neuen Registry-Block oder eine Komponente für HyperFrames zu erstellen und als Pull Request einzureichen – von der ersten Idee bis zum fertigen PR. Es unterstützt zwei Arten von Einträgen: Blöcke (eigenständige Kompositionen mit festen Abmessungen und Dauer, z.B. Caption-Stile oder VFX-Effekte) und Komponenten (wiederverwendbare Snippets ohne feste Abmessungen, z.B. CSS-Effekte oder Textbehandlungen). Der Workflow umfasst die Schritte Klärung, Gerüstbau, Erstellung, Validierung, Vorschau und Einreichung. Dabei werden strikte Regeln für Captions (Mindestschriftgröße, Karaoke-Timings, Hard-Kill) und VFX-Blöcke (Three.js mit GSAP-Integration) durchgesetzt. Nach der Validierung mit `hyperframes lint` und `hyperframes validate` erzeugt das Skill eine Vorschau und eine Katalogseite, bevor der PR erstellt wird.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-contribute-catalog

In Ihrer bevorzugten KI fragen

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

Dokumentation

Zum HyperFrames Registry beitragen

Führe den Benutzer von der Idee bis zum gemergten PR für einen neuen Registry-Block oder eine Komponente.

Arbeitsablauf

1. Klären → 2. Gerüst bauen → 3. Erstellen → 4. Validieren → 5. Vorschau → 6. Einreichen

Schritt 1: Klären

Frage, was sie bauen möchten. Das Registry hat zwei Arten von Einträgen:

  • Block (registry/blocks/, Typ hyperframes:block) – eine vollständige eigenständige Komposition mit festen Abmessungen und Dauer. Caption-Stile, VFX-Effekte, Titelcards, Lower Thirds.
  • Komponente (registry/components/, Typ hyperframes:component) – ein wiederverwendbares Snippet ohne feste Abmessungen oder Dauer. CSS-Effekte, Textbehandlungen, Overlays, die sich jeder Kompositionsgröße anpassen.

Frage dann:

  • Ein-Satz-Beschreibung des Effekts
  • Visuelle Referenz (URL, Screenshot oder Beschreibung)
  • Wer verwendet dies und wann?

Schritt 2: Gerüst bauen

Erstelle die Registry-Struktur:

Für Blöcke:

registry/blocks/{block-name}/
  {block-name}.html
  registry-item.json

Für Komponenten:

registry/components/{component-name}/
  {component-name}.html
  registry-item.json

Namenskonvention:

ElementnameID-PräfixBeispiel-IDs
cap-hormozihzhz-cg-0, hz-cw-3
cap-typewritertwtw-cg-0, tw-ch-0-5
vfx-chromevcvc-canvas

Verwende ein 2-3-Buchstaben-Präfix. ALLE Element-IDs müssen dieses Präfix verwenden, um Kollisionen in Unterkompositionen zu vermeiden.

registry-item.json für Blöcke:

{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{block-name}",
  "type": "hyperframes:block",
  "title": "{Menschlicher Titel}",
  "description": "{ein Satz}",
  "dimensions": { "width": 1920, "height": 1080 }, // anpassen: 1080x1920 für Hochformat/Soziales
  "duration": 10, // für deine Komposition anpassen
  "tags": ["{Kategorie}", "{Unterkategorie}"],
  "files": [
    {
      "path": "{block-name}.html",
      "target": "compositions/{block-name}.html",
      "type": "hyperframes:composition"
    }
  ]
}

registry-item.json für Komponenten (keine dimensions oder duration):

{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "{component-name}",
  "type": "hyperframes:component",
  "title": "{Menschlicher Titel}",
  "description": "{ein Satz}",
  "tags": ["{Kategorie}"],
  "files": [
    {
      "path": "{component-name}.html",
      "target": "compositions/components/{component-name}.html",
      "type": "hyperframes:snippet"
    }
  ]
}

Schritt 3: Erstellen

Wende die richtige Vorlage basierend auf dem Typ an. Siehe templates.md für Copy-Paste-Starter.

Caption-Blöcke

Unverhandelbare Caption-Regeln:

  • Schriftart: Mindestens 96px für proportionale Schriftarten. 64-72px akzeptabel für Monospace (breitere Zeichen benötigen weniger Größe).
  • Lesbarkeit: -webkit-text-stroke: 2-3px ODER mehrschichtiges text-shadow
  • Überlauf: Rufe window.__hyperframes.fitTextFontSize() für jede Gruppe auf
  • Karaoke: Hebe das aktive Wort mittels tl.to(wordEl, { color/scale }, WORDS[wi].start) hervor
  • Hard Kill: tl.set(groupEl, { opacity: 0, visibility: "hidden" }, g.end) bei JEDER Gruppe
  • Verwende niemals tl.from(el, { opacity: 0 }) an derselben Position wie tl.set(el, { opacity: 1 }) – das from überschreibt das set. Verwende stattdessen tl.to.

Animation pro Zeichen (Schreibmaschine, Scramble):

  • Wickele jedes Zeichen in ein <span> mit der ID {prefix}-ch-{group}-{char}
  • Staffelung mittels tl.set zu berechneten Intervallen basierend auf Wort-Zeitstempeln
  • Cursor/dekorative Elemente: Verwende tl.set in Intervallen – NICHT CSS-Animation (nicht suchbar)

Positionierungsvarianten:

  • Zentriert: display: flex; align-items: center; justify-content: center;
  • Lower Third: position: absolute; bottom: 100px; left: 0; width: 100%; text-align: center;
  • Linksbündig: position: absolute; bottom: 100px; left: 120px; text-align: left;

VFX-Blöcke (Three.js)

  • Verwende [email protected] vom CDN (globales Skript)
  • tl.eventCallback("onUpdate", renderScene); renderScene(); – KEIN requestAnimationFrame
  • State-Proxy-Muster: GSAP animiert einfaches JS-Objekt, Render-Funktion liest es
  • Seeded PRNG (mulberry32) für Zufälligkeit

Alle Typen

  • data-composition-id MUSS mit window.__timelines["id"] übereinstimmen
  • Alle Element-IDs mit Block-Abkürzung versehen
  • gsap.timeline({ paused: true }) – immer pausiert
  • Kein Math.random(), kein Date.now()

Schritt 4: Validieren

hyperframes lint                    # 0 Fehler erforderlich
hyperframes validate --no-contrast  # 0 Konsolenfehler erforderlich

Schritt 5: Vorschau

# Vorschauvideo rendern
hyperframes render -o preview.mp4

# Schnappschuss für visuelle QA
hyperframes snapshot --at "1.0,3.0,5.0,7.0"

# Auf hyperframes.dev zur Überprüfung veröffentlichen
npx hyperframes publish

Katalogvorschaubild – Die Katalogkarte verwendet ein PNG unter docs/images/catalog/{art}/{name}.png (wobei {art} blocks oder components ist). Generiere es aus einem Schnappschuss, dann:

  • HeyGen-interne Mitwirkende: Führe scripts/upload-docs-images.sh aus (benötigt AWS-Profil engineering-767398024897)
  • Externe Mitwirkende: Füge das Vorschau-MP4 an deine PR-Beschreibung an. Ein Maintainer generiert und lädt das Katalogbild vor dem Mergen hoch.

Schritt 6: Einreichen

Alle Schritte sind erforderlich. Das Fehlen eines einzigen erzeugt einen defekten Katalogeintrag.

{art} ist blocks oder components, je nachdem, was du in Schritt 1 gebaut hast.

# 1. Branch erstellen
git checkout -b feat/registry-{name}

# 2. HTML formatieren
npx oxfmt registry/{art}/{name}/*.html

# 3. registry/registry.json aktualisieren – Eintrag zum "items"-Array hinzufügen:
#    { "name": "{name}", "type": "hyperframes:block" }  (oder "hyperframes:component")

# 4. Katalog-Dokumentationsseite generieren
npx tsx scripts/generate-catalog-pages.ts

# 5. Auf hyperframes.dev veröffentlichen, damit Reviewer eine Vorschau sehen können
npx hyperframes publish

# 6. Alles stagen
git add registry/{art}/{name}/ registry/registry.json docs/catalog/

# 7. Commit
.git commit -m "feat(registry): {name} — {ein Satz}"

# 8. Pushen und PR mit hyperframes.dev-Link öffnen
git push origin feat/registry-{name}
gh pr create --title "feat(registry): {name}" --body "preview: {hyperframes.dev-url}"

Wenn du kein GitHub-Konto hast: Du brauchst eines, um einen PR zu öffnen. Melde dich unter https://github.com/signup an und führe dann gh auth login aus.

Qualitätskontrolle

  • hyperframes lint → 0 Fehler
  • hyperframes validate → 0 Konsolenfehler
  • npx oxfmt --check erfolgreich
  • registry/registry.json mit neuem Eintrag aktualisiert
  • scripts/generate-catalog-pages.ts ausgeführt (Dokumentationsseite generiert)
  • npx hyperframes publish ausgeführt (Projekt-URL beansprucht)
  • Vorschau-MP4 an PR angehängt (extern) oder Katalog-PNG hochgeladen (intern)
  • Alle IDs eindeutig und mit Präfix versehen

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

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

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

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