Skip to content
Back to search

scroll-cinematic

Build an award-winning "3D scroll" website of ANY kind from ONE prompt — product launch, portfolio, agency, contractor/home-services, restaurant, real estate, personal brand, event, app, etc. Generates a high-end cinematic hero visual + clips (360° orbit, fly-through, reveal, explode, parallax) fitting the site's subject with the Higgsfield MCP, slices them into a scroll-scrubbed canvas frame sequence with ffmpeg, builds a branded multi-section site (Lenis smooth scroll + scroll reveals), and launches it on localhost. Use when the user asks for a "3D scroll" site, scroll-driven hero/reveal, a cinematic landing page, a buckssauce/Apple/Awwwards-style scroll site, or "build me a website like X" — for a product OR a service, person, place, or brand. Trigger words: 3D scroll, scroll animation, cinematic hero, fly-through, turntable, scroll site, landing page, portfolio site, agency site, Higgsfield site.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zubair-trabzada--scroll-cinematic-claude/badge.svg)](/listings/zubair-trabzada--scroll-cinematic-claude)

HTML

<a href="/listings/zubair-trabzada--scroll-cinematic-claude"><img src="/api/listings/zubair-trabzada--scroll-cinematic-claude/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

mkdir -p ~/.claude/skills && git clone https://github.com/zubair-trabzada/scroll-cinematic-claude.git ~/.claude/skills/scroll-cinematic

Then **restart Claude Code** so it picks up the skill. That's it.

