svg-mascot-animator
Skill14 starsChanged 3 months agoMITView on GitHub
Animate an exact SVG mascot, logo, icon, or character with identity-preserving, rig-aware, professional motion for deterministic or runtime delivery tracks.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- imMamdouhaboammar/svg-mascot-animatortheir own version, first seen Aug 17, 2026
- imMamdouhaboammar/vibe-svgstheir own version, first seen Jul 25, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- imMamdouhaboammar/vibe-svgs★ 4same name
- imMamdouhaboammar/svg-mascot-animator★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository19 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .codex/AGENTS.mdAGENTS.md
- docs/agents.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- linkedin-animated-infographicsSkill
- linkedin-animated-infographics-conventionsSkill
- arabicSkill
- artboardSkill
- captionSkill
- info-storiesSkill
- mascotsSkill
- masteroneSkill
- motionSkill
- new-postSkill
- postSkill
- qa-postSkill
- render-gifSkill
- renderSkill
- share-demoSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 3 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 13
Read helper/GUIDE.md first.
- Distinctive: line 17
Use when the user supplies an SVG for animation, names an official mascot that must be used exactly, requests believable mascot motion, or …
- Very specific: line 34
If the exact SVG is missing in the main conversational context, ask the user to upload the exact SVG and stop.
- Very specific: line 49
Read references/creative-directions.md, references/rigging.md, references/physics.md, references/animejs.md, and references/contract.md as …
- Distinctive: line 51
Use believable relationships such as projectile paths, damped landing reactions, pendulum timing for genuine swings, contact shadows …
- Distinctive: line 52
Avoid constant bouncing, random blinking, large rotations, unmotivated floating, or deformation that changes the mascot's identity.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SVG Mascot Animator
Purpose
Animate the exact supplied SVG while preserving identity-critical geometry, colors, marks, proportions, and recognizable details. Animation adds behavior around the user's asset; it does not redesign the mascot.
Read helper/GUIDE.md first. For named or official mascots, the exact-SVG gate is mandatory.
Use when
Use when the user supplies an SVG for animation, names an official mascot that must be used exactly, requests believable mascot motion, or needs a mascot component for an Info-story or interactive web context.
Inputs
- exact user-supplied/task-attached SVG when identity must be preserved
- validated
build/mascot-request.jsonwhen used in the infographic workflow - approved communication job and creative direction
- output track: deterministic baked/static or runtime interactive
- approved layout/motion constraints when embedded in an infographic
Outputs
Return animated asset/component, inspection report, chosen creative direction, physics/timing rationale, identity-preservation notes, rig limitations, and the motion contract/evidence needed by downstream motion, render, critique, and verification workers.
Procedure
- For a named or official mascot, require the exact SVG before animation begins. Keep an untouched copy of the source.
- If the exact SVG is missing in the main conversational context, ask the user to upload the exact SVG and stop. Inside a worker, return
HOLD: exact SVG requiredto the parent workflow. - Validate the request contract:
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/mascot_contract.py check build/mascot-request.json- Inspect the SVG before promising articulation:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/svg-mascot-animator/scripts/inspect_svg.py <path-to-svg>Record viewBox, bounds, IDs, groups, transforms, clips, paths, and addressable parts. Do not silently split identity-critical geometry to fake articulation.
5. Choose the delivery track. Deterministic self-contained SVG/CSS/SMIL is the default for LinkedIn GIFs and frame capture. Runtime Anime.js is valid only when the target environment genuinely supports interaction.
6. Read references/creative-directions.md, references/rigging.md, references/physics.md, references/animejs.md, and references/contract.md as needed.
7. Define the motion job before keyframes. Specify communication purpose, exact existing SVG parts allowed to move, optional non-identity support elements, loop/reset behavior, and motion budget.
8. Use believable relationships such as projectile paths, damped landing reactions, pendulum timing for genuine swings, contact shadows derived from height, velocity-linked squash/stretch, anticipation, and follow-through only on addressable parts.
9. Avoid constant bouncing, random blinking, large rotations, unmotivated floating, or deformation that changes the mascot's identity.
10. Support elements such as route lines, cursors, cards, badges, or contact shadows must remain visually separate from the identity source and removable without changing the official mascot.
11. Verify the output:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/svg-mascot-animator/scripts/check_asset.py <output.svg>
python3 ${CLAUDE_PLUGIN_ROOT}/skills/svg-mascot-animator/scripts/check_asset.py --runtime <scene.html>- Compare the result with the untouched source and confirm identity, purpose, loop closure, frame-zero readability when used in an infographic, reduced-motion behavior, accessible labeling, namespaced IDs/keyframes, and zero accidental network dependencies for baked assets.
HOLD conditions
Return a HOLD when the exact SVG is missing, the requested articulation is impossible without identity-changing redraw, required brand details are ambiguous, the runtime track is requested in an environment that cannot support it, or the requested motion would violate the infographic's approved reading order or evidence boundary.
Related components
- routing authority:
helper/GUIDE.md - infographic mascot skill:
skills/mascots/SKILL.md - focused worker:
agents/mascot-animator.md - request validator:
scripts/mascot_contract.py - creative directions:
references/creative-directions.md - rigging:
references/rigging.md - physics:
references/physics.md - asset contract:
references/contract.md
Research gates
Mascot identity/rigging is a local-native capability. When embedded in the complete infographic route, inherit applicable design-dials, structural-originality, evidence-traceability, and bounded-verification gates from the parent workflow.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

