Communitygithub.com

9018/mychat

À utiliser lorsque l'utilisateur souhaite un court motion design animé où le mouvement est le message : typographie cinétique, compteur statistique ou numérique, animation de graphique/données, sting logo, habillage de marque, tiers inférieur, légende, superposition sociale, titre/tweet/actualité animé, affiche animée ou mise en évidence rapide d'une page. Généralement moins de 10 secondes et jusqu'à ~30 secondes, sans arc narratif, voix off ou sujet en prise de vue réelle. Peut être rendu en MP4 ou en superposition transparente. Ne convient pas aux pièces plus longues, multi-scènes, narrées ou aux bandes de marque (utiliser general-video), aux vidéos de sites web narrées (website-to-video), aux explications de sujets (faceless-explainer), aux promotions de produits (product-launch-video), aux vidéos RP (pr-to-video) ou aux sous-titres sur des séquences existantes (embedded-captions). En cas de doute entre une pièce courte axée sur le mouvement et un traitement plus long/narré, consulter /hyperframes.

Qu'est-ce que mychat ?

La compétence **motion-graphics** (une *skill* pour agent d'IA dans l'écosystème **hyperframes**) est spécialisée dans la réalisation de **courts motion designs graphiques, sans narration**. Elle excelle dans la production de pièces comme la typographie cinétique, les compteurs de statistiques, les animations de graphiques, les stings de logo ou les superpositions sociales, typiquement d'une durée inférieure à 10 secondes (jusqu'à ~30 secondes). L'agent ne doit pas l'utiliser pour des vidéos plus longues, narrées ou avec prise de vue réelle – dans ces cas, il existe d'autres skills spécialisées comme `/general-video` ou `/product-launch-video`. Cette compétence suit un flux de travail structuré en plusieurs étapes, dont la particularité est l'approche **« asset-first »** : elle décide d'abord si une recherche d'actifs (images, pages web, tweets) est nécessaire, puis conçoit le plan de la séquence en fonction des actifs réellement disponibles. Elle prend en charge deux grandes familles de catégories : les catégories **formelles** (sans recherche, le contenu est fourni par l'utilisateur) comme `kinetic-type` ou `stat`, et les catégories **pilotées par la recherche** (comme `webpage`, `news`, `tweet`) qui nécessitent une étape de sourcing préalable. Le rendu final s'effectue via `npx hyperframes render`, produisant un fichier MP4 ou un format transparent (WebM/MOV) pour superposition. Le système repose sur un agent **Director** pour la planification et la conception, et un agent **Builder** pour la construction, en privilégiant la réutilisation de blocs catalogue et de règles d'animation partagées. Il nécessite un environnement macOS Apple Silicon ou Linux x64 avec Node.js, FFmpeg et une configuration GPU matérielle optionnelle. Des clés API (Gemini, services de recherche) peuvent être nécessaires pour la génération ou la recherche d'actifs.

Compatible avec~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/9018/mychat/tree/HEAD/OpenMontage/.agents/skills/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

motion-graphics — point d'entrée de dispatch

Confirmer la route avant l'étape 0. Cette compétence réalise un court motion design graphique, non narré (le mouvement est le message ; ~moins de 10s, pas de voix off). Un traitement plus long, multi-scènes ou narré → /general-video ; une vidéo narrée d'un site web → /website-to-video ; une vidéo explicative d'un sujet → /faceless-explainer ; une promotion de produit → /product-launch-video ; des sous-titres sur des séquences existantes → /embedded-captions. Hors périmètre : données en direct / au moment du rendu, ou séquences impossibles à capturer. Doute entre une pièce axée sur le mouvement ou une pièce narrée ? Lire /hyperframes d'abord.

Un court motion design graphique. Asset-first : décider la stratégie d'actifs et sourcer le matériel réel avant de concevoir le plan, puis concevoir le plan autour de ce que vous avez, puis composer en réutilisant les capacités du catalogue. Tous les artefacts vont dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'étape 0) ; tous les chemins ci-dessous sont relatifs à ce répertoire.

PhaseExécutionArtefact principalFlux détaillé
initBashhyperframes.jsonÉtape 0
plansous-agent — décider la recherche ? + classer + stratégie d'actifsshot-plan.json (brouillon : catégorie, requêtes asset_needs, briefing)agents/director.md (Partie 1)
source ◇Bash — résolution des médias (ignorer si asset_needs est vide)assets/ + assets/index.mdphases/source/guide.md
designsous-agent — conception du plan autour des actifs résolusshot-plan.json (final : bloc(s) + disposition + mouvement + positions)agents/director.md (Partie 2)
buildsous-agent — composition priorisant la réutilisationcompositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4, ou --format webm/mov pour superposition)renders/video.mp4Étape 5
verifyBash — lint / inspect -> sous-agent de réparation en cas d'échec(correctifs sur place)agents/finalize.md

