Skip to content
Back to search

Immersive-Scrolling-UIUX

AI coding agent skill for cinematic, accessible scroll-driven UI/UX (GSAP ScrollTrigger, Lenis, Three.js / R3F, 2D Canvas Sprite Stacking & CSS animation-timeline). Enforces Motion Specs, single-ticker sync, WCAG 2.2 keyboard/SR support & adaptive WebGL tiering.

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/chiakai-chang--immersive-scrolling-uiux/badge.svg)](/listings/chiakai-chang--immersive-scrolling-uiux)

HTML

<a href="/listings/chiakai-chang--immersive-scrolling-uiux"><img src="/api/listings/chiakai-chang--immersive-scrolling-uiux/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.

For AI Coding Agents (Self-Install Instructions)

If you are an AI coding agent (Gemini CLI, Claude Code, Codex, Copilot CLI, or Cursor) asked to install this skill from `https://github.com/Chiakai-Chang/Immersive-Scrolling-UIUX`, copy `skills/immersive-scrolling-uiux` into the user's cross-runtime skills directory (`~/.agents/skills/immersive-scrolling-uiux`) and verify `SKILL.md` exists:

# macOS / Linux
git clone --depth 1 https://github.com/Chiakai-Chang/Immersive-Scrolling-UIUX.git /tmp/immersive-scrolling-uiux && \
mkdir -p ~/.agents/skills && \
rm -rf ~/.agents/skills/immersive-scrolling-uiux && \
cp -r /tmp/immersive-scrolling-uiux/skills/immersive-scrolling-uiux ~/.agents/skills/ && \
rm -rf /tmp/immersive-scrolling-uiux && \
ls -la ~/.agents/skills/immersive-scrolling-uiux/SKILL.md
# Windows (PowerShell)
$tmp = Join-Path $env:TEMP "immersive-scrolling-uiux"
if (Test-Path $tmp) { Remove-Item -Recurse -Force $tmp }
git clone --depth 1 https://github.com/Chiakai-Chang/Immersive-Scrolling-UIUX.git $tmp
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills" | Out-Null
Copy-Item -Recurse -Force "$tmp\skills\immersive-scrolling-uiux" "$env:USERPROFILE\.agents\skills\"
Remove-Item -Recurse -Force $tmp
Test-Path "$env:USERPROFILE\.agents\skills\immersive-scrolling-uiux\SKILL.md"

Manual Installation (From Local Clone)

# macOS / Linux
mkdir -p ~/.agents/skills
cp -r skills/immersive-scrolling-uiux ~/.agents/skills/
# Windows (PowerShell)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills" | Out-Null
Copy-Item -Recurse -Force .\skills\immersive-scrolling-uiux "$env:USERPROFILE\.agents\skills\"

---

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.

