| name | motiscope-rebuild-site |
| description | Rebuild a whole landing page / multi-section website from a screen recording that scrolls or walks through it. Use when the user has a recording of an ENTIRE page (not a single animation) and wants the full page recreated — layout, sections, copy, design system, and scroll animations. Orchestrates analyze (measured timing + section structure + curated frames) + asset generation + a full multi-section build. For one isolated animation, use `motiscope-recreate` instead. |
motiscope: rebuild-site
Rebuild a whole landing page / multi-section website from a screen recording that scrolls or walks through it. Use when the user has a recording of an ENTIRE page (not a single animation) and wants the full page recreated — layout, sections, copy, design system, and scroll animations. Orchestrates analyze (measured timing + section structure + curated frames) + asset generation + a full multi-section build. For one isolated animation, use motiscope-recreate instead.
Arguments ([path-to-video] [gsap|css|framer]): take them from the user's message. If they're missing, infer them or ask.
Running motiscope
motiscope is a shell command. If it isn't found it isn't on your PATH — see
https://github.com/KumarSashank/motiscope#install. The reference guides live under
$(motiscope home)/references/.
Invoking the sibling skills. In Codex, mention a skill with $motiscope-recreate. In
Cursor, use /motiscope-recreate. Elsewhere, just follow that skill's SKILL.md.
Seeing the frames — do not skip this. The curated keyframes are PNG files on disk, and
you must actually look at them. Codex: use the view_image tool (if it's unavailable,
enable tools.view_image = true in ~/.codex/config.toml, or have the user relaunch with
codex -i frame1.png,frame2.png). Cursor: the file-reading tool accepts .png and puts
the image in context. If you genuinely cannot open images, say so — you can still
report the measured timing, but you cannot know what is animating, and you must not
guess it from the filenames.
Rebuild a whole landing page from a walkthrough recording. This is analyze + recreate
applied to an entire page, and it leans on the same division of labor:
- The numbers give you the WHEN + the structure — motiscope measures section timing,
transitions, and per-section entrance easing, and curates the frames that show each section.
- You give the WHAT — from the frames you reconstruct the sections, layout, copy, design
system, and what kind of animation each uses (open vocabulary — scroll reveals, pins,
masks, draws, whatever you see).
- Imagen fills the photos — generate the photographic assets the design needs.
It's a team effort: measured timing + curated frames + your vision + generated assets → a
full page. Be honest about which is which in the final summary.
Preflight
motiscope doctor --check
Resolve the video from $1, else scan animations/ (as in analyze).
Step 1 — analyze the whole walkthrough
motiscope analyze "<video>" --preset landing
landing gives readable 1280px frames and auto-decomposes onto the motion. The result:
hold segments = the sections the walkthrough paused on.fade-out/cut segments = the transitions between sections.- per-section entrance timing/easing (the
move beats + their cubic-bezier), the
stagger timing, and curated frames covering each section.
For a long clip, note it may exceed one pass; you can also re-run focused on a range
(--start/--end) to get denser frames for a specific section.
Step 2 — build the site plan (from the frames)
Read report.md (the measured timeline) and every curated frame (parallel Reads).
Then reconstruct — this is your vision doing the work — and present a site plan to the user:
- Design system: palette (hexes), typography (name the actual fonts if you can — e.g.
Martian Mono), spacing/scale, brand/logo, light/dark.
- Sections in order: for each — a name (hero / features / how-it-works / pricing / FAQ /
footer / …), its layout, its copy transcribed verbatim from the frames, and the
imagery it contains.
- Motion per section: what animates and how (scroll-reveal, pin+scrub, stagger, mask,
draw, parallax — name what you see), wired to the measured timing (durations,
bezier,
stagger each_ms) from the segment table. Landing walkthroughs are almost always
scroll-driven — assume ScrollTrigger unless the frames say otherwise.
Show the plan and let the user correct it before building.
Step 3 — assets
List the photographic assets the design needs (hero shots, feature photos, backgrounds —
anything that isn't UI you can build in CSS/SVG). Then ask the user: (a) point at their
own files, (b) generate, or (c) placeholders. For (b), generate with the real provider:
motiscope assets --check
motiscope assets generate --type image --provider gemini \
--prompt "<match the shot + the design's grade>" --out assets/hero.png --aspect-ratio 16:9
Match each prompt to what the frame shows and the design's color grade. If no key, hand to
motiscope-doctor. Never write keys into output or commit them.
Step 4 — build the page
Default target GSAP + ScrollTrigger ($2 overrides: css | framer). Read
"$(motiscope home)/references/easing-map.md" and "$(motiscope home)/references/targets/<target>.md".
For GSAP, write idiomatic GSAP yourself: build the sequence with a gsap.timeline() and the position parameter, register a CustomEase for each measured cubic-bezier, use stagger for the measured each_ms, and reach for ScrollTrigger only if the spec has "scroll_driven": true. The rendering template in $(motiscope home)/references/targets/gsap.md has the patterns.
Build one standalone page (index.html + assets/) with:
- the design system (tokens for palette/type; embed or link the identified fonts),
- a nav + every section in order, copy verbatim, assets wired in,
- scroll-driven motion per the plan, using the measured durations /
cubic-bezier /
stagger — not guessed values,
- the section transitions you saw (fades, mask wipes, pinned zooms),
- responsive layout and a
prefers-reduced-motion: reduce guard (elements resolve to final state).
Keep the timing measured; build the effects from what you saw.
Step 5 — output, preview, credit
Write to ./motiscope-output/site/. Then:
- tell the user how to preview (
open motiscope-output/site/index.html),
- give an honest breakdown: timing = measured; layout/copy/design = reconstructed from
frames; photos = generated (Imagen); fonts = identified. Flag what to fine-tune.
- Attribution & rights: if the source is someone else's design (a Dribbble shot, another
company's site), add a prominent credit in the footer (link the original), frame it as a
design-to-code study, and confirm the user has the right to publish before it goes public.
Don't publish a clone of a third party's brand without their say-so.
Two worked examples:
- Cadence — an original page,
walked through and measured. Every scroll boundary lands on the authored millisecond, and the two
things motiscope gets wrong are published with the reason.
- Alterfx — a real Dribbble
concept rebuilt from a 10s recording, credited on the page and framed as a design-to-code
study. This is what the rights step below looks like when the answer is "yes, with attribution".
Rights come first. If the recording is of someone else's site or concept, say so before you
build: offer to recreate it as a study with visible attribution, or to rebuild the structure and
motion under the user's own art and copy. Do not publish a clone of someone else's design.
