Communitygithub.com

1999AZZAR/designer-mcp

Master programmatic video and motion graphics engine using Hyperframes (v0.8.77) and Brag. Renders video from HTML/CSS/JS compositions using seekable timelines, headless Chromium frame capture, and FFmpeg compilation. Use for product launches (/brag), SaaS promos, technical explainers, PR demo videos, kinetic UI animations, beat-synced music videos, slideshow pitch decks, Remotion ports, captions, and compiling compositions to MP4.

What is designer-mcp?

designer-mcp is a Claude Code agent skill that master programmatic video and motion graphics engine using Hyperframes (v0.8.77) and Brag. Renders video from HTML/CSS/JS compositions using seekable timelines, headless Chromium frame capture, and FFmpeg compilation. Use for product launches (/brag), SaaS promos, technical explainers, PR demo videos, kinetic UI animations, beat-synced music videos, slideshow pitch decks, Remotion ports, captions, and compiling compositions to MP4.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1999AZZAR/designer-mcp/tree/HEAD/skills/video
View original→Browse all skills

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

Video Engine (Hyperframes v0.8.77 & Brag)

HyperFrames renders video from HTML — a composition is an HTML document whose DOM declares timing with data-* attributes (data-start, data-duration), whose animation runtime is seekable, and whose media playback is owned by the framework.

1. Project State Detection

Before taking action, evaluate project state in order:

StateAction
Port Remotion to HyperFramesRead workflows/remotion-to-hyperframes/SKILL.md and execute directly. Skip intent layer.
Inspect, Diagnose, Preview, or RenderRun corresponding CLI command (npx hyperframes check, preview, render). Do not re-run intake.
Edit Existing ProjectRun npx hyperframes timeline [--json] to inspect tracks, clips, and timing; perform targeted edit.
BRIEF.md ExistsRead workflow and flow from brief; execute that workflow immediately.
hyperframes.json or STORYBOARD.md ExistsResume from existing project files and recorded preferences.
Fresh Creation RequestRun intent intake and route using the Routing Matrix below.

CLI Version Management

When resuming an existing project with pinned dependencies in package.json:

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

If an update is available and verified, apply with npx hyperframes@latest upgrade --project . and run npx hyperframes check.

2. Intent Routing Matrix

Route fresh creation requests to the first matching workflow:

PriorityRequest TypeTarget Workflow
1Explicit port of Remotion codeworkflows/remotion-to-hyperframes
2Presentation, pitch deck, or interactive slide deckworkflows/slideshow
3Plain word-timed captions or subtitles on footageworkflows/embedded-captions
4Graphic overlays on talking-head, interview, or podcastworkflows/talking-head-recut
5Beat-synced motion driven by music track (no speech)workflows/music-to-video
6Short, motion-first kinetic visual (<10s)workflows/motion-graphics
7GitHub pull request or code change explainerworkflows/pr-to-video
8Product launch, website showcase, SaaS promo, /bragworkflows/product-launch-video (or Mode 1)
9Conceptual topic or documentation explainerworkflows/faceless-explainer
10Any other custom video or multi-track compositionworkflows/general-video

3. Operational Modes

Mode 1: Product Launch & Showcase (/brag & product-launch-video)

Used for website launches, product showcases, SaaS promos, and /brag.

  1. Intake & Inspect:
    • Parse options: --tone (default, polished, yc-parody, chaotic, cinematic, deadpan, app-store in references/brag/tones.md), --format (16:9, 9:16, 1:1), --duration (15–25s).
    • If URL provided, capture live site assets: 
      npx hyperframes capture "<URL>" -o ./capture --json
  2. Design System & Presets:
    • Pick design preset from references/creative/frame-presets/ (capsule, cobalt-grid, daisy-days, etc.) and remix brand tokens: 
      node workflows/product-launch-video/scripts/build-frame.mjs --preset <preset-name> --hyperframes .
  3. Storyboard & Audio Mix:
    • Write STORYBOARD.md and SCRIPT.md.
    • Audio: Select music bed from assets/music/ or use /media-use to resolve tracks and TTS voiceover (references/audio/).
    • Run beat cue analysis: python3 scripts/analyze_music_cues.py --audio <path> --output audio_cues.json.
  4. Validation & Output:
    • Verify layout and timing: npx hyperframes check.
    • Compile final video: npx hyperframes render --output brag.mp4.
    • Save poster frame 0 to brag.jpg and release copy to share-copy.txt.

