# svg-icon-enrichment

svg-icon-enrichment — a rule that teaches Claude Code and Codex to animate the inner parts of SVG icons: clock hands, scissor blades, pulsing dots, flowing dashes. For micro-animation without swapping the icons themselves.

- rule · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 78316 repo stars
- Author: calesthio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/hyperframes-animation/rules/svg-icon-enrichment.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/rules/svg-icon-enrichment

## What it does

The rule pushes the agent to see an SVG icon as a set of moving parts, not a flat image. Each meaningful child element gets its own GSAP-driven motion.

Four motion patterns are defined: rotation for clock hands and gears, oscillation for scissor blades and toggles, pulse for recording dots and hearts, and dash flow along strokes for data streams. Everything runs inside a paused GSAP timeline so frame seeking stays deterministic.

It is a sibling to svg-path-draw, which handles outline drawing. This rule covers internal parts, ideally once the outline is already drawn. GSAP loaded from a CDN and constants like `MIN_REVOLUTIONS`, `SEC_REVOLUTIONS`, `PULSE_CYCLES` are required for the timeline to build.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/rules/svg-icon-enrichment.md` — The paths frontmatter field limits the files

### Codex

**AGENTS.md**
- Codex reads AGENTS.md: paste the rule text there

### Cursor

**Manually: put the files in place**
- File: `.cursor/rules/svg-icon-enrichment.mdc` — Frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/instructions/svg-icon-enrichment.instructions.md` — The applyTo field sets which files it applies to

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/rules/svg-icon-enrichment.md`

### Cline

**Manually: put the files in place**
- File: `.clinerules/svg-icon-enrichment.md`

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/hyperframes-animation/rules/svg-icon-enrichment.md

## When to use it
- Spin clock hands and gears with rotation
- Make scissor blades and wings oscillate
- Add a pulse to a recording dot or heart
- Move dashes along a stroke like a data stream

## Example prompts
- Add a clock icon to the scene: minute hand does 2 revolutions, second hand 8 over 4 seconds
- Create a pulsing recording dot: 3 cycles over the scene, ring fades in counter-phase
- Animate a data stream: dashes flow left to right via strokeDashoffset

## Similar
- [svg-animation](https://affpapa.org/en/nevibecode/skills/svg-animation.md) — skill · 4400 installs
- [app-icon](https://affpapa.org/en/nevibecode/skills/daveebbelaar-app-icon.md) — skill · 1000 installs
- [svg-icon-generator](https://affpapa.org/en/nevibecode/skills/svg-icon-generator.md) — skill · 1400 installs
- [logo-animation](https://affpapa.org/en/nevibecode/skills/logo-animation.md) — skill · 5800 installs
- [gsap](https://affpapa.org/en/nevibecode/skills/mindrally-gsap.md) — skill · 815 installs
- [rendering-animate-svg-wrapper](https://affpapa.org/en/nevibecode/rules/rendering-animate-svg-wrapper.md) — rule · ★ 7191 repo stars

From the same set: [calesthio/openmontage](https://affpapa.org/en/nevibecode/by/calesthio/openmontage.md) — 101 cards

---
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
