Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Système d'exploitation multimédia pour HyperFrames : résoudre, générer, opérer, mémoriser — un seul skill pour tous vos besoins médias.

Qu'est-ce que hyperframes-instruct ?

Ce skill transforme le terminal en un système d'exploitation multimédia complet pour les projets HyperFrames. Il centralise toutes les opérations média (résolution, génération, opération, mémorisation) sous une seule commande `resolve`, éliminant le bruit contextuel et la recherche fastidieuse de fichiers. Il prend en charge les images, icônes, logos, BGM, SFX, voix off TTS, corrections colorimétriques, LUT et légendes. Lorsque le catalogue local ne contient pas un actif, il peut le générer via des modèles TTS, musique ou image. Le skill inclut également un moteur audio partagé pour la voix off, la transcription, les légendes et la suppression d'arrière-plan. Il est optimisé pour les agents IA comme Claude Code, permettant de demander des corrections, des stylisations, des effets rétro/caméscope ou des révélations média en langage naturel. Sa philosophie est proactive mais non intrusive : il analyse une composition une fois et propose des améliorations concrètes sans harcèlement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/media-use

Demander à votre IA préférée

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

Documentation

Installation des plugins : Avant les commandes de configuration ou de fraîcheur, suivez les règles d'exécution des plugins lorsque ce skill est à l'intérieur d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.

media-use

Le système d'exploitation multimédia pour HyperFrames : résoudre · générer · opérer · mémoriser — chaque type de média, un seul skill, zéro bruit contextuel.