Mode 2: Narrative & Technical Explainers (faceless-explainer, pr-to-video)

Used for turning code diffs, engineering docs, or complex topics into clear video narratives.

  1. Story Spine: Follow references/creative/references/story-spine.md (hook, problem statement, architecture/solution, impact).
  2. Shot Shapes: Select blueprints from references/animation/blueprints-index.md (code-editor, split-comparison, stat-callout, flow-diagram).
  3. Frame Worker Packets: Generate bounded sub-agent packets with workflows/faceless-explainer/scripts/frame-packets.mjs. Each frame is built in isolation (compositions/frames/NN-*.html).
  4. Assembly & Audio: Link frames into root index.html, mix voiceover track with ducking envelopes, and render.

Mode 3: Kinetic Motion Graphics & Runtimes (motion-graphics, music-to-video)

Used for standalone motion graphics, animated UI components, beat grids, and loops.

  1. Runtime Adapters (references/animation/adapters/):
    • GSAP: Precision multi-property tweens and seek-safe timelines.
    • Three.js: 3D spatial viewports, particle systems, and models (references/animation/adapters/three.md).
    • Lottie: Vector animation player (references/animation/adapters/lottie.md).
    • Anime.js / WAAPI: Compact DOM morphs and keyframes.
    • CSS Keyframes: Hardware-accelerated transforms.
  2. Camera Transitions & Morphs (references/keyframes/):
    • Ken Burns pans, punch-in zooms, SVG path morphs, and depth effects.
  3. Registry Blocks & Shaders (references/registry/):
    • Search and install pre-built effect blocks (CRT scanlines, glitch, film grain, shimmer sweep, confetti).

Mode 4: Custom Compositions & Multi-Track Editing (general-video, slideshow)

Used for interactive pitch decks, multi-track timeline editing, and custom HTML videos.

  1. Studio Conventions (references/studio/studio-conventions.md):
    • Every scene is a sub-composition (data-composition-src).
    • One caption track (data-track-kind="captions").
    • One element kind per track (video, graphics, captions, audio).
    • Safe-zone compliance (Premiere title/action safe boxes).
  2. Cross-Domain Creator Recipes:
    • Trims & Cuts: Update data-start, data-duration, and data-media-start (references/core/tracks-and-clips.md).
    • Smooth Zooms: Animate inner crop wrapper with CSS/GSAP while keeping clip timing steady (references/keyframes/).
    • Audio Gain & Ducking: Apply volume envelopes and bus compression (references/audio/).

4. Verification & CLI Toolchain

Always run validation gates before delivery:

# Initialize a new Hyperframes project with workflow scaffold
npx hyperframes init "videos/<project>" --skill=<workflow-name>

# Capture live web assets, screenshots, and brand tokens
npx hyperframes capture "<URL>" -o ./capture --json

# Inspect composition timeline, tracks, and clips
npx hyperframes timeline [--json]

# Validate timing attributes, safe zones, and missing assets
npx hyperframes check

# Launch interactive local player
npx hyperframes preview

# Render final MP4 output
npx hyperframes render --output output.mp4

5. Directory Map

PathPurpose
workflows/All 11 upstream workflows (product-launch-video, faceless-explainer, pr-to-video, motion-graphics, etc.)
engine/Canonical Hyperframes v0.8.77 upstream package suites
references/core/Timing attributes, determinism rules, track models, sub-compositions
references/animation/GSAP, Three.js, Lottie, Anime.js, CSS adapters, blueprints, motion blur
references/keyframes/2D/3D camera transitions, zooms, SVG morphs, depth effects
references/audio/EQ, ducking, compression, submix bus automation envelopes
references/creative/Design specs, typography, palettes, frame presets, story-spine
references/registry/Visual blocks, shader components, installation and wiring
references/studio/Studio timeline layout, caption tracks, safe zones
references/brag/Curated /brag step-by-step guides, tones, and music cues
assets/music/Curated music beds across cinematic, hype, indie, calm genres
scripts/analyze_music_cues.py, frame packet core, and audio extractors

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.

Related Skills

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