# swarm-cursors

The swarm-cursors Claude Code skill adds a Swarm effect that lets colored cursors redraw a website over its original page. It activates when asked to add, configure, target, or remove the effect.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 124 repo stars
- Author: harshit403-pixel
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/harshit403-pixel/reveal-cursors/tree/HEAD/swarm-cursors/SKILL.md
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/swarm-cursors

## What it does

The skill adds a script that covers a page with a blank canvas, then animates colored cursors as they recreate its visible layout. Visitors can start it with a floating button; the trigger can instead be configured for automatic playback, a hotkey, or a link. The effect can target selected pages, while the original DOM remains unchanged.

For plain HTML, an installer copies the engine beside the page files and inserts a marked block before `</body>`. On other platforms, place `assets/swarm-cursors.js` in the served folder and add its tag. WebGL canvases, video, and cross-origin iframes appear as gray placeholders. A CSP that omits `'unsafe-inline'` from `style-src` prevents rendering; allowing it changes the site's security policy.

## Requirements
- Works with: Figma

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/swarm-cursors/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/swarm-cursors/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/swarm-cursors/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/swarm-cursors/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install harshit403-pixel/reveal-cursors swarm-cursors
```

2. **Manually: put the files in place**
- File: `.github/skills/swarm-cursors/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/harshit403-pixel/reveal-cursors --path swarm-cursors
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/swarm-cursors/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/harshit403-pixel/reveal-cursors/tree/HEAD/swarm-cursors/SKILL.md

## When to use it
- add the Swarm cursor effect to a site or page
- set the effect to start from a button, link, or page load
- limit playback to selected pages
- remove the effect from a website

## Example prompts
- Add the Swarm effect to the homepage with a button visitors can click.
- Set the Swarm effect to start automatically when the page loads.
- Remove the Swarm effect from the site.

## Similar
- [figma](https://affpapa.org/en/nevibecode/skills/heygen-com-figma.md) — skill · 466500 installs
- [image](https://affpapa.org/en/nevibecode/skills/image.md) — skill · 99300 installs
- [build-design](https://affpapa.org/en/nevibecode/skills/build-design.md) — skill · 11100 installs
- [figma-generate-design](https://affpapa.org/en/nevibecode/skills/figma-figma-generate-design.md) — skill · 6600 installs
- [qa-test-planner](https://affpapa.org/en/nevibecode/skills/qa-test-planner.md) — skill · 4400 installs
- [design-handoff](https://affpapa.org/en/nevibecode/skills/design-handoff.md) — skill · 4000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
