Communitygithub.com

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

Capturez un site web/URL générale et transformez-le en une vidéo HyperFrames (visite du site, démonstration ou clip social à partir des visuels du site). Utilise Chrome headless + les actifs de la marque.

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

Cette compétence permet de transformer n'importe quel site web général (portfolio, blog, landing page) en une vidéo professionnelle de type visite guidée, démonstration ou clip social. Elle utilise des captures d'écran Chrome headless et les actifs graphiques du site pour produire une vidéo dynamique. Le workflow est collaboratif et structuré en 7 étapes, chacune produisant un artefact nécessaire à l'étape suivante. L'étape 0 capture le site et identifie la marque, l'étape 1 définit l'identité visuelle (couleurs, polices), l'étape 2 aligne la stratégie et le message, l'étape 3 crée le storyboard et le script, l'étape 4 génère la voix-off et les sous-titres, l'étape 5 construit les compositions HTML, et l'étape 6 valide et livre la vidéo. Une attention particulière est portée aux règles de vérification (non contournables, même en mode autonome) et à la conformité WCAG. Les cas d'usage exclus sont explicitement listés (lancement produit, vidéo sans site, pull request GitHub, etc.). La compétence supporte également des modes autonomes (décisions sur les préférences utilisateur) et offre une table de référence pour les types de vidéos et les formats.

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/website-to-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 de l'audio/des images, appelez /media-use pour résoudre BGM/SFX/images depuis le catalogue HeyGen. Exécutez --adopt d'abord pour enregistrer les actifs existants. Voir la compétence /media-use.

Site Web vers HyperFrames

Capturez un site web, puis produisez une vidéo professionnelle à partir de celui-ci.

Confirmez la route avant l'Étape 0. Cette compétence crée une vidéo d'un / à partir d'un site général. Si l'utilisateur commercialise / lance / promeut vraiment un produit (même à partir de cette URL, même "promo pour notre site") → /product-launch-video. Un explicateur de sujet sans site → /faceless-explainer ; une pull request GitHub → /pr-to-video ; recouper / recoloriser / réordonner un fichier vidéo existant → hors du périmètre. Routé ici pour une demande vague "faire une vidéo", ou incertain entre lancement vs site général ? Lisez /hyperframes d'abord (table de routage complète + § Ce que HyperFrames ne peut pas faire).

Les utilisateurs disent des choses comme :

  • "Transforme ce site web en un clip social de 15 secondes pour Instagram"
  • "Fais une visite guidée / démonstration du site de 30 secondes depuis https://..."
  • "Capture notre page d'accueil et construis une vidéo à partir de ses propres visuels"

Le workflow comporte 7 étapes. Chacune produit un artefact qui conditionne la suivante. Par défaut, il est collaboratif — les barrières marquées 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale un mode autonome ("décide pour moi", "surprends-moi"), les barrières de préférence utilisateur 💬 sont ignorées ; voir step-2-brief.md pour comment cela se propage.

Le mode autonome n'est PAS "ignorer toutes les barrières". Le mode automatique couvre les questions de préférence utilisateur (fournisseur TTS, voix, accent de couleur, nombre de beats, musique oui/non, sous-titres oui/non — où l'agent décide pour l'utilisateur). Il ne couvre PAS les barrières de vérification de qualité. Les éléments suivants restent non contournables en mode auto :

  • Audit des actifs (Étape 3) — visualisation des planches contact et justification UTILISER/IGNORER pour chaque actif
  • Lecture HTML par beat (Étape 5) — bloc de preuves structuré par beat
  • Liste de vérification DoD (Étape 6) — y compris la carte d'animation, la vérification WCAG par avertissement, la lecture audio/mouvement
  • Section de divulgation honnête (Étape 6) — "Ce que je n'ai PAS vérifié" doit apparaître dans votre résumé final

Si vous vous surprenez à raisonner "le mode auto dit de privilégier l'action, donc je vais sauter X" — et que X est une barrière de vérification, pas une question de préférence — ce raisonnement est faux. Privilégier l'action s'applique à décider quoi construire, pas à décider s'il faut vérifier.


