swarm-cursors — Claude Code skill: cursor effect
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.
no license ★ 124 updated 2026-11-12
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a claude-codeWhat swarm-cursors 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.
What it helps with
- 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 for the agent
- 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.
How to install swarm-cursors
1Skills CLI (Vercel)
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a claude-code2Manually: put the files in place
~/.claude/skills/swarm-cursors/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/swarm-cursors/
1Skills CLI (Vercel)
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a codex2Manually: put the files in place
.agents/skills/swarm-cursors/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a cursor2Manually: put the files in place
.cursor/skills/swarm-cursors/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install harshit403-pixel/reveal-cursors swarm-cursors2Manually: put the files in place
.github/skills/swarm-cursors/SKILL.md1Skills CLI (Vercel)
npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a gemini-cli2Platform CLI
gemini skills install https://github.com/harshit403-pixel/reveal-cursors --path swarm-cursorsManually: put the files in place
.devin/skills/swarm-cursors/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about swarm-cursors
How do I install swarm-cursors in Claude Code?
Run npx skills add harshit403-pixel/reveal-cursors --skill swarm-cursors -a claude-code. The skill file is placed at ~/.claude/skills/swarm-cursors/SKILL.md.
What does swarm-cursors do?
It adds a visual page effect where colored cursors recreate the layout on a canvas layered over the original. The skill can also configure its trigger, limit the pages it runs on, or remove it.
Which page elements does the swarm-cursors effect not reproduce?
WebGL canvases, video, and cross-origin iframes show as gray placeholders. Rendering also fails when the site's CSP excludes 'unsafe-inline' from style-src.