cursor-reveal-hero

Implement a cursor-tracking masked reveal hero section with verified CSS and JavaScript.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/timikalo7/Execute --skill cursor-reveal-hero-timikalo7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cursor-reveal-hero
Source: https://github.com/timikalo7/Execute/tree/main/.claude/skills/cursor-reveal-hero
Command: npx skills add https://github.com/timikalo7/Execute --skill cursor-reveal-hero-timikalo7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes references (resource) components.

What problem does it solve? Static hero sections often fail to create a memorable first impression, and interactive reveal effects frequently break on touch devices, ignore reduced-motion preferences, or suffer from misaligned image layers that ruin the illusion. ## Core Features & Use Cases - Two-layer mask engine: Stacks a base image and a living video layer, revealing the second through a soft radial-gradient mask driven by two CSS custom properties. - Accessibility and fallback handling: Covers touch-device anchoring, prefers-reduced-motion snapping, @supports mask detection, and LCP-optimized asset loading. - Asset alignment pipeline: Guides generation of matching dead/living image pairs via image-to-image models so silhouettes and camera angles line up. - Use Case: A designer needs a hero where moving the cursor transforms a dead volcanic rock into a living ecosystem; this Skill provides the working code, the asset generation workflow, and a pixel-level verification script. ## Quick Start Ask the agent to build a cursor-reveal hero section for the landing page using the reference implementation and verify it with the included script.

Frequently Asked Questions about cursor-reveal-hero

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a cursor reveal effect for a hero section?

Stack two pixel-aligned layers and mask the top one with a radial-gradient centered on CSS custom properties updated by pointer events. Batch updates into requestAnimationFrame and stop the loop once the mask catches up to avoid battery drain.

How do I make a cursor reveal effect work on touch devices?

Touch devices have no hover, so park the mask at a designed anchor position as the resting state and let drag gestures move it. Never let mobile users see only the unrevealed base layer when the design intends a glimpse of the second state.

Does a CSS mask reveal work with prefers-reduced-motion?

Yes, the reveal itself is fine at WCAG AA because it follows the user's own hand. Remove the easing lag under prefers-reduced-motion by snapping the mask to the pointer instead, and do not autoplay the video layer.

Why do the two layers of my reveal effect not line up?

Misalignment is an asset problem, not a code problem. Generate the base image first, then create the second state via image-to-image from that exact image with instructions to keep the silhouette and camera, rather than generating both independently.

How do I verify a CSS mask actually tracks the pointer?

Drive a headless browser with Playwright, move the pointer, and sample actual pixels at the anchor and pointer positions via screenshots. Also test a deliberately broken copy with a pinned mask to prove the checks can fail.

When should I not use a cursor reveal interaction?

Avoid it when the revealed layer carries information the page must communicate, since keyboard users, screen-reader users, and anyone who never moves the mouse over that spot will never see it. It is decoration on top of a complete page, never a content delivery mechanism.