Communitygithub.com

Manavv007/S.A.R.A.L. - Couche d'Accès, de Récupération et d'Ana…

Le workflow de secours pour créer des compositions vidéo HyperFrames personnalisées de n'importe quelle longueur ou format — pièces longues ou multi-scènes, bandes-annonces de marque / sizzle reels, montages, cartes-titres, boucles statiques et compositions libres. Indépendant de l'entrée et de la durée. Si un workflow spécialisé correspond clairement à l'entrée — un produit commercialisé, un site web, un explicatif de sujet, une PR GitHub, des séquences existantes, un court graphisme animé ou un portage Remotion — préférez-le (voir /hyperframes) ; utilisez celui-ci uniquement comme solution de repli général lorsque aucun ne correspond.

Qu'est-ce que S.A.R.A.L. - Couche d'Accès, de Récupération et d'Ana… ?

Le skill S.A.R.A.L. (Couche d'Accès, de Récupération et d'Analyse de Schémas) pour agents IA est un workflow de secours pour la création de compositions vidéo personnalisées avec HyperFrames. Il est conçu pour être agnostique en termes d'entrée et de durée, permettant de produire des pièces longues ou multi-scènes, des bandes-annonces de marque, des montages, des cartes-titres, des boucles statiques et des compositions libres. Ce skill est utilisé uniquement lorsqu'aucun workflow spécialisé (comme ceux pour les produits commercialisés, les sites web, les explicatifs de sujet, les PR GitHub, les séquences existantes, les graphismes animés ou les portages Remotion) ne correspond à l'entrée. Il guide l'agent à travers une approche structurée en plusieurs étapes : découverte pour les demandes vagues, établissement du système de design via les références hyperframes-creative (y compris le style maison et la composition vidéo), expansion du prompt pour les pièces multi-scènes, planification de la narration, de la structure, du rythme et du timing, et construction avec une mise en page d'abord avant l'animation. Il intègre également la gestion audio via un moteur unifié (TTS, BGM, SFX) et délègue les implémentations spécifiques à des skills de domaine (animation, composition, médias). Ce skill est particulièrement utile pour les développeurs et agents IA qui ont besoin d'un cadre flexible et robuste pour la production vidéo, garantissant que la sortie soit « produite » plutôt que « générée » en suivant des règles strictes de densité visuelle, de typographie et de mise en page.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/tree/HEAD/.agents/skills/general-video

Demander à votre IA préférée

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

Documentation

media-use : Avant de sourcer l'audio/les images, appelez /media-use pour résoudre la BGM/SFX/les images du catalogue HeyGen. Exécutez --adopt d'abord pour enregistrer les actifs existants. Voir le skill /media-use.

general-video — workflow vidéo général

Confirmez la route avant de construire. Ceci est le repli pour l'écriture de compositions personnalisées. Si l'entrée correspond clairement à un workflow spécialisé, préférez-le : produit commercialisé → /product-launch-video ; site général → /website-to-video ; explicatif de sujet → /faceless-explainer ; PR GitHub → /pr-to-video ; séquences existantes → /embedded-captions · /talking-head-recut ; court graphisme animé sans narration → /motion-graphics ; portage Remotion → /remotion-to-hyperframes. Hors périmètre : données en direct/au moment du rendu, montage de type NLE d'une vidéo terminée, ou production de séquences qu'HyperFrames ne peut pas capturer. Pas sûr ? Lisez /hyperframes d'abord.

Construisez exactement ce qui a été demandé. Une carte-titre est une carte-titre — pas une carte-titre + trois scènes de support + musique d'ambiance + sous-titres. Si des scènes ou éléments supplémentaires amélioreraient réellement la pièce, proposez-les ; ne les ajoutez pas silencieusement. Pour les petites modifications (corriger une couleur, ajuster une durée, ajouter un élément), sautez les étapes de planification et allez directement à la construction.

Approche

Découverte — demandes ouvertes uniquement

Pour les demandes vagues et exploratoires ("crée quelque chose pour notre marque", "une intro sympa") — comprenez l'intention avant de choisir les couleurs :

  • Audience — qui regarde ? développeurs / cadres / consommateurs généraux ?
  • Plateforme — où est-ce diffusé ? social (15s) / page d'accueil du site / démo produit / interne ?
  • Priorité — qu'est-ce qui compte le plus ? qualité du mouvement / exactitude du contenu / fidélité à la marque / rapidité ?
  • Variations — une seule meilleure version, ou 2-3 options significativement différentes (rythme, énergie ou structure différents — pas seulement des changements de couleur) ?

Pour les demandes spécifiques ("ajoute une carte-titre", "corrige le timing de la scène 3"), sautez la découverte.

Étape 1 — Système de design → hyperframes-creative

Établissez d'abord l'identité visuelle. Si le projet a un cahier des charges de design, lisez-le (précédence frame.md → design.md → DESIGN.md ; traitez-le comme une vérité de marque — couleurs, polices, contraintes exactes).

