Agent skill

Openrouter Image2video

by QinghongLin in QinghongLin/data2story-skill

Animate a still image into a short video via OpenRouter. An agent skill from QinghongLin/data2story-skill.

MITAuto-check passedAI & LLM Engineering

Install Openrouter Image2video

skills CLI
$ npx skills add QinghongLin/data2story-skill --skill openrouter-image2video -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install QinghongLin/data2story-skill openrouter-image2video --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/QinghongLin/data2story-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/data2story/designer/scripts/openrouter-image2video .claude/skills/openrouter-image2video && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
openrouter-image2video
GitHub stars
155
Token cost
~872 tokens
SKILL.md length
298 words
Files
3 (incl. scripts)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Animate a still image into a short video via OpenRouter. An agent skill from QinghongLin/data2story-skill.

  • Works in 3 steps: POST /api/v1/videos with body → GET /api/v1/videos/{id} every 5s until… → GET /api/v1/videos/{id}/content → raw…
  • Tasks that involve Model routing and gateways
  • SKILL.md covers Usage, Flags, Flow and Notes
  • Runs Python scripts from its folder; calls python3; needs OPENROUTER_API_KEY

What it does

Openrouter Image2video is an agent skill from QinghongLin/data2story-skill. Animate a still image into a short video via OpenRouter. Default model google/veo-3.1-fast.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `config.json` and `scripts/generate_video_from_image.py`).

It sits in AI & LLM Engineering, covering Model routing and gateways. It works with OpenRouter and Google Veo. The repository describes itself as: Data Journalist Agent: Transforming Data into Verifiable Multimodal Story. The licence is MIT.

When your agent uses it

  • Tasks that involve Model routing and gateways

Example prompts

  • “/openrouter-image2video”

Requirements

  • Python 3
  • A credential in OPENROUTER_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. POST /api/v1/videos with body
  2. GET /api/v1/videos/{id} every 5s until status == "completed"
  3. GET /api/v1/videos/{id}/content → raw MP4 bytes

What it can do on your machine

Read from SKILL.md and the folder at commit 63a55c1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENROUTER_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Openrouter Image2video loads about 872 tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 298 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~872

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from QinghongLin/data2story-skill at commit 63a55c1, republished under its MIT licence (© QinghongLin). 298 words, ~872 tokens.

Download SKILL.mdSave it as .claude/skills/openrouter-image2video/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
openrouter-image2video
description
Animate a still image into a short video via OpenRouter. Default model google/veo-3.1-fast.

openrouter-image2video

Image + motion-prompt → video via OpenRouter. Default model: google/veo-3.1-fast.

Use this when you already have a strong still image and want to bring it to life with subtle motion (camera pan, parallax, gentle animation) while preserving the composition. For motion-from-scratch, use openrouter-text2video instead.

The script accepts either a remote image URL or a local image path; local files are base64-encoded and inlined into the request as a data URL.

Usage

Resolve TOOL_DIR = the directory containing this SKILL.md. Commands below use TOOL_DIR as a symbolic placeholder; replace it with the resolved, quoted path before running Bash.

bash
export OPENROUTER_API_KEY=sk-or-v1-...

# From a local image you already generated with text2image
python3 TOOL_DIR/scripts/generate_video_from_image.py \
  --image PROJECT_DIR/assets/teaser.png \
  --prompt "slow parallax push-in, soft drift of ambient particles, no camera shake" \
  --duration 5 \
  --aspect-ratio 16:9 \
  --download PROJECT_DIR/assets/teaser.mp4

# Or from a remote URL
python3 TOOL_DIR/scripts/generate_video_from_image.py \
  --image-url "https://example.com/still.png" \
  --prompt "subtle camera dolly forward, gentle depth-of-field shift" \
  --download PROJECT_DIR/assets/scene.mp4

Flags

