Communitygithub.com

Malik-rgb43/workflow-édition

Concevez, construisez et révisez un projet de motion design dans HyperFrames/GSAP : lancement de produit ou d'application, annonce de fonctionnalité, typographie cinétique, logo reveal, explicateur d'interface, captures d'écran animées. Déclencheurs : motion design, animation, lancement, typographie cinétique, logo animation, « comme un lancement Higgsfield / Linear ». Pas pour un montage tête-parlante, des plans générés par IA, un travail de sous-titrage ou une conformité publicitaire.

Qu'est-ce que workflow-édition ?

Cette compétence spécialisée est conçue pour les agents IA (comme Claude Code, Cursor, Codex) afin de créer des animations graphiques de qualité professionnelle dans HyperFrames/GSAP. Elle gère l'ensemble du flux de production : depuis l'analyse initiale du brief jusqu'au rendu final MP4, en passant par la rédaction de spécifications image par image, le design, la construction du code, la révision et le QA. La compétence impose des règles strictes, comme l'approbation humaine obligatoire avant tout code, l'absence de dépenses externes (pas de génération IA payante), et une séquence de révision précise (aperçu Studio, rendus partiels, puis rendu complet). Elle propose cinq registres distincts (lancement, cinétique, logo, explicateur, calme), chacun avec son propre rythme, cadence d'événements, caméra et traitement sonore. La compétence inclut un processus de QA rigoureux avec des portes de validation qui bloquent ou font échouer le rendu si les critères ne sont pas remplis (spécifications, palette, son, sécurité des chemins), garantissant ainsi des résultats fiables et reproductibles, tout en évitant les erreurs coûteuses. L'accent est mis sur l'efficacité : un brouillon de 30 à 45 secondes est livrable en 3 à 4 heures avec 1 à 2 cycles de correction.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/edit-motion-graphics

Demander à votre IA préférée

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

Documentation

édition-motion-graphics

Propriétaire du résultat pour un motion design terminé (MP4) construit comme une page HTML HyperFrames + une timeline GSAP en pause. Le PROMPT.md au niveau de l'image est le produit ; le code ne fait que le rendre.

Règles non négociables (à lire en premier)

  1. Pas de code avant un PROMPT.md approuvé au niveau image – même en exécution autonome : l'agent rédige, un humain approuve (décision par défaut Q6). L'approbation est une ligne enregistrée APPROVAL: <qui> <date> dans le fichier. L'ordre des modifications est toujours registre -> PROMPT.md -> code.
  2. Pas de dépense ici. Les rendus IA-3D, images IA ou toute génération payante passent par paid-generation-gate ; cette compétence n'effectue aucun appel payant. Un catalogue n'est pas un accès au compte.
  3. Ordre de révision : Aperçu Studio -> plages hf_segment -> UN rendu complet par série de notes -> QA de chaque image sur le rendu final. Un seul travail lourd à la fois (render_lock). Regroupez les notes ; diagnostic pendant que l'utilisateur écrit encore, mais ne lancez pas de rendu.
  4. Pièges durs : pas de dir="rtl" sur la racine HyperFrames (RTL uniquement sur les éléments de texte, lang="he" sur <html>) ; polices depuis des fichiers (@font-face dans hf/fonts/) ; hyperframes snapshot --describe false, <= 5 horodatages par appel ; racine du travail en ASCII (new_project).
  5. Échec fermé : une porte qui ne peut pas s'exécuter est blocked (not_run), jamais pass. Un délai d'attente, un échantillon vide ou un rendu manquant ne passent jamais. Un appel d'outil réussi est une preuve d'exécution ; un rendu visualisé est une preuve d'apparence ; une image fixe ne peut pas prouver le mouvement.
  6. Loi vs goût : les règles 1 à 5 sont la loi. Les éléments marqués style studio ci-dessous (pas de sous-titres par défaut, liste interdite, « pas de rose », grammaire Higgsfield, 21e siècle) sont le goût du propriétaire, enseignés avec leur raison ; un brief qui dit autrement l'emporte sur le goût, jamais sur les portes.
  7. Les nombres portent leur fps (30 sauf indication contraire du brief) et les temps mesurés portent la machine (propriétaire Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 Go). Les temps NVIDIA/Apple ne sont pas mesurés. Les projets limitant les dépenses, les installations ou les publications remplacent cette compétence.

