mouse-swarm-reveal
Installation
SKILL.md
Mouse Swarm Reveal
Create the complete, usable page first. Choose the mode explicitly:
- Reveal: simulated cursors choreograph a sequential presentation. They are not agents, computer input, or telemetry.
- Ruflo observation: the local bridge reports agent registrations and statuses from the CLI. It does not start agents, prove task execution, or supply cursor coordinates.
- Both: keep the visual reveal and observed status clearly labeled and separate. Only show a live marker when the trusted source actually supplies its coordinates.
Use assets/demo.html for the existing working reference. The bundled browser modules are self-contained and have no runtime dependencies.
Workflow
- Inspect the project instructions, framework, entry point, existing styles, and available assets. Identify the content, brand, links, and intended reveal sequence. Reuse assets only when authorized. If given a URL, work from authorized content and available source; do not assume the site permits cross-origin fetching or reproduce third-party assets without permission.
- Add
data-swarm-itemto meaningful elements in document order. Keep targets at one hierarchy level: marking a parent and its descendants can hide content unexpectedly. Adddata-swarm-typeonly to leaf elements with plain text; the module replaces their text temporarily during the animation. - Integrate the bundled
assets/mouse-swarm.js. For a static site, copy it into a public assets directory and import it as a browser ES module. For a bundled app, install the repository package withnpm install github:ruvnet/mouse-swarmand import from@ruvector/mouse-swarm. - Initialize after the target DOM exists. The module captures targets at initialization, so recreate the instance after a material target list change. Configure cursor count, colors, labels, size, motion speed, bot frequency, selection outline, typing cadence, and optional scrolling to suit the project. Expose keyboard-accessible replay, pause, resume, and skip controls that stay visible throughout the reveal. In component frameworks, call
destroy()on unmount.
import { createSwarmReveal } from '@ruvector/mouse-swarm';