FlagDefaultDescription
--promptrequiredMotion prompt — describe what should move and how
--downloadrequiredOutput MP4 path
--imageone of --image / --image-url requiredLocal image path (PNG/JPG); will be base64-encoded
--image-urlone of --image / --image-url requiredRemote image URL
--modelgoogle/veo-3.1-fastAny OpenRouter image-to-video-capable model
--duration5Seconds
--aspect-ratio16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21
--resolution720pModel-dependent (e.g. 480p, 720p, 1080p)
--frame-rolefirstfirst or last — anchor frame role for the input image
--generate-audiooffGenerate audio with video (if model supports)
--poll-interval5Seconds between polls
--max-wait600Max total wait time

Flow

  1. POST /api/v1/videos with body:
    json
    {
      "model": "google/veo-3.1-fast",
      "prompt": "...motion prompt...",
      "aspect_ratio": "16:9",
      "duration": 5,
      "resolution": "720p",
      "frame_images": [
        {
          "type": "image_url",
          "frame_type": "first_frame",
          "image_url": {"url": "data:image/png;base64,..." }
        }
      ]
    }
    The --frame-role first|last flag maps to frame_type: "first_frame"|"last_frame".
  2. GET /api/v1/videos/{id} every 5s until status == "completed"
  3. GET /api/v1/videos/{id}/content → raw MP4 bytes

Notes

  • Veo 3.1 Fast is optimized for low-latency image-to-video. Typical render ≈ 60-180s for a 5s 720p clip.
  • The motion prompt should describe motion only, not the subject (the subject comes from the image).
  • For subjects with prominent faces, keep motion subtle to avoid uncanny artifacts.
  • If you also want a defined ending state, supply two images via frame_images with roles first and last. The current script wires only one anchor frame; extend body["frame_images"] to add a second.

© QinghongLin, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in skills/data2story/designer/scripts/openrouter-image2video of QinghongLin/data2story-skill.

  • SKILL.md
  • config.json
  • scripts/generate_video_from_image.py

Open the folder on GitHubat commit 63a55c1

Compare with similar skills

Openrouter Image2video next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Openrouter Image2video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openrouter Image2video this skillQinghongLin/data2story-skill155—~872Automated safety check: PassMIT
Embeddings via 9Routerdecolua/9router31k—~604Automated safety check: PassMIT
FreeRide Free Model ManagerShaivpidadi/FreeRide2382 repos~1.1kAutomated safety check: PassNone
Using Ccproxy Inspectorstarbaser/ccproxy350—~2.7kAutomated safety check: PassCustom licence
Outsourcereralexgreensh/outsourcerer171—~5.5kAutomated safety check: NotesCustom licence
Pinme LLMglitternetwork/pinme3.8k—~2.8kAutomated safety check: PassMIT

Similar skills

  • Embeddings via 9Router

    decolua/9router

    Generates vector embeddings through the 9Router /v1/embeddings endpoint, using models from providers such as OpenAI, Gemini, Mistral and Voyage for RAG and semantic search.

    31k GitHub stars~604 tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • FreeRide Free Model Manager

    Shaivpidadi/FreeRide

    Configures OpenClaw to use free OpenRouter models, setting the best one as primary and adding ranked fallbacks so rate limits do not interrupt work.

    238 GitHub starsUsed in 2 repos~1.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Using Ccproxy Inspector

    starbaser/ccproxy

    Operates the ccproxy inspector MITM system for intercepting, inspecting, and transforming LLM API traffic.

    350 GitHub stars~2.7k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Outsourcerer

    alexgreensh/outsourcerer

    Cross-harness orchestrator for AI coding work. An agent skill from alexgreensh/outsourcerer.

    171 GitHub stars~5.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes
  • Pinme LLM

    glitternetwork/pinme

    A skill your agent uses when a PinMe project (Worker TypeScript) needs to call OpenRouter-backed LLM APIs, including models, chat/completions, streaming, or OpenRouter web search.

    3.8k GitHub stars~2.8k tokensUpdated 29 days ago
    AI & LLM EngineeringAuto-check passed
  • Hyper Jev

    disler/ten-levels-of-jev

    Integrate and use Jev, TypeSafe AI's System One decision model, in production codebases.

    218 GitHub stars~1.7k tokensUpdated 13 days ago
    AI & LLM EngineeringAuto-check passed