◇ source s'exécute uniquement lorsque la catégorie choisie déclare des actifs. Les catégories purement code/texte (ex. kinetic-type, la plupart des charts/stat) ont asset_needs: [] et passent directement de la planification à la conception.

Catégories — divisées par la décision de recherche

La première décision de plan est : cela nécessite-t-il une recherche ? Cette bifurcation divise les catégories en deux groupes ; puis la catégorie spécifique est choisie — pour les catégories pilotées par la recherche, selon le type de contenu que la recherche retourne. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé se trouve dans references/motion-vocabulary.md (→ règles/blueprints hyperframes-animation + blocs de registre).

Catégories formelles — pas de recherche ; l'utilisateur fournit le contenu :

CatégorieIntentionS'appuie sur
kinetic-typeligne / citation / titre percutant, texte axé mouvementblocs caption-* + règles d'animation
statnuméro unique / compteur héro + anneauapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsgraphique barre / ligne / camembert / course / % à partir de donnéesbloc data-chart
logo-revealsting logo / habillage de marque (logo utilisateur)logo-outro / rules/svg-path-draw
lower-thirdsbarres nom / titre, légendes, superpositions socialescaption-* + blocs de superposition du registre

Catégories pilotées par la recherche — rechercher d'abord, puis animer selon le type de contenu (le chemin RWA) :

Contenu retournéCatégorieAnimation
page web / lienwebpageanimation de page web / UI (défilement, révélation, curseur, légendes)
article de pressenewsrévélation de titre + carte source + légendes de faits clés
tweettweetcarte tweet animée
image / entitéasset-fusionla géométrie de l'actif devient le graphique (fusion diégétique RWA)

Ordre de construction : un à la fois, priorité à la couverture (un brouillon est acceptable). kinetic-type porté depuis le prototype ; le reste suit.

Prérequis

macOS Apple Silicon ou Linux x64. Outils système : brew install node ffmpeg. npx hyperframes doctor une fois. Rendu GPU macOS : export PRODUCER_BROWSER_GPU_MODE=hardware.

Clés optionnelles (alternatives locales si non définies) — nécessaires uniquement pour les catégories qui sourcent/génèrent des actifs via media-use :

CléUtilisée pourAlternative par défaut
GEMINI_API_KEY / GOOGLE_API_KEYgénération d'images (résolution media-use)ignorer la génération / recherche seule
(fournisseurs asset_scout / recherche)webpage/news/tweet + recherche d'actifs réels asset-fusionla catégorie se dégrade en version sans actifs

Flux

Étape 0 — Initialisation

le répertoire de travail (cwd) est la racine de l'espace de travail de l'agent ; écrire tous les artefacts sous PROJECT_DIR = videos/<nom-du-projet>/. <nom-du-projet> : utiliser le répertoire donné par l'utilisateur, sinon un nom court en kebab-case dérivé de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ni un horodatage.

Uniquement lorsque $PROJECT_DIR/hyperframes.json est absent :

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<nom-du-projet>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank

init vérifie les compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si l'une d'elles est obsolète.

Contraintes : ne jamais exécuter hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre hyperframes/ à l'intérieur de PROJECT_DIR ; chaque commande Bash (maître + sous-agents) est un sous-shell (cd "$PROJECT_DIR" && ...) — jamais de cd nu.

Étape 1 — Planification (sous-agent : Director Partie 1)