Entrées -> sorties

Entrée : brief/registre (depuis video-intake), kit de marque, captures d'écran ou composants d'interface, musique/voix off. Sortie : hf/PROMPT.md (niveau image), hf/DESIGN.md (une palette verrouillée + type + jetons de mouvement), hf/cues.js (source de synchronisation unique pour l'image et le son), hf/SOURCES.md, la composition, mix.wav, le MP4 final, les rapports QA. Transferts : notes -> revision-round ; autres ratios -> multi-video-variants (réagencement complet, jamais un recadrage) ; porte de livraison -> render-qa-deliver ; une référence donnée -> reference-style-transfer d'abord (pas de référence -> demander quelle plage de temps est « le style »).

Procédure

  1. Enregistrer + réception. Choisir un registre (launch | kinetic | logo | explainer | calm) et verrouiller la durée, les ratios, la voix off, la musique, le nom du livrable (references/launch-register-and-pace.md). Un lancement dense de 30 s semblait 1,7× trop rapide ; la durée approuvée était de 45 s : décidez la durée en premier.
  2. Rédiger PROMPT.md + DESIGN.md (6 blocs ; les tables de caméra, couture et événements ; fiches de battement pour toute 3D). Exécutez python scripts/motion_spec_check.py hf/PROMPT.md --register <r> ; corrigez ; demandez approbation.
  3. Battements sources (references/ui-sources-and-port.md) : catalogue -> hf-blocks -> registres shadcn (par défaut) -> 21st.dev uniquement avec un compte -> construction manuelle ; décidez 3D par battement (references/three-d-decision.md).
  4. Construire un index.html + cues.js ; les composants portés sont ré-écrits pour être sûrs en lecture. Puis hf_preflight --strict, python scripts/seek_safe_scan.py hf/, python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <rendus 3D>].
  5. Approuver visuellement : quatre images fixes + un instantané de chaque couture + planche contact sheet ; aperçu Studio ; notes regroupées.
  6. Son (references/sound-and-captions.md) : hf_mix --report ; son de marque sur chaque événement de marque ; mixage et mesure du fichier final.
  7. Un rendu complet sous verrou avec une ETA d'abord ; frame_qa, motion_qa, hf_deliver ; notez avec agent-content/benchmarks/motion-graphics.rubric.md en utilisant un critique séparé ; présentez le fichier, les modifications numérotées, le registre coché et les lacunes honnêtes.

Registre en un coup d'œil (détails : references/launch-register-and-pace.md)

RegistreNouvel écranCadence événementsCaméraSon
launchtoutes les 2-6 s, >= 2 couches de profondeur<= 0,5-1 s ; 45-110/min comptés à la mainne s'arrête jamais (dérive 2-4 %/s, push-ins 8-15 %)la musique est le SFX ; son de marque sur chaque événement de marque ; ring-out
kinetictoutes les 1-3 sjusqu'à ~200/min (les changements de mot comptent)la typographie est la camérale mot-clé atterrit 0..+7 images après qu'il soit prononcé
logoune idée, 3-8 srésultat visible à 0,4-0,75 sun mouvement + stabilisationson de marque sur le reveal ; fin en 3 étapes
explainerpar idée, 3-6 s30-110/minintentionnel, vers l'objet expliquémené par la voix off ; SFX uniquement sur changement visible
calmles plans tenus sont autorisésle clairsemé est acceptablelent ou fixeun seul lit uniforme + bruitage subtil ; pas de montées/descentes

3D par battement en cinq lignes

Décidez par battement, écrivez la raison dans PROMPT.md : Blender pour géométrie réelle / matériau héros à l'écran > 2 s (EEVEE d'abord ; mesuré 1,2-2,25 s/image à 384-640 px, +1-1,5 min par lancement) ; Three.js pour battements data-driven, instanciés, UI-3D-avec-texte-vivant, édition en cycles ou hexadécimaux exacts, après une porte AMD hf_segment de 1 s ; AI-3D uniquement derrière paid-generation-gate et une vérification de licence ; 2.5D (depth_25d, Depth Anything V2 Small, 8,1-9,9 s par clip de 2 s) pour une image fixe qui nécessite un petit mouvement ; aucun pour les battements UI/message. Un objet 3D ne couvre jamais l'information et réagit au mot.

« Ennuyeux / semble IA / statique » à un horodatage

