Communitygithub.com

delorenj/skills

Boucle de développement CLI HyperFrames — `npx hyperframes` pour le scaffolding (init), la validation (lint, inspect), l'aperçu, le rendu et le dépannage de l'environnement (doctor, browser, info, upgrade). Utilisez-le 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 d'actifs (`tts`, `transcribe`, `remove-background`), invoquez la compétence `hyperframes-media`.

Qu'est-ce que skills ?

Cette compétence fournit une interface CLI complète pour le framework de composition vidéo HyperFrames, centralisant toutes les opérations clés via `npx hyperframes`. Elle guide le développeur à travers un workflow structuré en six étapes : scaffolding initial du projet, rédaction des compositions HTML, linting pour détecter les erreurs structurelles, inspection visuelle pour repérer les débordements de texte, aperçu avec rechargement à chaud, et rendu final en MP4 ou WebM. Elle supporte la paramétrisation des compositions via des variables déclarées dans le HTML, permettant des rendus personnalisés sans modifier le code source. Les commandes de dépannage (`doctor`, `browser`, `info`, `upgrade`) aident à diagnostiquer les problèmes d'environnement. L'outil est conçu pour fonctionner avec Node.js >= 22 et FFmpeg, et peut être utilisé aussi bien en interactif qu'en mode CI/agent via `--non-interactive`. Les options avancées incluent le rendu Docker reproductible, l'accélération GPU, et le linting/rendu strict pour une validation poussée.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/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.

Workflow

  1. Scaffolding — npx hyperframes init my-video
  2. Rédaction — créez la composition 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 puis 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 appropriée, 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 les fichiers à la main.

Lorsque vous utilisez --tailwind, invoquez la compétence tailwind avant de modifier les classes ou les thèmes. Le scaffold utilise Tailwind v4.2 via le runtime navigateur, et non 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 images clés

Utilisez cette commande après lint et validate, en particulier pour les compositions avec des bulles de dialogue, des cartes, des sous-titres ou une typographie serrée. Elle signale :

  • Le texte s'étendant à l'extérieur du conteneur visuel ou de la bulle le plus proche
  • Le texte coupé par sa propre boîte à largeur/hauteur fixe
  • Le texte s'étendant à l'extérieur du canevas de la composition
  • Les enfants s'échappant des conteneurs de découpage

Les erreurs doivent être corrigées avant le rendu. Les avertissements sont présentés pour examen par l'agent ; ajoutez --strict pour échouer également sur les avertissements. Les problèmes statiques répétés sont réduits 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                   # sert le répertoire courant
npx hyperframes preview --port 4567       # port personnalisé (défaut 3002)

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

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

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

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

Considérez index.html uniquement comme un contexte de code source. Il est acceptable de le lier comme fichier d'implémentation, mais ne l'étiquetez pas comme le projet ou la 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 octet par octet
DrapeauOptionsDéfautNotes
--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
--dockerdrapeaudésactivéSortie reproductible
--gpudrapeaudésactivéEncodage accéléré par GPU
--strictdrapeaudésactivéÉchouer sur les erreurs de lint
--strict-alldrapeaudésactivéÉchouer sur les erreurs ET les avertissements
--variablesobjet JSON—Remplacer les valeurs de variables déclarées dans data-composition-variables
--variables-filechemin—Fichier JSON avec les valeurs des variables (alternative à --variables)
--strict-variablesdrapeaudésactivéÉchouer le rendu en cas de clés non déclarées ou de types incompatibles dans --variables

Recommandation 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 internes lisent les valeurs résolues via window.__hyperframes.getVariables(). Le CLI --variables '{"title":"Rapport Q4"}' est un objet JSON indexé par id qui remplace les valeurs par défaut déclarées pour un rendu ; les clés manquantes sont ignorées, de sorte que 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é à un montage de la sous-composition. Voir la compétence hyperframes pour le modèle complet.)

Prétraitement des actifs

npx hyperframes tts, transcribe et remove-background produisent des actifs (audio de narration, transcriptions mot par mot, vidéo transparente) qui sont déposés 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 (le piège .en qui traduit les langues non anglaises), le choix du format de sortie (WebM alpha VP9 vs ProRes) et la chaîne TTS → transcription → sous-titres, 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 .    # évaluer les performances de rendu

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/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.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/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.

delorenj/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.

delorenj/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.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/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.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

Skills associés