samyost1/3dicon

One prompt in, a looping animated 3D icon out — with real transparency. A Claude Code skill.

What it is

/3dicon is a small, self‑hosted tool that turns a natural‑language prompt into a looping, animated 3D icon (exported as a WebP with real alpha transparency). It is designed to be called from a Claude‑style plugin or from the command line and produces an asset you can drop straight into a UI.

How it works

Prompt → still image – The user’s text is sent to an image generation model (referred to as GPT Image) via OpenRouter, producing a single 3D‑style picture.
First & last frame – The same still image is used as both the first and the last frame of a short video clip.
Video model – A video‑generation model (named Seedance) creates the intermediate frames, ensuring the motion loops back to the original still.
Matting – Each frame is run through a matting model that removes the background against a known colour, allowing exact reconstruction of the original colours and clean soft edges.
Export – The processed frames are assembled into an animated WebP that retains true transparency.

The key trick is re‑using the still as both start and end, which forces the video model to produce a seamless loop.

Installation steps

# Add the plugin to your Claude/assistant environment
/plugin marketplace add samyost1/3dicon
/plugin install 3dicon

# Clone the skill locally (the path shown is where Claude stores skills)
cd ~/.claude/skills/3dicon
pip install -r requirements.txt   # install Python deps
cp .env.example .env               # copy env template

Edit .env and insert your OpenRouter API key:

OPENROUTER_API_KEY=sk-or-…

Make sure ffmpeg is available on your system PATH – the first run will also download a ~180 MB matting model.

Using the tool

From a Claude chat (or any interface that forwards commands to the plugin) simply ask in plain language, for example:

make an animated 3d fire icon using /3dicon

The workflow is interactive:

The system generates a still image and shows it.
You confirm the still (so you only pay for motion if you like the result).
It then proposes the animated motion; you confirm again.
The final animated WebP is returned.

License & ownership

The code is released under the MIT license. Any icons you generate are yours without any additional restrictions.

All details above are taken directly from the repository’s README.