Lancer un sous-agent. invite = contenu complet de agents/director.md + ## Contexte de dispatch (SKILL_DIR / PROJECT_DIR / la demande de l'utilisateur / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Il doit :

  1. Décider : cela nécessite-t-il une recherche ? (la première bifurcation)
    • Non → choisir une catégorie formelle (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ; asset_needs: [].
    • Oui → émettre un plan de recherche dans asset_needs[] (actualité / web / tweet / image ; requêtes bipolaires). La catégorie pilotée par la recherche spécifique (webpage / news / tweet / asset-fusion) est confirmée par le type de contenu retourné à l'étape 2, et finalisée à l'étape 3.
  2. Écrire un brouillon de shot-plan.json (enveloppe + catégorie formelle choisie ou intention de recherche + asset_needs + un briefing d'un paragraphe). Schéma : references/shot-plan-ir.md.

Validation : [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.

Étape 2 — Source ◇ (Bash : media-use, conditionnel)

Si shot-plan.json.asset_needs n'est pas vide, résoudre les actifs (recherche / génération / récupération → chemins locaux figés dans le projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories pilotées par la recherche utilisent la recherche d'actualités/web/tweet/image). Si asset_needs est vide, passer à l'étape 3.

# illustratif — voir phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

Dégradation gracieuse : si une recherche/un fournisseur est indisponible, la catégorie revient à une version sans actifs (le noter dans context.log).

Étape 3 — Conception (sous-agent : Director Partie 2)

Lancer un sous-agent (invite = agents/director.md Partie 2 + contexte de dispatch incluant le assets/index.md résolu si l'étape 2 a été exécutée + catalog-map.md). Il conçoit le plan autour des actifs disponibles : choisir le(s) bloc(s) catalogue + les règles/blueprints hyperframes-animation, la disposition, le mouvement, les temps, et (pour asset-fusion) les element_positions + la palette de prélèvement de couleurs. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).

Étape 4 — Construction (sous-agent : Builder, priorité à la réutilisation)

Lancer un sous-agent. invite = contenu complet de agents/builder.md + contexte de dispatch (shot-plan.json, catalog-map.md, le module.md de la catégorie, references/motion-vocabulary.md, references/builder-contract.md). Priorité à la réutilisation : npx hyperframes add <block> + personnaliser sur place ; n'écrire à la main que les lacunes + l'ouverture de fusion d'actifs. Produire compositions/index.html respectant le contrat HF (timeline GSAP en pause sur window.__timelines, class="clip" + ids stables, tl.seek(0), déterministe).

Étape 5 — Rendu (Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# variante superposition transparente : --format webm (ou mov)

Étape 6 — Vérification (Bash → sous-agent de réparation en cas d'échec)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

code de sortie 0 → terminé. En cas d'erreurs de lint/inspect, lancer le sous-agent de réparation (agents/finalize.md : QA instantané + un passage de correctif sur place + re-rendu). Ne jamais modifier une durée fixe lors de la réparation.

Rapport + aperçu optionnel

Signaler la sortie finale (renders/video.mp4, ou la variante .webm / .mov pour superposition) + durée. Ne pas ouvrir d'aperçu pendant l'exécution. N'en proposer un que sur demande, lancé après le rendu pour qu'il serve le fichier final :

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Interface Studio ; ou `npx hyperframes play` pour un lien partageable

Les options se trouvent dans la compétence hyperframes-cli (references/preview-render.md).

Tableau de reprise

ÉtatContinuer depuis
pas de shot-plan.jsonÉtape 1 (planification)
shot-plan.json a asset_needs, pas de assets/Étape 2 (source)
shot-plan.json final, pas de compositions/index.htmlÉtape 3/4 (conception+construction)
compositions/index.html existe, pas de renders/video.mp4Étape 5 (rendu) + Étape 6
renders/video.mp4 existeRapport + arrêt

Notes de conception (mainteneurs — l'exécution ne lit pas ceci)

  • Raisonnement Asset-first : le sourcing est réalisé en amont et informe la conception du plan (le flux RWA : analyser → rechercher → examiner → composer). Les catégories pilotées par la recherche (webpage/news/tweet) et asset-fusion s'appuient toutes sur la recherche media-use (actualités/web/tweet/image), qui est la lignée RWA documentée de media-use.
  • Priorité à la réutilisation : l'analogue dans l'écosystème des modèles générés par LLM est « composer des blocs catalogue + règles hyperframes-animation ». La timeline GSAP en pause de HF équivaut à useCurrentFrame de Remotion.
  • Contrat du module de catégorie : un categories/<id>/module.md (planification + construction), partageant references/motion-vocabulary.md (+ évaluation optionnelle). Ajouter une catégorie = déposer le dossier + enregistrer sa ligne de classifieur dans agents/director.md + sa ligne dans catalog-map.md ; le pipeline de phases est inchangé.
  • Structure du répertoire :
    videos/<nom-du-projet>/
      hyperframes.json  context.log
      shot-plan.json            # le RI (sortie du Director)
      assets/  assets/index.md  # sortie media-use (si sourcé)
      compositions/index.html   # sortie du Builder
      renders/video.mp4
    
  • Enregistrement : dans le routeur hyperframes — ajouter l'intention « court motion design graphique conçu » + la description du Workflow ; retirer les déclencheurs motion-graphics de /general-video ; ajouter les arêtes inverses « NE PAS UTILISER ». Voir motion-graphics-genre.md §5-7.

Individual skills in this repo

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

9018/mychat

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

9018/mychat

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

9018/mychat

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

9018/mychat

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

9018/mychat

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

9018/mychat

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

9018/mychat

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

9018/mychat

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

9018/mychat

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

9018/mychat

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

9018/mychat

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

9018/mychat

Download video and audio from YouTube and 1000+ sites using yt-dlp. No API keys needed. Use when: (1) Downloading a video from YouTube or other sites, (2) Extracting audio from a video URL, (3) Downloading subtitles/captions from a video, (4) Getting video metadata without downloading.

Skills associés