More from QinghongLin/data2story-skill

All 31 skills in this repo
  • Inspector

    QinghongLin/data2story-skill

    Run sentence-level traceability verification on a Data2Story blog (verify.py - verifier.json), then emit the in-page Inspector panel (the reader-facing runnable verifier) + the verify/ artifacts…

    155 GitHub stars~3.1k tokensUpdated 3 mo ago
    Auto-check: notes
  • Auditor

    QinghongLin/data2story-skill

    Audit a generated Data2Story blog for build correctness across ALL modalities by ACTUALLY RENDERING it in a real headless browser (when available) — catching blank/0-width charts, broken/oversized…

    155 GitHub stars~6.4k tokensUpdated 3 mo ago
    Auto-check: notes
  • Critic

    QinghongLin/data2story-skill

    Review a finished Data2Story blog against the 5 quality rubric dimensions (visualdesign, narrativepacing, datamethodtransparency, claimdataalignment, insightvalue), score each 1-7 with on-page…

    155 GitHub stars~4.7k tokensUpdated 3 mo ago
    Auto-check: notes
  • Detective

    QinghongLin/data2story-skill

    Research external context for a dataset — domain background, history, related studies, and why this data matters.

    155 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check: notes
  • Inspector

    QinghongLin/data2story-skill

    Run sentence-level traceability verification on a blog, then generate viewer.html with interactive evidence panel.

    155 GitHub stars~697 tokensUpdated 3 mo ago
    Auto-check: notes
  • Data2story Pro

    QinghongLin/data2story-skill

    A skill your agent uses to turn a dataset into a verifiable multimedia blog (a data story / data-driven article / interactive dashboard from a dataset).

    155 GitHub stars~14k tokensUpdated 3 mo ago
    Auto-check: notes

Questions about Openrouter Image2video

What does Openrouter Image2video do?

Animate a still image into a short video via OpenRouter. An agent skill from QinghongLin/data2story-skill. Openrouter Image2video is an agent skill from QinghongLin/data2story-skill. Animate a still image into a short video via OpenRouter.

When should I use Openrouter Image2video?

Openrouter Image2video fits situations like: tasks that involve Model routing and gateways.

How do I install Openrouter Image2video in Claude Code?

Run `npx skills add QinghongLin/data2story-skill --skill openrouter-image2video -a claude-code`. Or copy the skill folder (skills/data2story/designer/scripts/openrouter-image2video in QinghongLin/data2story-skill) into .claude/skills/openrouter-image2video in your project. Claude Code loads it when a task matches its description.

How do I install Openrouter Image2video in Codex?

Run `npx skills add QinghongLin/data2story-skill --skill openrouter-image2video -a codex`. Or copy the skill folder (skills/data2story/designer/scripts/openrouter-image2video in QinghongLin/data2story-skill) into .agents/skills/openrouter-image2video in your project. Codex loads it when a task matches its description.

Can I use Openrouter Image2video in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add QinghongLin/data2story-skill --skill openrouter-image2video -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openrouter-image2video, .gemini/skills/openrouter-image2video, .github/skills/openrouter-image2video and .opencode/skills/openrouter-image2video in your project.

What does Openrouter Image2video need to run?

Going by SKILL.md and its folder, Openrouter Image2video needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named OPENROUTER_API_KEY. Our summary lists: Python 3; A credential in OPENROUTER_API_KEY.

Does Openrouter Image2video access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Openrouter Image2video safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Openrouter Image2video use?

Openrouter Image2video is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openrouter Image2video use?

About 872 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Openrouter Image2video?

Skills that share tags, products or a category with Openrouter Image2video: Embeddings via 9Router (decolua/9router, 31k stars), FreeRide Free Model Manager (Shaivpidadi/FreeRide, 238 stars), Using Ccproxy Inspector (starbaser/ccproxy, 350 stars) and Outsourcerer (alexgreensh/outsourcerer, 171 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openrouter Image2video?

QinghongLin (a GitHub user) maintains it in QinghongLin/data2story-skill, which has 155 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on July 5, 2026.

Source: QinghongLin/data2story-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.