S'il n'y a pas de cahier des charges, vous DEVEZ lire les DEUX hyperframes-creative/references/house-style.md ET hyperframes-creative/references/video-composition.md avant de choisir une couleur ou une police. house-style.md donne l'ouverture "interpréter la demande / générer du contenu réel", la liste des valeurs par défaut paresseuses et la recette des calques ; video-composition.md donne les règles de densité / échelle / détails de premier plan (barres de données, repères, métadonnées en monospace, "8-10 éléments, dont deux que l'utilisateur n'a pas demandés") qui séparent le "produit" du "généré". Lire un seul document est l'erreur la plus courante — video-composition.md est celui que les agents sautent, et c'est exactement celui qui empêche une sortie plate, centrée et ressemblant à une page web. N'inventez pas vous-même une palette et ne sautez pas ces documents ; passer dans hyperframes-creative est obligatoire ici, pas une branche optionnelle. À partir de là, tirez également un style/ambiance nommé → references/visual-styles.md, ou le sélecteur interactif → references/design-picker.md, selon les besoins. Le cahier des charges / style définit la marque, pas les règles de composition.

Trouvez l'angle (brief vague, sans cahier des charges) : avant de choisir les couleurs, écrivez UNE phrase — qu'est-ce que ce nom/mot/sujet évoque, et quel monde visuel (métaphore, décor, instrument, motif) l'exprime ? Par exemple, un outil de cybersécurité → portes de coffre / lignes de balayage périphérique / gâchettes de serrure ; une app de méditation → marée, souffle, lueur de lumière lente. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'une restylisation littérale. C'est le substitut bon marché à l'expansion de prompt (Étape 2) pour les pièces à scène unique, où l'expansion est correctement ignorée — et c'est la différence entre un concept conçu et un logo générique sur un dégradé.

Étape 2 — Expansion du prompt → hyperframes-creative

Exécutez pour toute composition multi-scène (ignorez pour les pièces à scène unique et les modifications triviales). Ancrez la demande par rapport au cahier des charges de design + le style maison dans un intermédiaire cohérent que le travail en aval lit de la même manière. Voir hyperframes-creative/references/prompt-expansion.md.

Étape 3 — Planification

Avant d'écrire du HTML, réfléchissez à un niveau élevé :

  1. Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels.
  2. Structure — combien de compositions, sous-comp vs inline, quelles pistes portent la vidéo / l'audio / les superpositions / les sous-titres. Pour l'appel entre fichier monolithique unique et sous-comp modulaire, voir hyperframes-core/references/composition-patterns.md § Deux Architectures (règle empirique : ≥3 coupures de scène dures, ou toute scène réutilisée → modulariser ; une pièce courte à scène unique reste un fichier).
  3. Rythme — nommez le motif avant de l'implémenter (par exemple rapide-rapide-LENT-SHADER-tenue) ; voir hyperframes-creative/references/beat-direction.md.
  4. Timing — quels clips déterminent la durée, où se placent les transitions, le rythme.
  5. Mise en page — construisez d'abord l'état final (voir ci-dessous).
  6. Animation — ajoutez ensuite le mouvement via hyperframes-animation.

Mise en page avant Animation

Positionnez chaque élément là où il se trouve à son moment le plus visible — complètement entré, correctement placé, pas encore en train de sortir. Écrivez cela d'abord en HTML + CSS statique. Pas encore de GSAP.

Pourquoi : si vous positionnez les éléments à leur état de départ animé (hors écran, mis à l'échelle à 0, opacité 0) et que vous animez jusqu'à où vous pensez qu'ils atterrissent, vous devinez la mise en page finale — les chevauchements restent invisibles jusqu'au rendu. Construisez d'abord l'état final et vous voyez et résolvez les problèmes de mise en page avant d'ajouter du mouvement.

  1. Identifiez le cadre héro pour chaque scène — le moment où le plus grand nombre d'éléments sont simultanément visibles. C'est la mise en page que vous construisez.
  2. Écrivez le CSS statique pour ce cadre. Le conteneur de contenu doit remplir la scène avec du remplissage (padding), pas des décalages absolus :
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* le remplissage positionne le contenu ; remplit toute taille de scène */
  gap: 24px;
  box-sizing: border-box;
}

N'utilisez jamais position: absolute; top: Npx sur un conteneur de contenu — il déborde lorsque le contenu est plus haut que l'espace. Réservez le positionnement absolu aux éléments décoratifs.

