
reveal-hover-effect
Build cursor-following spotlight reveals that expose a second aligned image through a soft radial mask. Use for hover-to-color, before-and-after, x-ray, material, texture, product-detail, and illustrated hero effects where a desaturated or embossed base image should remain visible while another treatment follows an eased pointer.
- Installs
- 100
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/boraoztunc/skills --skill reveal-hover-effect- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads reveal-hover-effect automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Reveal Hover Effect
Core Contract
- Prepare two images with identical dimensions, composition, crop, and focal point.
- Keep the base image fully visible.
- Stack the reveal image directly above it.
- Apply a feathered radial
mask-imageto the reveal image. - Track pointer coordinates in the component's local coordinate space.
- Ease the rendered position toward the raw pointer with
requestAnimationFrame. - Collapse the mask on pointer exit; never leave a stale spotlight behind.
Default to CSS masks instead of generating a canvas data URL every frame. The CSS version preserves the same look with less allocation and simpler cleanup.
Motion Defaults
- Desktop spotlight radius:
260px. - Compact spotlight radius:
140pxto220px. - Pointer easing:
0.1. - Radius easing:
0.14. - Mask stops:
0%: alpha140%: alpha160%: alpha0.7575%: alpha0.488%: alpha0.12100%: alpha0
- Initial state: base image only.
- Exit state: radius eases back to
0. - Cursor: keep the native cursor unless the design explicitly needs a custom one.
Markup
Use real images so loading, intrinsic sizing, and accessibility remain predictable.
<figure class="reveal-hover" data-reveal-hover data-reveal-radius="260">
<img
class="reveal-hover__image reveal-hover__image--base"
src="/images/product-linework.webp"
alt="Sculpted product shown in a pale linework treatment"
width="1600"
height="1000"
decoding="async"
/>
<img
class="reveal-hover__image reveal-hover__image--overlay"
src="/images/product-color.webp"
alt=""
width="1600"
height="1000"
decoding="async"
aria-hidden="true"
/>
</figure>
Keep the overlay decorative when both images communicate the same subject. If the comparison carries unique information, provide visible labels or a separate accessible description.
CSS Mask
.reveal-hover {
--reveal-x: 50%;
--reveal-y: 50%;
--reveal-radius: 0px;
position: relative;
overflow: clip;
isolation: isolate;
margin: 0;
background: #f3f1ec;
contain: paint;
}
.reveal-hover__image {
display: block;
width: 100%;
height: 100%;
object-fit: cover;
object-position: center;
}
.reveal-hover__image--base {
position: relative;
z-index: 0;
}
.reveal-hover__image--overlay {
position: absolute;
z-index: 1;
inset: 0;
pointer-events: none;
-webkit-mask-image: radial-gradient(
circle var(--reveal-radius) at var(--reveal-x) var(--reveal-y),
rgb(0 0 0 / 1) 0%,
rgb(0 0 0 / 1) 40%,
rgb(0 0 0 / 0.75) 60%,
rgb(0 0 0 / 0.4) 75%,
rgb(0 0 0 / 0.12) 88%,
transparent 100%
);
mask-image: radial-gradient(
circle var(--reveal-radius) at var(--reveal-x) var(--reveal-y),
rgb(0 0 0 / 1) 0%,
rgb(0 0 0 / 1) 40%,
rgb(0 0 0 / 0.75) 60%,
rgb(0 0 0 / 0.4) 75%,
rgb(0 0 0 / 0.12) 88%,
transparent 100%
);
-webkit-mask-repeat: no-repeat;
mask-repeat: no-repeat;
will-change: -webkit-mask-image, mask-image;
}
@media (hover: none), (pointer: coarse) {
.reveal-hover__image--overlay {
display: none;
}
}
Keep object-fit and object-position identical on both layers. A one-pixel mismatch becomes obvious inside the spotlight.
Eased Pointer Tracking
Run the animation loop only while values are changing. Convert clientX and clientY with getBoundingClientRect(); page coordinates will drift after scroll.
function initRevealHover(element) {
const overlay = element.querySelector(".reveal-hover__image--overlay");
const finePointer = window.matchMedia("(hover: hover) and (pointer: fine)");
const reduceMotion = window.matchMedia("(prefers-reduced-motion: reduce)");
if (!overlay || !finePointer.matches) return () => {};
const state = {
x: 0,
y: 0,
targetX: 0,
targetY: 0,
radius: 0,
targetRadius: 0,
clientX: 0,
clientY: 0,
inside: false,
frame: 0,
};
const getRadius = () => {
const requested = Number.parseFloat(element.dataset.revealRadius);
if (Number.isFinite(requested)) return requested;
return Math.min(260, Math.max(140, element.clientWidth * 0.22));
};
const updateTarget = (clientX, clientY) => {
const rect = element.getBoundingClientRect();
state.clientX = clientX;
state.clientY = clientY;
state.targetX = clientX - rect.left;
state.targetY = clientY - rect.top;
};
const schedule = () => {
if (!state.frame) state.frame = requestAnimationFrame(tick);
};
const tick = () => {
state.frame = 0;
const positionEase = reduceMotion.matches ? 1 : 0.1;
const radiusEase = reduceMotion.matches ? 1 : 0.14;
state.x += (state.targetX - state.x) * positionEase;
state.y += (state.targetY - state.y) * positionEase;
state.radius += (state.targetRadius - state.radius) * radiusEase;
element.style.setProperty("--reveal-x", `${state.x.toFixed(2)}px`);
element.style.setProperty("--reveal-y", `${state.y.toFixed(2)}px`);
element.style.setProperty("--reveal-radius", `${state.radius.toFixed(2)}px`);
const unsettled =
Math.abs(state.targetX - state.x) > 0.1 ||
Math.abs(state.targetY - state.y) > 0.1 ||
Math.abs(state.targetRadius - state.radius) > 0.1;
if (unsettled) schedule();
};
const onPointerEnter = (event) => {
state.inside = true;
updateTarget(event.clientX, event.clientY);
if (state.radius < 0.5) {
state.x = state.targetX;
state.y = state.targetY;
}
state.targetRadius = getRadius();
schedule();
};
const onPointerMove = (event) => {
updateTarget(event.clientX, event.clientY);
// A page can load with the pointer already over this element, so the
// first pointermove may arrive without a preceding pointerenter.
if (!state.inside) {
state.inside = true;
if (state.radius < 0.5) {
state.x = state.targetX;
state.y = state.targetY;
}
state.targetRadius = getRadius();
}
schedule();
};
const hideReveal = () => {
state.inside = false;
state.targetRadius = 0;
schedule();
};
const onViewportChange = () => {
if (!state.inside) return;
updateTarget(state.clientX, state.clientY);
state.targetRadius = getRadius();
schedule();
};
element.addEventListener("pointerenter", onPointerEnter);
element.addEventListener("pointermove", onPointerMove);
element.addEventListener("pointerleave", hideReveal);
element.addEventListener("pointercancel", hideReveal);
window.addEventListener("blur", hideReveal);
window.addEventListener("scroll", onViewportChange, { passive: true });
const resizeObserver = new ResizeObserver(onViewportChange);
resizeObserver.observe(element);
return () => {
if (state.frame) cancelAnimationFrame(state.frame);
resizeObserver.disconnect();
element.removeEventListener("pointerenter", onPointerEnter);
element.removeEventListener("pointermove", onPointerMove);
element.removeEventListener("pointerleave", hideReveal);
element.removeEventListener("pointercancel", hideReveal);
window.removeEventListener("blur", hideReveal);
window.removeEventListener("scroll", onViewportChange);
};
}
const revealHoverCleanups = Array.from(
document.querySelectorAll("[data-reveal-hover]")
).map(initRevealHover);
In React, Vue, or Svelte, initialize after mount and call every returned cleanup during unmount. Do not create a new animation loop on every render.
Optional Grid Parallax
Add a subtle grid only when it supports the art direction.
- Use a
48pxSVG or CSS grid. - Keep opacity near
0.1. - Normalize the eased pointer around the component center.
- Limit drift to
±16px. - Ease grid offset with factor
0.06, slower than the reveal. - Disable the drift under
prefers-reduced-motion.
The grid is atmosphere, not the focal interaction. It should barely move.
Nested Glass or Refraction Cards
When a foreground card must reveal the same alternate treatment:
- Stack the same base and reveal assets inside the card.
- Use the same viewport pointer state.
- Subtract the card's
getBoundingClientRect().leftand.topbefore setting its local mask coordinates. - Preserve the card's own crop and border radius.
- Update the card and hero from the same animation frame so the refraction does not lag.
Touch and Accessibility
- Default coarse pointers to the static base image.
- If the reveal contains meaningful information, add an explicit “Show alternate” control for touch and keyboard users.
- Do not rely on hover to expose navigation, pricing, instructions, or essential copy.
- Under reduced motion, update the spotlight directly without trailing easing and disable parallax.
- Keep the native cursor visible so the reveal center remains obvious.
Performance Rules
- Animate CSS custom properties from one
requestAnimationFrameloop. - Stop the loop after the pointer and radius settle.
- Do not call
canvas.toDataURL()every frame. - Keep both images at the same encoded dimensions and responsive source set.
- Use
will-changeonly on the masked overlay. - Test Safari with both
mask-*and-webkit-mask-*. - Avoid masking a huge page-sized layer when the effect only occupies one component.
Quick Checks
- Base and reveal assets remain pixel-aligned at every breakpoint.
- The reveal begins under the pointer rather than sweeping in from the component center.
- The first pointer movement reveals correctly when the page loads under a stationary cursor.
- The full-strength core holds through
40%of the radius. - The feather reaches full transparency at the edge without a visible ring.
- Pointer exit and window blur collapse the mask.
- Scrolling while hovered does not detach the spotlight from the cursor.
- Touch users get a deliberate static or toggle fallback.
- Reduced-motion mode has no trailing movement or grid drift.
- The animation loop stops when idle and cleans up on route changes.
FAQ
What does the reveal-hover-effect skill do?
Build cursor-following spotlight reveals that expose a second aligned image through a soft radial mask. Use for hover-to-color, before-and-after, x-ray, material, texture, product-detail, and illustrated hero effects where a desaturated or embossed base image should remain visible while another treatment follows an eased pointer.
How do I install reveal-hover-effect?
Run npx skills add https://github.com/boraoztunc/skills --skill reveal-hover-effect in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/reveal-hover-effect/ (personal) or .claude/skills/reveal-hover-effect/ (project).
Which AI agents can use reveal-hover-effect?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is reveal-hover-effect safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains reveal-hover-effect?
It is published by boraoztunc in boraoztunc/skills. It has 100 recorded installs.
More from boraoztunc/skills
ogilvy-copywriting
boraoztunc/skills
Apply David Ogilvy's advertising principles when writing or reviewing copy, headlines, product descriptions, landing pages, ads, emails, or any persuasive text. Use when the goal is copy that sells, not copy that wins awards. Covers positioning, headlines, promises, brand voice, long-form copy, and visual logic. Source: How to Create Advertising That Sells (1972) + Ogilvy on Advertising.
copywriting
boraoztunc/skills
Open the skill to read its SKILL.md instructions.
copy-editing
boraoztunc/skills
Open the skill to read its SKILL.md instructions.
content-strategy
boraoztunc/skills
Open the skill to read its SKILL.md instructions.
page-cro
boraoztunc/skills
Open the skill to read its SKILL.md instructions.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image