Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Boucle de développement CLI HyperFrames — `npx hyperframes` pour le scaffolding (init), la validation (lint, inspect), l'aperçu, le rendu et le diagnostic de l'environnement (doctor, browser, info, upgrade). Utilisez cette compétence lorsque vous exécutez l'une de ces commandes ou que vous résolvez des problèmes liés à l'environnement de construction/rendu HyperFrames. Pour les commandes de prétraitement des ressources (`tts`, `transcribe`, `remove-background`), utilisez plutôt la compétence `hyperframes-media`.

Qu'est-ce que Tony-Claude-Code-Skills ?

Cette compétence est conçue pour piloter le cycle de développement complet des vidéos HyperFrames via l'interface en ligne de commande. Elle automatise la création de projets avec `init`, la validation du code HTML des compositions avec `lint` et `inspect`, l'aperçu interactif avec rechargement à chaud via `preview`, et le rendu final en MP4, WebM, ou d'autres formats avec des contrôle qualité et de paramètres avancés. Elle inclut également des commandes de diagnostic (`doctor`, `browser`, `info`, `upgrade`) pour vérifier et configurer l'environnement d'exécution (Node.js, FFmpeg, Chrome). L'outil `inspect` est particulièrement puissant pour détecter les problèmes de mise en page dans les bulles de dialogue, les cartes et les légendes, et peut être utilisé en mode strict pour bloquer le rendu en présence d'erreurs ou d'avertissements. La compétence distingue clairement les cas d'usage : pour le prétraitement des ressources (synthèse vocale, transcription, suppression d'arrière-plan), il faut invoquer la compétence `hyperframes-media` séparément. Elle prend en charge le rendu paramétré via des variables déclarées dans la composition, ce qui permet de réutiliser un même projet avec des données différentes sans modifier le code source.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-hyperframes-cli

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

CLI HyperFrames

Tout s'exécute via npx hyperframes. Nécessite Node.js >= 22 et FFmpeg.

Flux de travail

  1. Scaffolding — npx hyperframes init my-video
  2. Écriture — composer le HTML (voir la compétence hyperframes)
  3. Linting — npx hyperframes lint
  4. Inspection visuelle — npx hyperframes inspect
  5. Aperçu — npx hyperframes preview
  6. Rendu — npx hyperframes render

Effectuez le linting et l'inspection avant l'aperçu. lint détecte les data-composition-id manquants, les pistes qui se chevauchent et les timelines non enregistrées. inspect ouvre la composition rendue dans Chrome sans tête, parcourt la timeline et signale le texte qui déborde des bulles/conteneurs ou du canevas.

Scaffolding

npx hyperframes init my-video                        # assistant interactif
npx hyperframes init my-video --example warm-grain   # choisir un exemple
npx hyperframes init my-video --video clip.mp4        # avec fichier vidéo
npx hyperframes init my-video --audio track.mp3       # avec fichier audio
npx hyperframes init my-video --example blank --tailwind # avec runtime navigateur Tailwind v4
npx hyperframes init my-video --non-interactive       # ignorer les invites (CI/agents)

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

init crée la structure de fichiers correcte, copie les médias, transcrit l'audio avec Whisper et installe les compétences de codage IA. Utilisez-le plutôt que de créer des fichiers à la main.

Lorsque vous utilisez --tailwind, invoquez la compétence tailwind avant de modifier les classes ou les tokens de thème. Le scaffolding utilise Tailwind v4.2 via le runtime navigateur, pas la configuration Tailwind v3 de Studio.

Linting

npx hyperframes lint                  # répertoire courant
npx hyperframes lint ./my-project     # projet spécifique
npx hyperframes lint --verbose        # résultats de niveau info
npx hyperframes lint --json           # lisible par machine

Analyse index.html et tous les fichiers dans compositions/. Signale les erreurs (à corriger), les avertissements (devraient être corrigés) et les informations (avec --verbose).

Inspection visuelle

npx hyperframes inspect                 # inspecte la mise en page rendue sur la timeline
npx hyperframes inspect ./my-project    # projet spécifique
npx hyperframes inspect --json          # résultats lisibles par agent
npx hyperframes inspect --samples 15    # balayage plus dense de la timeline
npx hyperframes inspect --at 1.5,4,7.25 # horodatages explicites des trames clés

Utilisez cette commande après lint et validate, surtout pour les compositions avec des bulles de dialogue, des cartes, des légendes ou une typographie serrée. Elle signale :

  • Le texte qui s'étend en dehors du conteneur visuel ou de la bulle le plus proche
  • Le texte tronqué par sa propre boîte à largeur/hauteur fixe
  • Le texte qui s'étend en dehors du canevas de la composition
  • Les enfants qui s'échappent des conteneurs de découpage