⚠ Le width/height: 100% ci-dessus ne se résout que si chaque ancêtre a une hauteur résolue. Le <div data-composition-id> racine et toute enveloppe entre lui et .scene-content doivent être dimensionnés (position: relative; width: 1920px; height: 1080px sur la racine — voir hyperframes-core → "La racine doit être dimensionnée"). Sautez cela et le conteneur flex s'effondre à ~0, le contenu s'empile dans le coin supérieur gauche, et le premier glyphe est coupé à x=0 — tandis que lint/inspect signalent toujours 0 problèmes. Et gardez toujours le padding (≥80px) sur .scene-content : c'est la marge de sécurité du titre. Ne le remplacez jamais par un simple gap.

  1. Ajoutez les entrées — animez DEPUIS hors écran/invisible VERS la position CSS avec gsap.from() (dans les sous-compositions, préférez gsap.fromTo() pour que l'état de départ soit explicite ; voir hyperframes-core/references/sub-compositions.md). La position CSS est la vérité de base ; l'interpolation est le voyage vers elle.
  2. Les sorties sont gérées par la transition — selon les règles de transition de scène dans hyperframes-animation/transitions/, seule la dernière scène anime les éléments vers l'extérieur ; entre les scènes, la transition EST la sortie.

Espace partagé dans le temps : si l'élément A sort avant que l'élément B n'entre dans la même zone, les deux ont toujours besoin de positions CSS correctes pour leurs cadres héro respectifs — l'ordre dans la timeline les empêche de coexister, et l'étape de mise en page détecte les chevauchements accidentels. Les lueurs/ombres en couches et la profondeur en z-stack sont des chevauchements intentionnels ; l'étape concerne la détection des collisions non intentionnelles (deux titres l'un sur l'autre, contenu débordant du cadre).

Construction — déléguez aux skills de domaine

Cela cartographie la surface complète du skill (voir la description) vers ses références — non exhaustif ; lorsqu'une intention n'est pas listée, acheminez via hyperframes-creative (aspect/concept), hyperframes-animation (mouvement), hyperframes-core (contrat), hyperframes-media (audio/sous-titres). La première ligne est ADDITIVE — lisez-la ET votre ligne d'intention, pas l'une ou l'autre.

En train de construire…Lisez d'abord (dans l'ordre)
TOUJOURS — chaque pièce non triviale, en plus de votre ligne d'intention ci-dessoushyperframes-creative/references/house-style.md + references/video-composition.md (également bloqué à l'Étape 1 / HARD-GATE ; les détails de premier plan "produit, pas généré")
Typographie cinétique / axée sur le textehyperframes-animation/techniques.md (type cinétique) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Carte-titre / tiers-inférieur / superposition / PiP / texte-derrière-sujethyperframes-creative/references/composition-patterns.md + (pour le cadre centré/dimensionné) hyperframes-core → "La racine doit être dimensionnée"
Révélation de logo / marquehyperframes-animation/rules/svg-path-draw.md (tracé) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Données / statistiques / nombreshyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Produit / app / démo UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Audio-réactif / piloté par la musiquehyperframes-creative/references/audio-reactive.md (pré-extraire les bandes ; mapper au mouvement)
Narré / voix-off / musique / SFX / sous-titreshyperframes-media → le moteur audio partagé scripts/audio.mjs (un appel = TTS + BGM + SFX → audio_meta.json) ; écriture des sous-titres + placement des actifs via hyperframes-core. Voir Audio ci-dessous.
Multi-scène / transitionshyperframes-animation/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini après la vue d'ensemble — la recette GSAP est dans le catalogue)
Modulaire / sous-compositionshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Audio : un moteur (TTS · BGM · SFX)

Uniquement lorsque la pièce le demande (selon "construisez exactement ce qui a été demandé" — pas de musique d'ambiance sur une carte-titre). N'écrivez pas vous-même du TTS ou ne faites pas appel à un fournisseur avec une copie : écrivez un audio_request.json neutre et appelez le moteur partagé dans hyperframes-media. Il se dégrade automatiquement selon un commutateur — identifiant HeyGen présent → TTS HeyGen + récupération de musique/SFX ; absent → TTS ElevenLabs/Kokoro, génération de BGM Lyria/MusicGen, et la bibliothèque SFX groupée. Liste complète des drapeaux + schéma requête/méta : le commentaire d'en-tête de hyperframes-media/scripts/audio.mjs.

// audio_request.json — une ligne par segment narré ; `id` est le vôtre (relie audio_meta)
{
  "lines": [
    { "id": "s1", "text": "Votre première ligne.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "La prochaine mesure." },
  ],
  "bgm": { "query": "calme underscore cinématique" }, // omettre "mode" → auto (récupérer si HeyGen, sinon générer) ; "none" pour désactiver
}
# <MEDIA_DIR> = le répertoire du skill hyperframes-media installé (voisin de ce skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Lisez ensuite audio_meta.json : montez chaque voices[].path + (bgm.path, sfx[]) en tant que pistes <audio> et utilisez voices[].words pour les sous-titres, le tout selon hyperframes-core (pistes audio + écriture des sous-titres). Si la BGM a emprunté le chemin de génération (bgm_pending: true), exécutez hyperframes-media/scripts/wait-bgm.mjs avant le rendu final.

Liste de vérification de sortie → hyperframes-cli

  • …

[Le contenu a été tronqué pour la traduction, mais la structure et les instructions clés sont conservées.]

Individual skills in this repo

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

Skills associés