Communitygithub.com

designer-mcp

Créez des vidéos professionnelles et des motion designs à partir de code HTML/CSS/JS avec Hyperframes (v0.8.77) et Brag. Idéal pour les lancements de produits, les démos SaaS, les vidéos explicatives, les animations d'interface et la compilation de compositions en MP4.

Qu'est-ce que designer-mcp ?

Ce skill transforme le code HTML/CSS/JS en vidéos et motion designs programmatiques grâce au moteur Hyperframes (v0.8.77) et à l'outil Brag. Il utilise une approche basée sur des compositions HTML avec des attributs `data-*` pour définir le timing, un rendu Chromium sans tête, et une compilation FFmpeg. Il supporte de nombreux workflows spécialisés (lancements de produits, vidéos explicatives, animations musicales, diaporamas, portage Remotion, etc.) ainsi que des modes opérationnels pour les présentations narratives, les graphiques animés et l'édition multi-pistes. L'agent détecte automatiquement l'état du projet (nouveau ou existant) avant de router la demande vers le workflow approprié, et fournit une chaîne d'outils CLI complète pour la capture, la prévisualisation et le rendu final en MP4.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video
Voir l'original→Voir toutes les compétences

Demander à votre IA préférée

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

Moteur Vidéo (Hyperframes v0.8.77 & Brag)

HyperFrames rend une vidéo à partir de HTML — une composition est un document HTML dont le DOM déclare le timing avec des attributs data-* (data-start, data-duration), dont le moteur d'animation est adressable, et dont la lecture des médias est gérée par le framework.

1. Détection de l'état du projet

Avant d'agir, évalue l'état du projet dans l'ordre suivant :

ÉtatAction
Portage de Remotion vers HyperFramesLis workflows/remotion-to-hyperframes/SKILL.md et exécute directement. Ignore la couche d'intention.
Inspecter, Diagnostiquer, Prévisualiser ou RendreExécute la commande CLI correspondante (npx hyperframes check, preview, render). Ne ré-exécute pas l'ingestion.
Modifier un projet existantExécute npx hyperframes timeline [--json] pour inspecter les pistes, les clips et le timing ; effectue une modification ciblée.
BRIEF.md existeLis workflow et flow depuis le brief ; exécute ce workflow immédiatement.
hyperframes.json ou STORYBOARD.md existeReprend à partir des fichiers de projet existants et des préférences enregistrées.
Nouvelle demande de créationExécute l'ingestion d'intention et route en utilisant la matrice de routage ci-dessous.

Gestion de version CLI

Lors de la reprise d'un projet existant avec des dépendances épinglées dans package.json :

npx hyperframes@latest upgrade --project . --check

Si une mise à jour est disponible et vérifiée, applique-la avec npx hyperframes@latest upgrade --project . et exécute npx hyperframes check.

2. Matrice de routage des intentions

Route les nouvelles demandes de création vers le premier workflow correspondant :

PrioritéType de demandeWorkflow cible
1Port explicite de code Remotionworkflows/remotion-to-hyperframes
2Présentation, pitch deck ou diaporama interactifworkflows/slideshow
3Légendes ou sous-titres textuels simples sur des séquencesworkflows/embedded-captions
4Superpositions graphiques sur tête parlante, interview ou podcastworkflows/talking-head-recut
5Animation synchronisée sur la musique (sans parole)workflows/music-to-video
6Visuel cinétique court et animé (<10s)workflows/motion-graphics
7Explication de pull request GitHub ou de changement de codeworkflows/pr-to-video
8Lancement de produit, vitrine de site web, promo SaaS, /bragworkflows/product-launch-video (ou Mode 1)
9Sujet conceptuel ou documentation explicativeworkflows/faceless-explainer
10Toute autre vidéo personnalisée ou composition multi-pistesworkflows/general-video

3. Modes opérationnels

Mode 1 : Lancement de produit & Vitrine (/brag & product-launch-video)

Utilisé pour les lancements de sites web, les vitrines de produits, les promos SaaS et /brag.

  1. Ingestion & Inspection :
    • Analyse les options : --tone (default, polished, yc-parody, chaotic, cinematic, deadpan, app-store dans references/brag/tones.md), --format (16:9, 9:16, 1:1), --duration (15–25s).
    • Si une URL est fournie, capture les actifs du site en direct : 
      npx hyperframes capture "<URL>" -o ./capture --json
  2. Système de design & Préréglages :
    • Choisis un préréglage de design depuis references/creative/frame-presets/ (capsule, cobalt-grid, daisy-days, etc.) et remixe les jetons de marque : 
      node workflows/product-launch-video/scripts/build-frame.mjs --preset <preset-name> --hyperframes .
  3. Storyboard & Mix audio :
    • Écris STORYBOARD.md et SCRIPT.md.
    • Audio : Sélectionne un fond musical depuis assets/music/ ou utilise /media-use pour résoudre les pistes et la voix off TTS (references/audio/).
    • Exécute l'analyse des repères de rythme : python3 scripts/analyze_music_cues.py --audio <path> --output audio_cues.json.
  4. Validation & Sortie :
    • Vérifie la mise en page et le timing : npx hyperframes check.
    • Compile la vidéo finale : npx hyperframes render --output brag.mp4.
    • Sauvegarde l'image fixe de l'image 0 dans brag.jpg et le texte de publication dans share-copy.txt.

Mode 2 : Vidéos narratives & Explicatives techniques (faceless-explainer, pr-to-video)