README.md · README · 131 lines
  1. # Immersive Scrolling UI/UX Skill
  2. [English](README.md) | [繁體中文(臺灣)](README.zh-TW.md)
  3. An AI coding agent skill for building cinematic, scroll-driven web experiences with **GSAP ScrollTrigger**, **Lenis**, **Three.js / React Three Fiber**, **2D Canvas Pseudo-3D**, and **CSS Scroll-driven Animations** (`animation-timeline`).
  4. > **Core Principle:** High-end immersive websites are not isolated animations—they are **choreographed timelines** where background scale, foreground parallax, mask reveals, typography, and 3D camera motion share a unified rhythm.
  5. ---
  6. ## Repository Structure
  7. ```text
  8. .
  9. ├── README.md
  10. ├── README.zh-TW.md
  11. └── skills/
  12. └── immersive-scrolling-uiux/
  13. ├── SKILL.md # Core workflow, Motion Spec, ticker & guardrails
  14. └── references/
  15. ├── motion-modules.md # M01–M12 production recipes + Playground pattern
  16. ├── architecture-and-webgl.md # React useGSAP, R3F bridge, Shader Warmup, Atlas & Tiering
  17. └── accessibility-and-polish.md # ScreenReaderOverlay, Glass, View Transitions & Fallbacks
  18. ```
  19. ---
  20. ## Installation
  21. ### For AI Coding Agents (Self-Install Instructions)
  22. If you are an AI coding agent (Gemini CLI, Claude Code, Codex, Copilot CLI, or Cursor) asked to install this skill from `https://github.com/Chiakai-Chang/Immersive-Scrolling-UIUX`, copy `skills/immersive-scrolling-uiux` into the user's cross-runtime skills directory (`~/.agents/skills/immersive-scrolling-uiux`) and verify `SKILL.md` exists:
  23. ```bash
  24. # macOS / Linux
  25. git clone --depth 1 https://github.com/Chiakai-Chang/Immersive-Scrolling-UIUX.git /tmp/immersive-scrolling-uiux && \
  26. mkdir -p ~/.agents/skills && \
  27. rm -rf ~/.agents/skills/immersive-scrolling-uiux && \
  28. cp -r /tmp/immersive-scrolling-uiux/skills/immersive-scrolling-uiux ~/.agents/skills/ && \
  29. rm -rf /tmp/immersive-scrolling-uiux && \
  30. ls -la ~/.agents/skills/immersive-scrolling-uiux/SKILL.md
  31. ```
  32. ```powershell
  33. # Windows (PowerShell)
  34. $tmp = Join-Path $env:TEMP "immersive-scrolling-uiux"
  35. if (Test-Path $tmp) { Remove-Item -Recurse -Force $tmp }
  36. git clone --depth 1 https://github.com/Chiakai-Chang/Immersive-Scrolling-UIUX.git $tmp
  37. New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills" | Out-Null
  38. Copy-Item -Recurse -Force "$tmp\skills\immersive-scrolling-uiux" "$env:USERPROFILE\.agents\skills\"
  39. Remove-Item -Recurse -Force $tmp
  40. Test-Path "$env:USERPROFILE\.agents\skills\immersive-scrolling-uiux\SKILL.md"
  41. ```
  42. ### Manual Installation (From Local Clone)
  43. ```bash
  44. # macOS / Linux
  45. mkdir -p ~/.agents/skills
  46. cp -r skills/immersive-scrolling-uiux ~/.agents/skills/
  47. ```
  48. ```powershell
  49. # Windows (PowerShell)
  50. New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills" | Out-Null
  51. Copy-Item -Recurse -Force .\skills\immersive-scrolling-uiux "$env:USERPROFILE\.agents\skills\"
  52. ```
  53. ---
  54. ## What This Skill Enforces
  55. 1. **Anti-Template Design Brief & Motion Spec** — Agents lock a distinct Page Grammar, 1 bespoke signature mechanic, a Beat-Based Narrative Arc, and a per-section YAML Motion Spec before coding.
  56. 2. **Section-by-Section Browser Verification** — Validate `ScrollTrigger` markers, zero Dead Scroll / Ghost Copy, dynamic contrast (`>= 4.5:1`), 60fps compositor performance, mobile layout, keyboard `Tab` focus, and `prefers-reduced-motion` per section.
  57. 3. **Single Unified Render Loop** — Lenis and Vanilla Three.js/2D Canvas are driven through `gsap.ticker` (`lagSmoothing(0)`), with `ScrollTrigger.config({ ignoreMobileResize: true })`, `document.fonts.ready` refresh, Lenis anchor routing, and R3F `useFrame` bridge support.
  58. 4. **Engineering & Accessibility Guardrails**:
  59. - Compositor-only animations, LCP-safe Hero (no initial `opacity: 0` on `<h1>`), `min-height: 100dvh`, and `overflow-x: clip`
  60. - `gsap.matchMedia()` with `AbortController` listener cleanup, exact CSS/JS **Breakpoint Parity**, and React `useGSAP()` lifecycle patterns
  61. - WCAG 2.2 `focusin` scroll alignment for horizontal sections, `ScreenReaderOverlay` DOM twin for 3D/Canvas worlds, and accessible split text (`aria-label` + `aria-hidden`)
  62. - Runtime reduced-motion toggle, `prefers-reduced-transparency` glass fallback, adaptive `HIGH/MEDIUM/LOW` hardware tiering, `gl.compileAsync()` shader warmup, Texture Atlas packing, and `dispose()` cleanup
  63. ---
  64. ## The 12 Effect Modules (M01–M12)
  65. See [`skills/immersive-scrolling-uiux/references/motion-modules.md`](skills/immersive-scrolling-uiux/references/motion-modules.md) for production code patterns:
  66. | ID | Module | Primary Tech |
  67. |---|---|---|
  68. | **M01** | Cinematic Hero | GSAP Timeline + ScrollTrigger Scrub |
  69. | **M02** | Parallax Image | CSS `animation-timeline: view()` / GSAP `data-speed` |
  70. | **M03** | Text Reveal | GSAP + accessible `aria-label` / `aria-hidden` spans |
  71. | **M04** | Image Mask Transition | CSS `clip-path` (`inset` / `circle`) + GSAP |
  72. | **M05** | Sticky Storytelling | `ScrollTrigger` `pin: true` + chapter crossfade |
  73. | **M06** | Horizontal Scroll | `ScrollTrigger` `x` + `invalidateOnRefresh` + `containerAnimation` |
  74. | **M07** | 3D Camera Movement | Three.js / R3F fixed `<canvas>` + ScrollTrigger waypoints |
  75. | **M08** | Magnetic & Diffused Cursor | `gsap.quickTo()` (`(pointer: fine)` only, scale-only) |
  76. | **M09** | Particle / GLSL Shader BG | Three.js `ShaderMaterial` / `Points` + viewport culling |
  77. | **M10** | Morphing / Scene Bridge | SVG path / `clip-path` / CSS theme variable transitions |
  78. | **M11** | Pseudo-3D Sprite Stacking | 2D Canvas multi-slice + Top/Chase/HUD camera lerp |
  79. | **M12** | Frame-Sequence Scrub | 2D Canvas image sequence + ScrollTrigger `snap` |
  80. ---
  81. ## References & Inspiration
  82. ### Core Documentation
  83. - [GSAP ScrollTrigger Docs](https://gsap.com/docs/v3/Plugins/ScrollTrigger/)
  84. - [Lenis Smooth Scroll](https://lenis.darkroom.engineering/)
  85. - [Three.js Documentation](https://threejs.org/)
  86. - [MDN CSS Scroll-driven Animations](https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Scroll-driven_animations)
  87. - [Codrops](https://tympanus.net/codrops/)
  88. ### Open-Source Skills & Projects Studied
  89. - [greensock/gsap-skills](https://github.com/greensock/gsap-skills) — Official GSAP AI skills (pin-wrapper separation, `clamp()`, `ScrollTrigger.batch()`, `refreshPriority` & `gsap.quickTo()`)
  90. - [pbakaus/impeccable](https://github.com/pbakaus/impeccable) — Child-surface hover stability (no edge flicker), visitor-mode pacing & default-visible fallback discipline
  91. - [juliobsz/skills](https://github.com/juliobsz/skills) — `awwwards` / `jury` quality bar, OGL lightweight WebGL, `@media (hover: hover)` parity, CSS letter-roll & parallel page transitions
  92. - [nateherkai/scroll-craft](https://github.com/nateherkai/scroll-craft) — Feeling Curve, Page Grammar *forbids*, dimensional hero planes & entry/exit scrub verification
  93. - [AThevon/genjutsu](https://github.com/AThevon/genjutsu) — Anti-AI-Slop tells catalogue, existing-stack respect & interaction thesis discipline
  94. - [saralobo/rules-design-bible](https://github.com/saralobo/rules-design-bible) — M3 asymmetric enter/exit easing, <100ms feedback & 100th-repetition micro-interaction discipline
  95. - [rastian/interaction-design-skills](https://github.com/rastian/interaction-design-skills) — Nielsen response-time loading thresholds (`100ms / 1s / 10s`) & IxD affordance/feedback principles
  96. - [arhamhi/oxfords](https://github.com/arhamhi/oxfords) — `prefers-contrast: more` triad, interruptible return-origin motion & monospace restraint
  97. - [alexgreensh/anidoodle](https://github.com/alexgreensh/anidoodle) — Deterministic seeded PRNG, `ctx.filter` ban in per-frame 2D Canvas & seamless periodic loops
  98. - [adgoodma/interactive-web-designer](https://github.com/adgoodma/interactive-web-designer) — Glass overlay hygiene, complete interactive states & restrained design-spell discipline
  99. - [zlbigger/immersive-poetry-page](https://github.com/zlbigger/immersive-poetry-page) — Beat-based narrative arc & single visual bible consistency
  100. - [cortiz2894/showcase-images](https://github.com/cortiz2894/showcase-images) — `OffscreenCanvas` Texture Atlas packing & physics-based virtual scroll
  101. - [Sunil56224972/The-Drawn-Dimenstion](https://github.com/Sunil56224972/The-Drawn-Dimenstion) — `gl.compileAsync()` shader warmup, adaptive hardware performance tiering & `ScreenReaderOverlay`
  102. - [Itssanthoshhere/Macbook-Landing-Page](https://github.com/Itssanthoshhere/Macbook-Landing-Page) & [udithavithanage/3d-web](https://github.com/udithavithanage/3d-web) — R3F + `@gsap/react` showcase patterns
  103. - [rudra-xi/memoir-veritas](https://github.com/rudra-xi/memoir-veritas), [Abdul-Ahad888/ScrollWorld](https://github.com/Abdul-Ahad888/ScrollWorld), [zyna-b/React-GSAP-Animated-Studio-website](https://github.com/zyna-b/React-GSAP-Animated-Studio-website), [giksaw/valentines2026](https://github.com/giksaw/valentines2026) — GSAP storytelling, WebP asset pipelines & studio UI transitions
  104. - [latentcat/latentbox](https://github.com/latentcat/latentbox) — Curated Web3D & creative-coding showcase directory (`awesome-web3d`) for visual research
  105. - UI8 *Fly* (`remix.ui8.ai/fly`) — Inspiration for M11 lightweight (<32KB) 2D Canvas Sprite Stacking & multi-camera HUD UX

Ratings and comments

Sign in to rate this skill.

Sign in

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