Repolode
Submit
oil-oil

oil-oil/oil-motion

An agent skill that designs AI-generated motion and wires it to scroll, mouse, drag, touch, or device orientation on web pages.

View on GitHub
Stars
2,619
Forks
196
Open issues
1
Last commit
14 days ago

What is it?

Oil Motion is an agent-agnostic skill for building interactive web animations. You describe what the motion should express, supply reference assets, and specify what input should drive it. The agent then plans key frames, generates continuous video between them with AI video models, checks frames for jumps and flicker, and compresses the result for the display size used on the page.

The output is a web-ready asset, such as an alpha WebP sprite sheet, a green-screen MP4, or a baked scene MP4, plus the interaction code that maps scroll, pointer, drag, touch, or device tilt to animation progress. Position, scale, easing and maximum rotation speed are handled in code rather than regenerated by the video model. Local processing of existing video and frame sequences needs Python 3.10+ and FFmpeg; AI generation defaults to the ZenMux API, with the key stored in the system credential store.

Key features

  • 01Plans key frames before generating continuous motion between them with AI video.
  • 02Maps scroll, mouse, drag, touch, or device orientation to animation progress.
  • 03Chooses between baked MP4, alpha WebP sprite sheets, and green-screen MP4 based on use case.
  • 04Compresses assets according to the actual display size on the page.
  • 05Stores the API key in the system credential store rather than in chat.

Use cases

  • A product page where the item unfolds into an exploded view as the user scrolls.
  • A character whose face or gaze follows the mouse cursor.
  • A 360° hardware turntable controlled by dragging.
  • A scroll-driven story that moves through several scenes in one continuous shot.

Topics

#agent-skill#web-animation#scroll-animation#ai-video#interactive#frontend#motion-design#agent-skills#animation#claude-code

FAQ

What is oil-motion?
An agent skill that designs AI-generated motion and wires it to scroll, mouse, drag, touch, or device orientation on web pages. Oil Motion is an agent-agnostic skill for building interactive web animations. You describe what the motion should express, supply reference assets, and specify what input should drive it. The agent then plans key frames, generates continuous video between them with AI video models, checks frames for jumps and flicker, and compresses the result for the display size used on the page.
Is oil-motion free to use? What license does it have?
oil-motion is open source under the MIT license. Check the license terms before using it in commercial products.
Is oil-motion still maintained?
Actively maintained. The last commit to oil-motion was on Oct 4, 2026.
What can I use oil-motion for?
A product page where the item unfolds into an exploded view as the user scrolls. A character whose face or gaze follows the mouse cursor. A 360° hardware turntable controlled by dragging. A scroll-driven story that moves through several scenes in one continuous shot.
Where can I get oil-motion?
The source code and installation instructions are on GitHub: https://github.com/oil-oil/oil-motion

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects