Communitygithub.com

Drama2557/4RealDigital-Video-Studio

Utilisez la boucle de développement CLI HyperFrames : init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, rendu unique ou par lot, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts et remove-background. À utiliser également pour diagnostiquer les échecs de build ou de rendu. validate, inspect et layout sont des alias obsolètes ; utilisez check. Couvre le rendu local, cloud hébergé par HeyGen, AWS Lambda et Google Cloud Run.

Qu'est-ce que 4RealDigital-Video-Studio ?

Ce skill permet à un agent IA d'orchestrer l'ensemble du pipeline de création vidéo HyperFrames : de l'initialisation du projet et de l'écriture de compositions à l'inspection, l'audit, la prévisualisation dans Studio et le rendu final (local, Docker, HeyGen cloud, AWS Lambda ou Google Cloud Run). Il est utile pour tout développeur souhaitant automatiser la production vidéo avec une boucle de développement rapide, des vérifications de qualité intégrées (lint, check, snapshots, assertions) et des déploiements serverless. Le skill guide l'agent étape par étape : échafaudage, lint après chaque modification, check comme porte finale, prévisualisation et demande d'approbation avant rendu, puis vérification du fichier produit. Il impose également des conventions strictes comme l'utilisation de --json en mode agent, la lecture des références obligatoires avant chaque commande, et l'envoi de rapports de feedback structurés avec paquet de reproduction en cas de problème. Fonctionne avec Node.js 22+, FFmpeg, et tout terminal supportant npx.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Drama2557/4RealDigital-Video-Studio/tree/HEAD/.agents/skills/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

HyperFrames CLI

Exécutez les commandes sous la forme npx hyperframes ... sauf si les instructions du projet fournissent un wrapper. Suivez le wrapper lorsqu'il est présent. La CLI nécessite Node.js 22 ou plus récent et FFmpeg.

Boucle de développement

  1. Échafaudage : npx hyperframes init <projet> ou capturez un site. En mode non-TTY, passez --non-interactive --example=<nom>.
  2. Rédaction : écrivez la composition à l'aide de /hyperframes-core.
  3. Obtenez un retour rapide pendant l'édition : exécutez npx hyperframes lint après le premier passage HTML et après les changements structurels.
  4. Exécutez la porte finale : exécutez npx hyperframes check ; il relance lint avant d'ouvrir le navigateur. N'ajoutez pas d'invocation lint autonome redondante avant. Ajoutez --snapshots pour des images de synthèse annotées et la recherche de recadrages.
  5. Inspectez les sous-compositions : lorsque index.html monte data-composition-src, capturez des instantanés à mi-parcours et inspectez chaque scène montée.
  6. Ouvrez l'aperçu final du Studio : exécutez npx hyperframes preview, donnez l'URL du projet de timeline à l'utilisateur, et demandez s'il faut réviser ou rendre.
  7. Effectuez le rendu uniquement après approbation : utilisez la qualité brouillon pour l'itération et haute qualité pour la livraison.
  8. Vérifiez la sortie : confirmez que le fichier existe, n'est pas vide et a une durée plausible.
# Vérification d'itération rapide ; répétez pendant la rédaction si nécessaire.
npx hyperframes lint

# Porte finale requise ; inclut lint.
npx hyperframes check
npx hyperframes preview
npx hyperframes render --quality high --output out.mp4
test -s out.mp4
ffprobe -v error -show_format out.mp4

check exécute d'abord lint, puis utilise une session navigateur et un passage de recherche pour auditer les erreurs d'exécution, les requêtes échouées, la mise en page, les assertions *.motion.json et le contraste WCAG. Les constatations persistantes bloquent le code de sortie ; les constatations transitoires d'entrée ou de sortie sont informatives. Utilisez --strict pour bloquer les avertissements. validate, inspect et layout restent des alias pour la compatibilité mais ne doivent pas apparaître dans de nouvelles instructions ou scripts.

Deux surfaces d'aperçu différentes

Ne confondez pas ces états :

SurfaceQuand elle peut s'ouvrirObjectif
Tableau de storyboardAvant les vérifications de composition, uniquement si storyboard: yesExaminer les fiches de plan et les croquis de maquette. Ouvrir ?view=storyboard#project/<nom>.
Aperçu final de la compositionAprès la réussite de checkExaminer la timeline assemblée avant le rendu. Ouvrir #project/<nom>.

Le tableau précoce n'est pas une approbation de la vidéo finale. Le rendu nécessite toujours l'approbation finale définie par hyperframes-core/references/review-loop.md.

Test de fumée des sous-compositions

Les audits statiques ne peuvent pas détecter toutes les défaillances de montage. Lorsque le projet utilise des sous-compositions, capturez au moins un point médian visible pour chaque emplacement hôte :

npx hyperframes snapshot --at <t1>,<t2>,<t3>

Considérez le contenu minuscule non stylisé, les icônes de taille de canevas, les éléments héros manquants ou les délais d'enregistrement de timeline comme des défauts de montage bloquants le rendu. Voir hyperframes-core/references/sub-compositions.md pour les corrections correspondantes.

Conventions pour l'agent

  • Préférez --json pour les appels d'agent et CI. Le mode serveur render, preview et play ne fournissent pas de sortie JSON ordinaire ; preview --selection --json et preview --context --json sont des exceptions de mode requête.

  • doctor --json se termine toujours par zéro. Bloquez sur sa charge utile :

    npx hyperframes doctor --json | jq -e '.ok' >/dev/null
    
  • Le mode non-TTY est automatique. init nécessite --example dans ce cas ; utilisez --non-interactive pour forcer un comportement déterministe sur un TTY.

  • Utilisez un seul HYPERFRAMES_RUN_ID pour toutes les commandes dans la même boucle de vérification.

  • Utilisez --strict, --strict-all et --strict-variables lorsque les avertissements, variables ou conditions CI correspondants doivent bloquer le rendu.

  • Les chemins JSON masquent le répertoire personnel sous la forme $HOME ; n'essayez pas d'inverser ce masquage.

  • Ne rendez jamais simplement parce que les vérifications réussissent. Faites une pause à l'aperçu final et attendez l'approbation.

Modifications dirigées par Studio

Lorsque l'utilisateur fait référence à « cet élément » ou à la sélection en cours, interrogez Studio au lieu de deviner :

npx hyperframes preview --context --json --context-fields selection

Utilisez selection.target.hfId lorsqu'il est disponible, sinon son sélecteur et son fichier source. Si le résultat signale no-selection, demandez à l'utilisateur de cliquer sur l'élément et de réexécuter. Ne demandez que les tranches de contexte dont vous avez besoin ; utilisez --context-detail full uniquement pour les styles calculés ou les métadonnées de texte modifiable. Le comportement complet et les codes d'échec se trouvent dans references/preview-render.md.

Choix de rendu

BesoinCommande
Itération locale rapidenpx hyperframes render --quality draft
Livraison locale finalenpx hyperframes render --quality high --output out.mp4
Rendu conteneur reproductiblenpx hyperframes render --docker --strict --output out.mp4
Rendu par lot local piloté par variablesnpx hyperframes render --batch rows.json --output "renders/{name}.mp4"
Rendu cloud hébergé HeyGen sans infrastructurenpx hyperframes cloud render
Rendu AWS distribué auto-gérénpx hyperframes lambda render <projet> --width 1920 --height 1080 --wait
Rendu GCP distribué auto-gérénpx hyperframes cloudrun render <projet> --width 1920 --height 1080 --wait

Utilisez le rendu cloud lorsque l'utilisateur souhaite un rendu hébergé sans Chrome local, FFmpeg ou AWS. Utilisez Lambda uniquement lorsque la propriété AWS est requise. Utilisez Cloud Run uniquement lorsque la propriété GCP est requise. Lisez la référence correspondante avant d'exécuter tout chemin cloud.

Après avoir vérifié un rendu réussi, envoyez un rapport de feedback sauf si la télémétrie est désactivée ou si l'utilisateur s'est désinscrit :

npx hyperframes feedback --rating <0-10> --comment "<résultat spécifique ou friction>"

