scrollytelling-web
Design and implement cinematic scroll-driven web narratives: pinned scenes, scrubbed timelines, product decomposition, image sequences, section transitions, spatial storytelling, and progressive 3D reveals
Install / Use
npx skills add anbeime/skill --skill scrollytelling-webInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of scrollytelling-web
scrollytelling-web scores 88/100 on our quality scale, 1821st of 4,698 Development & Engineering skills we index (top 39%).
Its SKILL.md is 8.5 KB long, well organised into 15 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 7,172 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so scrollytelling-web is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
scrollytelling-web compared with similar skills
All 4 of these similar skills score higher than scrollytelling-web; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scrollytelling-web (this skill)by anbeime | 88 | 7.2k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install scrollytelling-web?
- Run
npx skills add anbeime/skill --skill scrollytelling-web. The install tabs above show the steps for each supported agent. - Which AI agents does scrollytelling-web work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scrollytelling-web safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scrollytelling-web still maintained?
- The repository was last updated about 2 months ago, so scrollytelling-web is actively maintained.
Skill content
View source on GitHubname: scrollytelling-web description: "Design and implement cinematic scroll-driven web narratives: pinned scenes, scrubbed timelines, product decomposition, image sequences, section transitions, spatial storytelling, and progressive 3D reveals. Use when scroll itself drives the story."
Scrollytelling Web
Build scroll experiences as authored narratives, not a pile of parallax effects. Scroll is the user's timeline controller; every pinned section, camera move, reveal, and product transformation must advance understanding or emotion.
1. Storyboard before code
Convert the page into beats. For every beat define:
- what the user should understand or feel;
- what remains spatially stable;
- what changes with scroll progress;
- the entry and exit state;
- whether the user can stop at any intermediate frame without seeing a broken composition;
- mobile/reduced-motion alternative.
For a product-decomposition sequence, a useful structure is:
- establish the intact product;
- isolate the key assembly;
- explode parts along authored axes;
- hold long enough for labels/copy to explain them;
- move camera or product only after the part relationship is understood;
- reassemble or transition into the next narrative state.
Do not make everything move simultaneously. Choreography needs hierarchy.
2. Pick the smallest correct engine
Use the simplest tool that can express the intended motion well:
- CSS transitions / native scroll-driven animation β simple reveals, progress-linked decoration, sticky sections with modest transforms.
- Motion (
motion/react) β local React interactions, springs, component transitions, lightweight viewport effects. - GSAP + ScrollTrigger β default for serious scrollytelling: pinned/scrubbed timelines, coordinated multi-element chapters, horizontal story tracks, image-sequence scrubbing, long-form section handoffs, precise start/end markers.
- Lenis / smooth-scroll layer β only when the choreography materially benefits from controlled smoothing. Never add scroll hijacking as decorative infrastructure.
- Lottie / Rive β authored 2D/vector animations with well-defined state machines or timelines.
- Three.js / React Three Fiber β real 3D camera work, lighting, materials, exploded assemblies, depth, product rotations, particles, or scenes where flat DOM transforms would be a fake substitute.
If a 2D solution communicates the product just as well, do not pay the 3D complexity/performance tax.
3. Scroll model
Normalize complex scroll experiences around a semantic progress value (0..1) or named chapter states. Keep narrative state separate from raw browser events.
Do not wire dozens of independent scroll listeners that each call layout reads and state updates. Prefer one timeline/controller that owns the sequence.
For GSAP, pair with gsap-scrolltrigger. For React, also apply the project's lifecycle/cleanup conventions and keep hot continuous values out of React render state.
4. Pinned scene rules
Pinned scenes work when the user understands why the page temporarily stops moving in document space.
- Pin a stable wrapper/stage; animate descendants or scene state rather than fighting the pinned element's own transform.
- Give the sequence enough scroll distance to read, but do not make the user grind through empty motion.
- Design the exact first and last frame so the handoff back to normal document flow is seamless.
- Avoid multiple nested pins unless there is a compelling reason and tested behavior.
- Recompute positions after asset/font/layout changes when the animation engine requires it.
- Test browser resize, dynamic address bars, and orientation changes.
5. Product exploded views
When the brief asks to βdescompose/despiezar/explotarβ a product:
Asset preparation
Prefer a properly authored GLB/glTF with meaningful node names and pivots. Parts that must separate independently need separate meshes/groups. Preserve a hierarchy that matches the product's conceptual assemblies.
If only a flattened render/image exists, do not pretend it is genuine 3D. Use an image-sequence/masked 2.5D treatment or request/produce the missing 3D asset through the project's asset workflow.
Explosion choreography
- Define an intact pose and an exploded pose for each semantic part.
- Use authored local axes or vectors; random radial explosions look like a debug visualization.
- Stagger related assemblies in logical order.
- Keep labels anchored to the relevant part and readable through camera motion.
- Let camera movement support the part motion, not compete with it.
- Reserve depth, rotation, focus changes, and lighting shifts for explanatory emphasis.
Scene quality
For premium product work, lighting/material/camera quality matters as much as the scroll linkage. Use physically plausible materials when the object demands realism, intentional environment/reflections, restrained post-processing, and consistent tone mapping. Avoid excessive bloom and βtech neonβ unless the brand actually calls for it.
Use threejs-product-storytelling for the scene-specific craft layer.
6. Image-sequence scrollytelling
For photorealistic product transformation without real-time 3D, pre-rendered sequences are often the best solution.
- Decode/preload intelligently around the current frame instead of loading hundreds of full-size frames synchronously.
- Prefer modern formats where the delivery pipeline supports them.
- Draw to a canvas sized for the displayed resolution, not the original camera master.
- Map scroll progress monotonically to frame index; avoid jitter from repeated rounding around boundaries.
- Provide a poster/static state before the sequence is ready.
- On constrained mobile/network conditions, fall back to a short video/static milestone sequence if needed.
7. Typography and narrative layering
Copy is part of the choreography. Avoid forcing users to read paragraphs while the visual target is still moving aggressively.
A reliable pattern is: movement β settle/hold β explanation β movement. Keep text spatially stable during reading moments unless kinetic type itself is the concept.
8. Performance budget
Cinematic does not mean unbounded.
- Prefer transforms/opacity and engine-managed transforms on hot paths.
- Avoid synchronous layout thrashing.
- Lazy-load below-the-fold heavy scenes.
- For WebGL, cap device pixel ratio deliberately, especially on mobile/high-DPR devices.
- Compress textures and geometry; use sensible texture dimensions and mipmaps.
- Pause rendering/animation when a scene is no longer visible where possible.
- Dispose GPU resources when scenes unmount.
- Do not make a full Three.js render loop run forever for a static offscreen scene.
- Keep DOM overlay count reasonable inside long pinned scenes.
- Profile the actual target browser/device instead of assuming 60 fps from a desktop dev machine.
Pair with gsap-performance for GSAP-heavy work and normal frontend performance tooling for the rest.
9. Accessibility and input
Scroll storytelling must remain content, not a trap.
- Honor
prefers-reduced-motion; provide a meaningful static/chapter-based version rather than merely setting durations to zero while preserving bizarre intermediate states. - Do not make essential content exist only at one transient animation frame.
- Preserve normal page scrolling unless there is an exceptional, justified experience mode.
- Touch users need an equally understandable composition without hover assumptions.
- Keyboard users must be able to reach interactive content inside/around pinned sequences without focus disappearing behind layers.
- Avoid rapid flashing and vestibularly aggressive camera moves.
10. Verification contract
Before claiming done:
- verify the sequence from start to finish at a desktop viewport;
- verify at a narrow mobile viewport;
- inspect at important scroll milestones (start, 25%, 50%, 75%, end or semantic beats);
- verify reverse scrolling;
- resize mid-sequence;
- test reduced-motion;
- inspect console/runtime errors;
- check that sticky/pinned sections do not leave blank gaps or jump on handoff;
- profile obvious frame drops and memory leaks;
- confirm content remains understandable with motion disabled.
A screenshot of only the hero is not evidence that scrollytelling works.
Pairing
Use with:
design-taste-frontendβ art direction;impeccableβ composition/craft;emil-design-engβ motion feel;gsap-scrolltriggerβ scroll mechanics;gsap-performanceβ hot-path correctness;threejs-product-storytellingβ genuine 3D product scenes;browser-testing-with-devtoolsβ rendered verification.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code β from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio β 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