Utilisé pour transformer des diffs de code, des documents d'ingénierie ou des sujets complexes en récits vidéo clairs.

  1. Structure narrative : Suis references/creative/references/story-spine.md (accroche, énoncé du problème, architecture/solution, impact).
  2. Formes de plans : Sélectionne des plans directeurs depuis references/animation/blueprints-index.md (éditeur de code, comparaison fractionnée, appel de statistiques, diagramme de flux).
  3. Paquets de travail d'images : Génère des paquets d'agents subordonnés avec workflows/faceless-explainer/scripts/frame-packets.mjs. Chaque image est construite de manière isolée (compositions/frames/NN-*.html).
  4. Assemblage & Audio : Lie les images dans le fichier index.html racine, mélange la piste de voix off avec des enveloppes de réduction de volume, et effectue le rendu.

Mode 3 : Graphiques animés cinétiques & Environnements d'exécution (motion-graphics, music-to-video)

Utilisé pour les graphiques animés autonomes, les composants d'interface animés, les grilles rythmiques et les boucles.

  1. Adaptateurs d'exécution (references/animation/adapters/) :
    • GSAP : Animations multi-propriétés de précision et timelines adressables.
    • Three.js : Vues spatiales 3D, systèmes de particules et modèles (references/animation/adapters/three.md).
    • Lottie : Lecteur d'animation vectorielle (references/animation/adapters/lottie.md).
    • Anime.js / WAAPI : Morphing DOM compact et images clés.
    • Images clés CSS : Transformations accélérées par le matériel.
  2. Transitions de caméra & Morphing (references/keyframes/) :
    • Paniers Ken Burns, zooms avant, morphing de chemins SVG et effets de profondeur.
  3. Blocs de registre & Shaders (references/registry/) :
    • Recherche et installe des blocs d'effets pré-construits (lignes de balayage CRT, glitch, grain de film, balayage scintillant, confettis).

Mode 4 : Compositions personnalisées & Montage multi-pistes (general-video, slideshow)

Utilisé pour les pitch decks interactifs, le montage multi-pistes et les vidéos HTML personnalisées.

  1. Conventions du studio (references/studio/studio-conventions.md) :
    • Chaque scène est une sous-composition (data-composition-src).
    • Une piste de légendes (data-track-kind="captions").
    • Un type d'élément par piste (vidéo, graphiques, légendes, audio).
    • Conformité aux zones de sécurité (boîtes de sécurité pour titres/actions Premiere).
  2. Recettes de création inter-domaines :
    • Coupures & Montages : Mets à jour data-start, data-duration et data-media-start (references/core/tracks-and-clips.md).
    • Zoom fluides : Anime l'encapsuleur de recadrage intérieur avec CSS/GSAP tout en maintenant le timing du clip stable (references/keyframes/).
    • Gain audio & Réduction de volume : Applique des enveloppes de volume et une compression de bus (references/audio/).

4. Vérification & Chaîne d'outils CLI

Exécute toujours les passerelles de validation avant la livraison :

# Initialise un nouveau projet Hyperframes avec une structure de workflow
npx hyperframes init "videos/<project>" --skill=<workflow-name>

# Capture les actifs web en direct, les captures d'écran et les jetons de marque
npx hyperframes capture "<URL>" -o ./capture --json

# Inspecte la timeline de la composition, les pistes et les clips
npx hyperframes timeline [--json]

# Valide les attributs de timing, les zones de sécurité et les actifs manquants
npx hyperframes check

# Lance le lecteur local interactif
npx hyperframes preview

# Effectue le rendu final en MP4
npx hyperframes render --output output.mp4

5. Plan du répertoire

CheminObjectif
workflows/Les 11 workflows en amont (product-launch-video, faceless-explainer, pr-to-video, motion-graphics, etc.)
engine/Suites de paquets canoniques Hyperframes v0.8.77 en amont
references/core/Attributs de timing, règles de déterminisme, modèles de piste, sous-compositions
references/animation/Adaptateurs GSAP, Three.js, Lottie, Anime.js, CSS, plans directeurs, flou de mouvement
references/keyframes/Transitions de caméra 2D/3D, zooms, morphing SVG, effets de profondeur
references/audio/EQ, réduction de volume, compression, enveloppes d'automatisation de bus de sous-mixage
references/creative/Spécifications de design, typographie, palettes, préréglages d'images, structure narrative
references/registry/Blocs visuels, composants shader, installation et câblage
references/studio/Mise en page de la timeline du studio, pistes de légendes, zones de sécurité
references/brag/Guides /brag curatés étape par étape, tonalités et repères musicaux
assets/music/Fonds musicaux curatés dans les genres cinématique, hype, indie, calme
scripts/analyze_music_cues.py, noyau de paquets d'images et extracteurs audio

Individual skills in this repo

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

1999AZZAR/designer-mcp

SOTA animation and physics heuristic guide using motion.dev

1999AZZAR/designer-mcp

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

1999AZZAR/designer-mcp

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

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

1999AZZAR/designer-mcp

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.

1999AZZAR/designer-mcp

Use when building or editing a HyperFrames project that people open in Studio: 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`.

1999AZZAR/designer-mcp

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

1999AZZAR/designer-mcp

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

1999AZZAR/designer-mcp

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

1999AZZAR/designer-mcp

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

Skills associés

steipete/video-frames

Extract frames or short clips from videos using ffmpeg.

community

steipete/summarize

Summarize or transcribe URLs, YouTube/videos, podcasts, articles, transcripts, PDFs, and local files.

community

openclaw/openclaw

Use when testing, fixing, or extending the OpenClaw Control UI GUI with Vitest + Playwright end-to-end checks, mocked Gateway WebSocket flows, mocked dashboard runs, screenshots/videos, or agent-verifiable browser proof.

community

obra/superpowers

Obra superpowers agent skills.

community

affaan-m/ECC

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio...

community

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

community