Étape 0 : Capture et Comprendre la Marque

Lire : references/step-0-capture.md

Capturez le site, puis lisez les données extraites pour comprendre la marque et le produit — ce qu'il fait, pour qui il est, quelle voix il utilise, dans quelle ambiance il vit. Les actifs capturés sont une boîte à outils de marque pour plus tard, pas les blocs de construction à partir desquels la vidéo est faite.

Affichez le statut de connexion avant le brief — exécutez npx hyperframes auth status et relayez sa sortie textuellement (ne paraphrasez pas et ne réécrivez pas). Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, si non connecté, comment se connecter. Si non connecté, ARRÊTEZ et attendez que l'utilisateur choisisse — se connecter, ou dire "go"/"offline" pour continuer avec les moteurs locaux — avant de demander le brief ou quoi que ce soit d'autre. Traitez-le comme un véritable point de décision, pas une note passagère ; ne fusionnez pas le choix dans la question du brief, et n'écrivez pas les clés dans un .env par dépôt. (En mode autonome, notez le statut et continuez hors ligne.) Voir ../hyperframes-media → Preflight pour les instructions canoniques.

Barrière : Résumé du site imprimé — stratégie d'abord (ce que le produit fait, pour qui il est, voix de la marque) avant l'inventaire des actifs / couleurs / polices ; le statut de connexion a été affiché (connecté, ou continuation hors ligne).


Étape 1 : Identité de Marque

Lire : references/step-1-design.md

Écrivez DESIGN.md — une aide-mémoire de marque couvrant l'identité visuelle : couleurs, typographie, styles de composants, principes de mise en page. Utilisez design-styles.json pour les valeurs calculées exactes.

Option vitesse : Pour les vidéos rythmées (un beat par panneau publicitaire), DESIGN.md peut être un résumé de 50 lignes des couleurs + polices + à faire/à ne pas faire — pas un document de 300 lignes. L'invite du sous-agent à l'Étape 5 colle directement les valeurs de la marque, donc la profondeur de DESIGN.md importe seulement pour les compositions complexes.

