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

  1. 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.
  2. Add data-swarm-item to meaningful elements in document order. Keep targets at one hierarchy level: marking a parent and its descendants can hide content unexpectedly. Add data-swarm-type only to leaf elements with plain text; the module replaces their text temporarily during the animation.
  3. 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 with npm install github:ruvnet/mouse-swarm and import from @ruvector/mouse-swarm.
  4. 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';
Installs
7
GitHub Stars
30
First Seen
10 days ago