> Already installed? Update with: > ```bash > cd ~/.claude/skills/scroll-cinematic && git pull > ```

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 107 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: scroll-cinematic
  3. description: Build an award-winning "3D scroll" website of ANY kind from ONE prompt — product launch, portfolio, agency, contractor/home-services, restaurant, real estate, personal brand, event, app, etc. Generates a high-end cinematic hero visual + clips (360° orbit, fly-through, reveal, explode, parallax) fitting the site's subject with the Higgsfield MCP, slices them into a scroll-scrubbed canvas frame sequence with ffmpeg, builds a branded multi-section site (Lenis smooth scroll + scroll reveals), and launches it on localhost. Use when the user asks for a "3D scroll" site, scroll-driven hero/reveal, a cinematic landing page, a buckssauce/Apple/Awwwards-style scroll site, or "build me a website like X" — for a product OR a service, person, place, or brand. Trigger words: 3D scroll, scroll animation, cinematic hero, fly-through, turntable, scroll site, landing page, portfolio site, agency site, Higgsfield site.
  4. ---
  5. # Scroll-Cinematic — one-prompt 3D product sites
  6. ## What this actually is (read first)
  7. The viral "3D scroll" effect is **not** Three.js. It's a **canvas image-sequence scrub**:
  8. a short cinematic clip is exported to ~180 numbered JPGs, all preloaded, and the frame
  9. drawn to a `<canvas>` is chosen by scroll progress. Scrolling forward/backward plays the
  10. clip. Add Lenis smooth scroll + scroll-synced overlay copy and it reads as premium 3D.
  11. The "3D" comes entirely from the source video — which we generate with Higgsfield.
  12. Stack: plain **HTML + CSS + JS + Lenis** (zero build, runs from any static server).
  13. ## Prerequisites
  14. - **Higgsfield MCP** connected + credits (~$1–2 / site). This is the only thing the user must set up.
  15. - **ffmpeg** — DO NOT ask the user to install it. Step 0 below installs it automatically (no Homebrew).
  16. - This skill installed at `~/.claude/skills/scroll-cinematic/`.
  17. ### Step 0 — Ensure ffmpeg (run first, always)
  18. Run `bash ~/.claude/skills/scroll-cinematic/scripts/ensure-ffmpeg.sh`. It uses system ffmpeg if
  19. present, otherwise downloads a static binary to `/tmp/ffmpeg-bin/ffmpeg` (macOS/Linux, no Homebrew).
  20. The extract/compress scripts already fall back to that path. Never block the build on ffmpeg.
  21. ## THE PIPELINE — run all of this from the single prompt
  22. ### 1. Decide the brief (works for ANY site — no extra questions unless the subject is unclear)
  23. From the user's prompt pick: **site type**, **hero subject**, **vibe/palette**, **brand/name**
  24. (invent one if not given), and **2 hero motions**. The hero subject is whatever the site is
  25. about — a product, a person/founder, a building/space, a dish, a vehicle, or an abstract visual.
  26. Default motions by site type:
  27. - **Product** (bottle, gadget, shoe, cosmetic) → 360° rotation + explode/pour/reveal.
  28. - **Portfolio / personal brand** → cinematic portrait or abstract liquid/geometry motion + a slow parallax/orbit.
  29. - **Agency / app / SaaS** → abstract 3D shape/logo morph or UI-in-space + light-streak fly-through.
  30. - **Contractor / home services / real estate** → slow orbit or fly-through of a building/home/jobsite + a detail reveal.
  31. - **Restaurant / food** → dish 360° + ingredient/steam motion or interior fly-through.
  32. - **Fitness / events / travel** → motion of the subject (athlete, crowd, landscape) + a sweeping camera move.
  33. If unsure, default to one **hero orbit/fly-through** + one **reveal/parallax** clip.
  34. ### 2. Generate the hero keyframe (Higgsfield `generate_image`)
  35. - Model: **`nano_banana_pro`** (top quality / crisp). Prompt the hero subject for the site
  36. (product, person, place, abstract), strong lighting, intentional background, "ultra sharp,
  37. photorealistic, 8k, editorial/advertising". 16:9. (For portfolios you can also use a brand-colored
  38. abstract 3D render so there's no likeness/IP issue.)
  39. - Poll `job_display` until `status:"completed"`; keep the job **id** (used as the video start frame).
  40. ### 3. Generate 1–2 cinematic clips (Higgsfield `generate_video`)
  41. - Model: **`seedance_2_0`**, `resolution:"1080p"`, `aspect_ratio:"16:9"`, `duration:6`,
  42. `medias:[{role:"start_image", value:<keyframe id>}]`. Always pass
  43. `declined_preset_id:"24bae836-2c4a-48e0-89b6-49fcc0b21612"` if it suggests a preset; if it
  44. suggests a different preset, retry with that preset's id in `declined_preset_id`.
  45. - Motion prompt patterns (pick what fits the subject):
  46. - **turntable** — "smooth seamless full 360-degree rotation, one complete revolution, stays centered".
  47. - **fly-through** — "slow continuous forward camera flight through/around the [building/space/scene], smooth dolly, deep parallax".
  48. - **reveal/explode** — "the [contents/components/elements] burst or assemble outward and float in slow motion" (keep it object/scene context — moderation-friendly).
  49. - **abstract** — "elegant slow-morphing liquid-metal / glass / particle form drifting and rotating".
  50. - **Generate both clips in parallel** (two tool calls in one message), then poll `job_display`.
  51. 1080p renders take ~3–8 min; sleep in the background between polls.
  52. - **Cost:** preflight with `get_cost:true` once; ~54 credits per 1080p clip. Confirm if the user is low.
  53. ### 4. Handle render results
  54. - `completed` → download `results.rawUrl` with `curl`.
  55. - `nsfw` or `failed` → **refunded, retry**. Moderation false-flags abstract "floating pills/
  56. dissolving figures"; reword to product-context, or switch that clip to **`grok_video_v15`**
  57. (`resolution:"720p"`, more lenient). Product turntables/explosions pass at 1080p.
  58. - Tell the user about any retry; never claim a clip rendered if it didn't.
  59. ### 5. Slice + compress frames (ffmpeg)
  60. - `scripts/extract-frames.sh <clip.mp4> frames/<name> 180` → ~179 numbered JPGs.
  61. - `scripts/compress-frames.sh frames/<name> 1600 88` → 1600px wide, q88 (crisp, <~15MB/section).
  62. - One folder per clip (e.g. `frames/spin`, `frames/explode`).
  63. ### 6. Build the site from templates/
  64. - Copy `templates/index.html`, `styles.css`, `scroll-cinematic.js` into the project.
  65. - Edit the `SCRUB_SECTIONS` config (bottom of index.html) — one entry per clip:
  66. `{ section:"#hero", frameCount:179, bg:"#0a0a12", framePath:(i)=>\`frames/spin/frame_${String(i).padStart(4,"0")}.jpg\` }`.
  67. - Write brand copy, palette (CSS vars), benefit/colorway/feature sections, stats, CTA.
  68. - **Hue-shift trick** for product variants/colorways (no extra generation):
  69. `ffmpeg -i base.png -vf "hue=h=120:s=1.15" variant.png`.
  70. ### 7. Launch on localhost
  71. - Copy `templates/Launch Demo.command` into the project, edit PORT + name, `chmod +x` it.
  72. - Start it (`python3 -m http.server <port>`), `curl` the page + a frame to confirm 200, `open` the URL.
  73. - Tell the user the URL + that double-clicking the .command relaunches it for recording.
  74. ## Engine rules (already in templates/scroll-cinematic.js)
  75. - Preload every frame; paint frame 0 on first load; redraw only when the frame index changes.
  76. - Sticky stage: outer section `height: 420–600vh`, inner `position:sticky; top:0; height:100vh`.
  77. Progress = `clamp(-rect.top / (rect.height - innerH), 0, 1)`. Throttle in the rAF loop.
  78. - Cover-fit draw + HiDPI (`devicePixelRatio`, cap 2). Drive updates from the Lenis rAF loop
  79. (robust to any scroll source). Overlay copy fades over per-line `[in,out]` progress windows.
  80. - Multi-section: `SCRUB_SECTIONS` array; engine **skips** sections whose element is missing.
  81. ## Known gotchas
  82. - More/larger frames = slow load → keep 1600px / q88 / ~180 frames.
  83. - Continuous-motion clips only (no hard cuts — ugly when scrubbed backward).
  84. - The headless screenshot tool blanks sticky-canvas sections when scrolled; verify with
  85. pixel sampling, and view live in a real browser.
  86. - `python http.server` previews die when idle — the `.command` launcher is the durable demo.
  87. ## Files
  88. - `templates/index.html`, `styles.css`, `scroll-cinematic.js` — multi-section scrub site.
  89. - `templates/CinematicReveal.tsx` — React/Next drop-in (optional).
  90. - `templates/Launch Demo.command` — double-click localhost launcher.
  91. - `scripts/extract-frames.sh`, `scripts/compress-frames.sh` — the ffmpeg pipeline.