Remplacez le concept du battement, ne le peaufinez pas. Choisissez dans le menu : une sphère vocale pilotée par le spectre réel de la voix off ; une construction data-driven (barres, compteurs, globe d'itinéraire) ; l'interface reconstruite en code et filmée comme un objet (perspective, profondeur de champ, grossissement 150-300 %) ; un morphing d'élément partagé qui porte le contenu ; un échange de nombre ou de mot sur place ; un héros 3D atterrissant sur le mot-clé. Jamais un petit « pillule de fonctionnalité » dans un coin, une capture d'écran plate avec un petit push-in, ou un point sur fond noir. Ajoutez la note à la ligne Interdit et corrigez-la à chaque occurrence (règle globale quand elle se répète).

Budget temps (modélisé ou mesuré sur la machine du propriétaire ; pas des mesures d'étudiant)

Objectif : premier brouillon présentable d'un lancement de 30-45 s en environ 3-4 h avec 1-2 cycles de correction (le premier vrai lancement a pris 10 brouillons, 7 cycles de critique, 4 cycles de notes du propriétaire) ; exactement UN rendu complet par cycle. Référence de rendu (HyperFrames 0.8.98, E11, lourd 40 s / 1200 i) : 1 worker 132,6 s, 4 workers 92,8 s, 8 workers 88,1 s ; GPU navigateur -12 % ; la capture est le goulot d'étranglement (utilisation CPU seulement 2-3 sur 16 cœurs logiques). Rendu premium antérieur : 8-14 min typique, 4-21 observé (0.8.79-0.8.93). Toujours benchmarker une unité et poster une ligne d'ETA avant un travail de plus de 3 minutes.

Portes

États : pass | fail | blocked | n/a, toujours avec une raison.

PortePrédicatPreuveSi fauxPropriétaireRe-vérification
G0 réceptionregistre, durée, ratios, nom du livrable, source VO/musique, réponse référence enregistréshf/BRIEF.mddemander (3-4 questions par série) ; blockedvideo-intakechangements de brief
G1 spécification image6 blocs ; chaque battement a images + px + easing + son + transition ; ligne Interdit ; palette hex ; ligne APPROVAL:motion_spec_check.py exit 0 (2 = approbation manquante = blocked)corriger la spécification ; arrêter avant le codecette compétence + approbateur humaintout retiming ou nouveau battement
G2 propre et fluideUNE spline par scène, chaque mouvement >= 1,2 s, inversions >= 1 s et <= 1,3x, texte dans le cadre à chaque clé ; coutures sortie = entrée, héros persiste, pas de technique répétée, pas de fondutables dans PROMPT + vérificateur ; motion_qa 0 plages de bégaiement sur le rendure-timing / re-chemin ; remplacer le concept du battement plutôt que peaufinercette compétencetout changement de caméra ou de couture
G3 densitépar registre : lancement = nouvel écran toutes les 2-6 s, écarts d'événements <= 0,7 s (respirations déclarées exceptées), 45-110 événements/min (comptage manuel)Table des événements + 3 échantillons d'images par scèneajouter ou remplacer des battements ; étirer les longs mouvements x1,6 au lieu de tassercette compétenceaprès tout retiming
G4 3D par battementchaque battement 3D a une fiche : route (Blender / Three.js / AI-3D / 2.5D / aucun), une phrase de raison, ETA, preuve de porte, licencetableau des fiches de battement ; lignes Three.js : une image hf_segment de 1 s qui n'est pas videre-décider ; les lignes AI-3D nécessitent paid-generation-gatecette compétencenouveau battement ou nouvel asset
G5 verrouillage paletteune table de palette ; chaque hex dans les sources et chaque rendu 3D à l'intérieurpalette_audit.py exit 0 (+ --png)recoloration / re-rendu ; blocked si pas de tablecette compétencenouvel asset, nouveau rendu, note de couleur
G6 sourçage UIchaque battement UI/effet a une ligne SOURCES.md (origine, licence, version, date) et un port sûr en lecture ; pas de npx shadcn add dans un projet ; pas d'aperçu/media 21st copiéSOURCES.md + scanchanger de source ou construire à la main avec une raisoncette compétencenouveau composant
G7 sûr en lecturehf_preflight --strict 0 erreurs ; seek_safe_scan.py 0 erreurs ; les instantanés à des moments non séquentiels concordentrapports + paire d'instantanéscorriger ; ne jamais « corriger » en supprimant sans raisoncette compétenceaprès chaque patch de code
G8 sonson de marque sur chaque événement de marque ; SFX sous VO entre -18..-26 dB et 1-3 i avant l'image ; la musique s'éteint ; fichier final -14 LUFS +-0,5, TP <= -1 (preset maison v1, Q5)hf_mix --report, hf_deliver vérifient sur le fichier FINALre-mixer et remuxer (pas de re-rendu)render-qa-deliver mesuretout retiming audio ou image
G9 sous-titresaucun élément de sous-titre sauf si le brief le demandegrep des ids/classes + ligne <direction>supprimer / demander en une lignecette compétencechangement de brief
G10 rendu + QAUN rendu complet ce cycle ; frame_qa 0 drapeaux ; moyenne évaluation rubrique >= 4,0, aucune dimension < 3, M1/M3/M7 >= 3 ; chaque ligne du registre cochéeRapports QA + sortie du critiqueretour à la porte défaillante ; max un cycle de correction avant escaladerender-qa-deliverchaque rendu complet

Enregistrement des résultats de porte (hf/QA.md, une ligne par porte)

G1 pass   motion_spec_check exit 0, 24 beats, approval "<qui> 2026-10-02"  (re-run after r2 retime: pass)
G5 blocked  3D render coin_r2.png not readable by palette_audit (not_run) - install Pillow or downscale
G7 fail   seek_safe_scan SS02 index.html:211 Math.random -> seeded hash; rescan pending

Une porte sans ligne est not_run. N'écrivez jamais pass de mémoire d'un cycle précédent : un retiming, un nouvel asset ou un patch l'invalide (voir la colonne Re-vérification).

Présenter un brouillon (render-qa-deliver possède la porte de livraison)

Message = le fichier immédiatement + modifications numérotées (selon les propres numéros de notes de l'utilisateur) + le registre avec chaque ligne cochée + le score de la rubrique du critique séparé + les lacunes (ce qui n'a PAS été vérifié : relecture hébreu, superposition d'appareil, sonorité sur un téléphone) + le lien Studio. Ne présentez jamais avec une image signalée, une porte échouée ou une ligne de registre non cochée.

Références (charger quand)

  • references/seam-camera-event-tables.md – TOUJOURS lors de l'écriture ou de la révision de PROMPT.md ; aussi agent-content/techniques/frame-spec-prompt.md et clean-smooth-motion.md.
  • references/launch-register-and-pace.md – choix du registre, plaintes de rythme, liste interdite, nombres d'easing.
  • references/three-d-decision.md – tout battement avec profondeur ou 3D ; agent-content/techniques/2-5d.md pour le 2.5D.
  • references/ui-sources-and-port.md – cartes UI, effets, animation de capture d'écran ; agent-content/techniques/screenshot-rebuild.md.
  • references/seek-safe-and-render-traps.md – écriture de code, patches, différences de rendu.
  • references/palette-lock.md, references/typography-hebrew-kinetic.md, references/sound-and-captions.md – DESIGN.md, typographie hébreu, le plan sonore.
  • references/dated-versions.md – pins et licences (datés ; expiré = inconnu).
  • Scripts (python <script> --self-check d'abord) : motion_spec_check.py, palette_audit.py, seek_safe_scan.py. Ils vérifient le texte et les motifs, jamais l'apparence.

Arrêter et escalader

Bloqué, pas deviné : pas de ligne d'approbation ; aucun rendu possible ; une entrée de porte manquante ; un prix ou une licence inconnu ; un battement Three.js dont le segment de 1 s est vide sur AMD (retomber sur un sprite Blender). Demandez avant toute dépense, installation, publication ou message à un tiers. Ne messageriez jamais d'autres sessions d'agent. Une note utilisateur « ennuyeux / semble IA / statique » à un horodatage signifie remplacer le concept du battement à partir du menu du registre, en une ligne d'explication.

Maintenance

Les faits volatils vivent uniquement dans references/dated-versions.md et les modules datés globaux (hyperframes-traps.md, three-d-routes.md, audio-mix.md). Ajoutez chaque nouvelle note du propriétaire à la ligne Interdit, pas à ce fichier. Vérifications spécifiées et déterministes uniquement ; évaluation de modèle non exécutée (décision par défaut Q4).

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

Skills associés