Barrière : DESIGN.md existe (n'importe quelle longueur) avec au minimum : palette de couleurs, choix de polices, et à faire/à ne pas faire.


Étape 2 : Stratégie et Message

Lire : references/step-2-brief.md, references/capabilities.md (parcourir la Table des Matières — sections détaillées seulement si nécessaire)

Alignez-vous avec l'utilisateur sur ce que la vidéo doit communiquer avant de parler de visuels ou d'actifs. Analysez l'invite de l'utilisateur — il a probablement déjà donné le type et le style de la vidéo. Demandez seulement ce qui manque : la SEULE chose que cette vidéo doit dire, l'arc narratif et le public.

Barrière : Le type de vidéo, la durée, le format et — surtout — le message et l'arc narratif sont verrouillés. Sans cela, l'Étape 3 ne peut pas écrire un storyboard axé sur le concept.


Étape 3 : Storyboard + Script 💬

Lire : references/step-3-storyboard.md

Écrivez le storyboard en commençant par le concept : message → arc narratif → beats qui servent l'arc → techniques par beat → accents de marque à la fin. Ensuite, écrivez le script de narration pour correspondre. Présentez les deux à l'utilisateur avec un résumé beat par beat. Itérez jusqu'à approbation.

Barrière : STORYBOARD.md + SCRIPT.md existent ET l'utilisateur a approuvé le plan.


Étape 4 : VO, Timing et Sous-titres 💬

Lire : references/step-4-vo.md

Si l'Étape 2 a dit pas de narration — demandez la musique de fond, puis passez à l'Étape 5. Sinon : demandez à l'utilisateur quel fournisseur TTS (HeyGen TTS, ElevenLabs ou Kokoro), générez l'audio, transcrivez, mappez les horodatages aux beats. Ensuite, demandez les sous-titres.

Barrière : Soit (a) aucune narration n'a été demandée et le storyboard a des timings de beat manuels, soit (b) narration.wav + transcript.json existent et les timings de beat sont mis à jour avec les durées réelles.


Étape 5 : Construire les Compositions

Lire : La compétence hyperframes (chargez-la — chaque règle compte) Lire : references/step-5-build.md

Construisez index.html et les compositions en suivant l'architecture et le rythme choisis dans le storyboard (Étape 3). Les sous-agents exécutent hyperframes lint et hyperframes snapshot sur chaque beat avant de faire rapport.

Barrière : Chaque compositions/beat-N.html a été lu de haut en bas par l'agent principal par rapport à DESIGN.md et STORYBOARD.md. La liste de vérification par beat se trouve dans step-5-build.md.


Étape 6 : Valider et Livrer

Lire : references/step-6-validate.md

Lintez, validez, prenez des instantanés dimensionnés à la durée de la vidéo (formule : max(beats × 3, ceil(duration_seconds / 2))), et examinez chacun. Corrigez les problèmes avant de livrer. Livrez l'URL du projet Studio localhost — ne rendez en MP4 que sur demande explicite de l'utilisateur. Affichez cette URL Studio seulement lors de la remise — c'est l'aperçu stable final ; les instantanés de la phase de construction sont sans tête, donc n'affichez pas d'aperçu en cours de construction.

Livrez quelque chose dont vous êtes fier. Avant de remettre, demandez-vous : est-ce que je publierais cela sur les réseaux sociaux avec mon nom ? Si non, corrigez ce qui ne va pas.

Barrière : npx hyperframes lint et npx hyperframes validate passent avec zéro erreur, et la réponse finale inclut l'URL active du projet Studio.


Référence Rapide

Types de Vidéos

Contraintes typiques par type de vidéo — utilisez comme point de départ, pas comme une formule. Le nombre de beats doit découler du contenu et de la narration, pas d'une plage cible.

TypeDurée typiquePilote de duréeNarration
Publicité sociale (IG/TikTok)10–15sLimite de la plateformeOptionnelle
Démo produit30–60sLongueur du scriptNarration complète
Annonce de fonctionnalité15–30sComplexité de la fonct.Narration complète
Bande de marque20–45sPiste musicaleOptionnelle, axée musique
Teaser de lancement10–20sÉnergie de l'accrocheMinimale

Le nombre de beats n'est pas intentionnellement dans ce tableau — il doit venir du storyboard, pas de "publicité sociale = 3-4 beats." Une publicité sociale pour un produit complexe pourrait nécessiter 5 beats bien chronométrés. Une bande de marque avec une thèse visuelle forte pourrait nécessiter 3.

Format

  • Paysage : 1920x1080 (par défaut)
  • Portrait : 1080x1920 (Instagram Stories, TikTok)
  • Carré : 1080x1080 (fil Instagram)

Fichiers de Référence

FichierQuand lire
step-0-capture.mdÉtape 0 — capture, comprendre la marque et le produit, écrire un résumé du site axé stratégie
step-1-design.mdÉtape 1 — écrire l'aide-mémoire de marque DESIGN.md (5 sections, 250-350 lignes ; chemin rapide 50 lignes pour les publicités sociales type panneau)
step-2-brief.mdÉtape 2 — aligner le message, l'arc narratif, le public avec l'utilisateur
capabilities.mdÉtapes 2 et 5 — inventaire complet de ce que HyperFrames peut faire (24 sections). Parcourez la TOC pendant le brief, plongez dans les sections spécifiques pendant la construction
step-3-storyboard.mdÉtape 3 — storyboard + script (combinés) avec barrière de révision utilisateur
step-4-vo.mdÉtape 4 — choix du fournisseur TTS, génération, timing
step-5-build.mdÉtape 5 — construction de index.html + compositions
step-6-validate.mdÉtape 6 — lint, validation, instantanés (dimensionnés à la durée de la vidéo), aperçu
techniques.mdÉtapes 3 et 5 — 13 techniques d'animation primitives avec modèles de code (adaptez, ne copiez-collez pas)
html-in-canvas-patterns.mdÉtape 5 — modèles de code complets pour les effets HTML-in-Canvas (réside dans la compétence hyperframes)

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-

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

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-

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