Les erreurs doivent être corrigées avant le rendu. Les avertissements sont remontés pour examen par l'agent ; ajoutez --strict pour échouer également sur les avertissements. Les problèmes statiques répétés sont regroupés par défaut afin que la sortie JSON reste compacte pour les fenêtres de contexte LLM. Si un débordement est intentionnel pour une animation d'entrée/sortie, marquez l'élément ou son ancêtre avec data-layout-allow-overflow. Si un élément décoratif ne doit jamais être audité, marquez-le avec data-layout-ignore.

npx hyperframes layout reste disponible comme alias de compatibilité pour la même passe d'inspection visuelle.

Aperçu

npx hyperframes preview                   # servir le répertoire courant
npx hyperframes preview --port 4567       # port personnalisé (par défaut 3002)

Recharge à chaud lors des modifications de fichiers. Ouvre le studio automatiquement dans le navigateur.

Lorsque vous remettez un projet à l'utilisateur, utilisez l'URL du projet Studio, pas le chemin du fichier index.html source :

http://localhost:<port>/#project/<nom-du-projet>

Utilisez le port réel affiché par l'aperçu et le nom du répertoire du projet. Par exemple, après npx hyperframes preview --port 3017 dans codex-openai-video, signalez http://localhost:3017/#project/codex-openai-video.

Traitez index.html uniquement comme contexte de code source. Il est acceptable de le lier en tant que fichier d'implémentation, mais ne le qualifiez pas de projet ou de surface d'aperçu.

Rendu

npx hyperframes render                                # MP4 standard
npx hyperframes render --output final.mp4             # sortie nommée
npx hyperframes render --quality draft                # itération rapide
npx hyperframes render --fps 60 --quality high        # livraison finale
npx hyperframes render --format webm                  # WebM transparent
npx hyperframes render --docker                       # identique au niveau octet
DrapeauOptionsPar défautRemarques
--outputcheminrenders/nom_timestamp.mp4Chemin de sortie
--fps24, 30, 603060 ips double le temps de rendu
--qualitydraft, standard, highstandarddraft pour itérer
--formatmp4, webmmp4WebM prend en charge la transparence
--workers1-8 ou autoautoChacun lance Chrome
--dockerdrapeauoffSortie reproductible
--gpudrapeauoffEncodage accéléré par GPU
--strictdrapeauoffÉchouer sur les erreurs de lint
--strict-alldrapeauoffÉchouer sur les erreurs ET les avertissements
--variablesobjet JSON—Remplacer les valeurs des variables déclarées dans data-composition-variables
--variables-filechemin—Fichier JSON avec les valeurs des variables (alternative à --variables)
--strict-variablesdrapeauoffÉchouer le rendu sur les clés non déclarées ou les types incorrects dans --variables

Recommandations de qualité : draft pendant l'itération, standard pour la révision, high pour la livraison finale.

Rendus paramétrés : la composition déclare ses variables sur la racine <html> avec data-composition-variables — un tableau JSON de déclarations ({id, type, label, default} par entrée) qui définit le schéma. Les scripts à l'intérieur lisent les valeurs résolues via window.__hyperframes.getVariables(). La CLI --variables '{"title":"Rapport Q4"}' est un objet JSON indexé par id qui remplace ces valeurs par défaut déclarées pour un rendu ; les clés manquantes sont ignorées, donc la même composition s'exécute inchangée en aperçu de développement et en production. (Les hôtes de sous-composition peuvent également remplacer par instance avec data-variable-values — même forme d'objet, limitée à un montage de la sous-composition. Voir la compétence hyperframes pour le motif complet.)

Prétraitement des ressources

npx hyperframes tts, transcribe et remove-background produisent des ressources (audio de narration, transcriptions mot par mot, vidéo transparente) qui sont déposées dans une composition. Chacun télécharge son propre modèle lors de la première exécution. Pour la sélection de voix, les règles du modèle whisper (l'astuce .en qui traduit le non-anglais), le choix du format de sortie (WebM alpha VP9 vs ProRes) et la chaîne TTS → transcription → légendes, invoquez la compétence hyperframes-media.

Dépannage

npx hyperframes doctor       # vérifier l'environnement (Chrome, FFmpeg, Node, mémoire)
npx hyperframes browser      # gérer le Chrome fourni
npx hyperframes info         # détails de version et d'environnement
npx hyperframes upgrade      # vérifier les mises à jour

Exécutez doctor en premier si le rendu échoue. Problèmes courants : FFmpeg manquant, Chrome manquant, mémoire insuffisante.

Autres

npx hyperframes compositions   # lister les compositions dans le projet
npx hyperframes docs           # ouvrir la documentation
npx hyperframes benchmark .    # mesurer les performances de rendu

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.

Skills associés