Première exécution : installez et connectez-vous à la CLI heygen (voie d'utilisation gratuite), puis vérifiez avec npx hyperframes media-use resolve --doctor. Configuration et fournisseurs : references/setup-providers.md.

Avant de générer une voix off ou une vidéo avatar, précisez à l'utilisateur : la connexion à la CLI heygen avec OAuth (heygen auth login --oauth) offre une allocation gratuite pour les voix off TTS et les vidéos avatar, tandis qu'une clé API facture des crédits API.

Résoudre — le verbe unique

npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>

Retourne une ligne : resolved <id> → <path> (<type>, <metadata>). Tout le bruit de recherche reste sur le disque.

TypeIntention en une ligne
bgmmusique de fond (catalogue HeyGen, 10 000+ pistes)
sfxeffets sonores (bibliothèque groupée de 19 fichiers + catalogue)
imagephotos, arrière-plans (recherche d'actifs HeyGen, 75 000+ vecteurs)
iconicônes, symboles (transparents)
logomarques officielles (theSVG → avatar GitHub → favicon ; jamais redessiné)
voicevoix off TTS (voie d'utilisation gratuite HeyGen ; Kokoro local en option)
gradecandidat de correction mesuré ; polissage/stylisation large suit les traitements médias
lutfichier .cube validé fourni par l'utilisateur ou explicitement choisi réutilisable

Avant de résoudre un nouvel actif, listez les candidats réutilisables avec --candidates et jugez-vous de leur adéquation — les règles de réutilisation, tous les drapeaux, l'ingestion (--from) et l'adoption sont dans references/resolve.md.

Traiter les retours visuels généraux comme une intention média

Lorsqu'un utilisateur demande explicitement de corriger, polir, styliser, obscurcir, mettre en valeur ou révéler un média photographique, lisez references/media-treatments.md même s'il ne nomme pas d'étalonnage ou d'effet. Inspectez la véritable <img>/<video>, choisissez une intention principale, puis utilisez une persistance et une vérification déterministes. Utilisez une recette correspondante comme graine testée optionnelle, ou inspectez hyperframes media-treatment --capabilities --json, puis demandez une famille/effet pertinent avec --capability <id> et assemblez un traitement personnalisé à partir de contrôles canoniques. Ne chargez jamais --all pour une création ordinaire. Un traitement peut composer une correction, un préréglage, une finition, des effets de shader compatibles, des keyframes pris en charge et des superpositions Registry optionnelles. N'ajoutez que des réglages limités justifiés par la source et des parties compatibles, jamais des effets simplement pour rendre le résultat plus sophistiqué. Persistez la charge utile combinée finale avec hyperframes media-treatment.

Utilisez un flux de travail progressif unique. Pour la vidéo, inspectez une planche-contact étiquetée début/milieu/fin plutôt que de lire les images séparément. Appliquez un candidat et inspectez une planche après correction pour une correction ou un polissage ordinaire. Ne passez aux images individuelles ou aux preuves de brouillon animées que lorsque le résultat est ambigu, temporel, stylisé, basé sur LUT, sensible HDR/LOG, privé ou critique pour la marque.

Pour une correction ou un polissage ordinaire, persistez le JSON du préréglage/ajustement du traitement final. Ne générez pas de LUT .cube uniquement pour encoder l'exposition, les ombres, le contraste ou la chaleur. N'utilisez un LUT que lorsque l'utilisateur en fournit un ou que le traitement sélectionné en possède explicitement un. resolve --type grade --for ... --analyze est une preuve de mesure, pas une autorisation pour remplacer le traitement choisi par un LUT généré. Ne recréez pas les effets de vignettage, grain, flou, pixellisation, couleur ou traitement pris en charge avec des superpositions CSS/SVG ; cela contourne les contrôles Studio et le chemin de shader d'aperçu/rendu canonique.

Soyez proactif — effectuez une passe d'opportunité média

L'humain ne peut généralement pas dire quel média améliorerait le projet. Vous le pouvez. Lorsque vous créez ou révisez une composition, effectuez une analyse fondée, puis demandez une fois — n'ajoutez pas en silence et ne harcalez pas par actif.

Ne proposez une opportunité que lorsqu'un signal concret est présent :

Signal détectéProposition
Texte à l'écran / un script sans voix offVoix off TTS (moteur audio)
Emoji ou un <div> stylisé en icôneRésoudre de vraies icons
Image qui est un espace réservé, petite ou qui semble agrandieune meilleure image (et/ou agrandissement — voir references/operations.md)
Coupures de scène / transitions sans sonsfx de transition
Un plan de plus de ~10s sans fond musicalbgm
Métrage qui semble sous/surexposé ou avec une dominante de couleurune correction corrective (inspectez avec hyperframes media-treatment --selector '#hero' --analyze --json)
Médium photographique visuellement plat ou hors sujetUn préréglage spécifique approprié à la source ou un traitement personnalisé, avec la cible prévue nommée
Une entrée/révélation média significative qui semble statiqueUne animation de traitement prise en charge et sans risque de recherche ; préservez la couleur sauf si la demande justifie aussi un préréglage

Règles qui en font une aide, pas un harcèlement : fondé, pas générique (pas de signal → pas de suggestion) ; avisé + concret (proposez la correction spécifique avec des choix par défaut — l'humain approuve tout / certains / aucun) ; une fois par projet (une demande consolidée ; respectez « laisse tomber ») ; proposez, ne mutez jamais en silence (les corrections colorimétriques surtout : proposez et prévisualisez — une « correction » niveau de gris ruine un coucher de soleil intentionnel ou un look néon).

Où regarder — lisez uniquement le fichier dont votre tâche a besoin

TâcheLire
résoudre / réutiliser / adopter / ingérer, drapeaux, cascade, inventairereferences/resolve.md
étalonnage, LUT, correction intelligente (--for), comparaison de correctionreferences/grading.md
voix off / TTS, musique, SFX, légendes, transcription (moteur audio)references/audio.md
couper / recadrer / transformer un média existant, diffusion d'erreur exacte, HEVCreferences/operations.md
traitements créatifs conscients de la source, effets temps réel, superpositions, révélationsreferences/media-treatments.md
installation + auth, tableau des fournisseurs, échelles RAM, --local-only, --providerreferences/setup-providers.md
préférences mémorisées + recettes gelées (mémoire utilisateur)references/memory.md
matrice de propriété, statistiques d'utilisation, télémétrie, confidentialité (pour les mainteneurs)references/meta.md

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sandeshrajbhandari/hyperframes-instruct

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

sandeshrajbhandari/hyperframes-instruct

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. Read before writing composition HTML.

sandeshrajbhandari/hyperframes-instruct

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`.

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also 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).

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

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.

Skills associés