README.md · README · 112 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🎬 Scroll-Cinematic — 3D Scroll Websites for Claude Code
  2. ![3D scroll websites built with one prompt — sneaker, hot sauce, and wellness sites generated by this skill](assets/banner.jpg)
  3. *Three real sites built by this skill with one prompt each — every visual AI-generated, every scene scroll-scrubbed in 3D.*
  4. Build **award-winning "3D scroll" websites from ONE prompt** — for any product, portfolio,
  5. contractor, restaurant, agency, or brand.
  6. Claude Code + the **Higgsfield MCP** generate a cinematic hero shot and 3D clips
  7. (360° spins, fly-throughs, explosions, reveals), slice them into scroll-scrubbed frames,
  8. build a polished branded multi-section site with buttery smooth scrolling, and launch it
  9. on localhost — all from a single prompt.
  10. > The viral "3D scroll" effect (Apple product pages, Awwwards sites) isn't Three.js —
  11. > it's a **canvas image-sequence scrub**. This skill automates the entire pipeline.
  12. ---
  13. ## ⚡ Install (one command)
  14. ```bash
  15. mkdir -p ~/.claude/skills && git clone https://github.com/zubair-trabzada/scroll-cinematic-claude.git ~/.claude/skills/scroll-cinematic
  16. ```
  17. Then **restart Claude Code** so it picks up the skill. That's it.
  18. > Already installed? Update with:
  19. > ```bash
  20. > cd ~/.claude/skills/scroll-cinematic && git pull
  21. > ```
  22. ---
  23. ## ✅ Requirements
  24. | What | Why | How |
  25. |---|---|---|
  26. | **Claude Code** | runs the skill | [claude.com/code](https://claude.com/code) |
  27. | **Higgsfield MCP** + credits | generates the images & 3D clips (~$1–2/site) | in Claude Code: `/mcp` → Add server → paste your Higgsfield MCP link |
  28. | ~~ffmpeg~~ | ~~slices clips into frames~~ | **auto-installed by the skill** — nothing to do |
  29. Check the MCP is connected: type `/mcp` in Claude Code → `higgsfield` should be green.
  30. ---
  31. ## 🚀 Use it (the one prompt)
  32. Open a **new Claude Code session** and paste — swap the bracket for anything:
  33. ```
  34. Use the scroll-cinematic skill to build a 3D scroll website for [WHATEVER IT IS].
  35. Generate a high-end cinematic hero plus two 3D clips with the Higgsfield MCP at 1080p,
  36. slice them into scroll frames, and build a polished, branded multi-section site that
  37. matches its vibe — then launch it on localhost.
  38. ```
  39. **`[WHATEVER IT IS]` can be anything:**
  40. | Type | Examples | The 3D it gets |
  41. |---|---|---|
  42. | Products | hot sauce, smartwatch, sneaker, perfume | 360° spin + explode/reveal |
  43. | Local business | contractor, HVAC, med spa, law firm | building fly-through + detail reveal |
  44. | People | photographer portfolio, artist, coach | cinematic portrait / abstract motion |
  45. | Hospitality | restaurant, hotel, gym, listing | dish 360° / interior fly-through |
  46. | Companies | agency, SaaS, startup, course, event | logo morph + light-streak fly-through |
  47. Want control? Add it: *"…make it bold and colorful with a powder explosion"* or
  48. *"…dark and luxe with a slow fly-through."* Leave it out and Claude picks what fits.
  49. ⏱ A build takes ~10–15 min (AI video renders) and costs ~$1–2 in Higgsfield credits.
  50. ---
  51. ## 📦 What's inside
  52. ```
  53. scroll-cinematic/
  54. ├── SKILL.md # the full one-prompt pipeline Claude follows
  55. ├── scripts/
  56. │ ├── ensure-ffmpeg.sh # auto-installs ffmpeg (no Homebrew needed)
  57. │ ├── extract-frames.sh # video → numbered scroll frames
  58. │ └── compress-frames.sh # crisp + fast-loading frames
  59. └── templates/
  60. ├── index.html / styles.css / scroll-cinematic.js # multi-section scrub engine (Lenis)
  61. ├── CinematicReveal.tsx # React/Next.js drop-in (optional)
  62. └── Launch Demo.command # double-click localhost launcher (great for demos)
  63. ```
  64. ## 🔧 How it works (60 seconds)
  65. 1. **Hero image** — Higgsfield `nano_banana_pro` generates a crisp cinematic keyframe.
  66. 2. **3D clips** — Higgsfield `seedance_2_0` animates it (360° spin, fly-through, explosion…) at 1080p.
  67. 3. **Frames** — ffmpeg slices each clip into ~180 JPGs.
  68. 4. **Scrub engine** — a `<canvas>` draws the frame matching your scroll position; Lenis makes
  69. the scroll buttery. Scroll forward/back = play the cinematic forward/back.
  70. 5. **Site** — branded sections (copy, stats, cards, CTA) reveal as you scroll. Launches on localhost.
  71. ## ❓ Troubleshooting
  72. - **"Skill not found"** → restart Claude Code after installing; check `ls ~/.claude/skills/scroll-cinematic/SKILL.md`.
  73. - **Higgsfield clip flagged/failed** → normal occasionally; Claude retries automatically (failures are refunded).
  74. - **Site loads slowly** → frames too large; the skill compresses to 1600px/q88 by default — keep it.
  75. - **Want a public URL?** → the site is a static folder; drop it on Netlify/Vercel/Railway as-is.
  76. ---
  77. ## 🎓 Learn to sell this
  78. Want the full system — client outreach, pricing, and the business playbook around these
  79. builds? Join the **AI Workshop** community on Skool.
  80. *Built by [Zubair Trabzada](https://github.com/zubair-trabzada) — AI Workshop.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.