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.