Gardez le feedback pour une exécution propre concis. Pour tout bug ou friction, capturez un paquet de reproduction avant de soumettre ; n'envoyez pas seulement un résumé des symptômes. Incluez la commande réexécutable et le répertoire de travail, le comportement attendu par rapport au comportement réel, l'erreur exacte, si la sortie est terminée/repliée/échouée, la solution de contournement et l'état du projet de reproduction. Pour une note ≤ 7 décrivant un défaut visuel (image noire, scintillement, sortie corrompue, mauvais cadre, sortie vide, autre anomalie visuelle), incluez également un bloc COMPOSITION_STRUCTURE: — une anatomie structurelle respectueuse de la vie privée (recensement des éléments + présence d'attributs + forme de la timeline) afin que les responsables puissent faire correspondre des schémas avec des familles de bugs connues sans le ZIP de la composition. Les agents remplissent automatiquement ce bloc via l'assistant de recensement de composition ; l'utilisateur humain ne le remplit pas manuellement. Si le problème ne s'est pas reproduit, dites-le et incluez quand même la dernière commande et les derniers logs. Utilisez --file-issue uniquement avec consentement : il publie une reproduction minimale sur une URL publique. Le format obligatoire du paquet et l'avertissement de confidentialité se trouvent dans references/preview-render.md.

Lisez la référence correspondante avant d'exécuter une commande

Les références et compétences propriétaires suivantes sont des contrats de commande obligatoires, pas une lecture de fond optionnelle. Avant d'exécuter une commande dans le tableau, lisez sa ligne correspondante.

BesoinRéférence
init, capture, skillsreferences/init-and-scaffold.md
lint, check, sidecars de mouvement, snapshotreferences/lint-validate-inspect.md
compare, grade-compare, render --batch piloté par variablesreferences/compare-and-batch.md
beats pour la grille de beats Studio d'un projet existantreferences/beats.md
preview, play, render, publish, contexte Studio, feedbackreferences/preview-render.md
doctor, gestion du navigateurreferences/doctor-browser.md
auth, rendu cloud hébergé HeyGen et variables de modèlereferences/cloud.md
Déploiement et rendu AWS Lambdareferences/lambda.md
Déploiement et rendu Google Cloud Runreferences/cloudrun.md
info, upgrade, compositions, docs, benchmark, télémétrie, prétraitement médiareferences/upgrade-info-misc.md

Pour les variables de composition, lisez également /hyperframes-core → references/variables-and-media.md. Pour hyperframes add et hyperframes catalog, utilisez /hyperframes-registry. Avant hyperframes present, lisez /slideshow ; avant hyperframes keyframes, lisez /hyperframes-keyframes. Pour les choix TTS, transcription, sous-titres ou suppression d'arrière-plan, utilisez /media-use.

Les commandes spécialisées sont délibérément documentées par leurs workflows propriétaires :

npx hyperframes present <répertoire-projet> --port 3004 --no-open
npx hyperframes beats <répertoire-projet> --json
npx hyperframes keyframes <répertoire-projet> --json

present sert un deck navigable avec synchronisation présentateur et public. beats est l'utilitaire autonome de grille de beats Studio défini dans references/beats.md. keyframes expose des diagnostics d'animation et de chemin de mouvement sûrs pour la recherche.

Individual skills in this repo

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

Drama2557/4RealDigital-Video-Studio

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

Drama2557/4RealDigital-Video-Studio

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

Drama2557/4RealDigital-Video-Studio

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

Drama2557/4RealDigital-Video-Studio

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Drama2557/4RealDigital-Video-Studio

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

Drama2557/4RealDigital-Video-Studio

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Drama2557/4RealDigital-Video-Studio

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

Drama2557/4RealDigital-Video-Studio

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Drama2557/4RealDigital-Video-Studio

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Drama2557/4RealDigital-Video-Studio

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

Drama2557/4RealDigital-Video-Studio

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

Drama2557/4RealDigital-Video-Studio

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.

Drama2557/4RealDigital-Video-Studio

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

Drama2557/4RealDigital-Video-Studio

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Agent skill / project related to launch or product demo video: Drama2557/4RealDigital-Video-Studio

Skills associés