Agent skill

9Router Video Generation

by decolua in decolua/9router

Submits text-to-video or image-to-video jobs to xAI Grok Imagine through 9Router, then polls the job and downloads the finished MP4.

MITAuto-check passedMedia & Creative

Install 9Router Video Generation

skills CLI
$ npx skills add decolua/9router --skill 9router-video -a claude-code

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

GitHub CLI
$ gh skill install decolua/9router 9router-video --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/decolua/9router.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/9router-video .claude/skills/9router-video && 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
9router-video
GitHub stars
31k
Token cost
~992 tokens
SKILL.md length
319 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Submits text-to-video or image-to-video jobs to xAI Grok Imagine through 9Router, then polls the job and downloads the finished MP4.

  • Generating a short video from a text prompt
  • SKILL.md covers Endpoints (async job flow), Examples, CLI one-shot and Notes & limits
  • Calls curl; needs NINEROUTER_KEY
  • Turning a still image into a video clip

What it does

This skill covers an asynchronous job flow across four endpoints: submitting a generation, editing an existing video, extending one, and polling a request ID's status. Request fields such as model, prompt, duration, aspect_ratio, resolution, and an image or video reference pass through to xAI unchanged.

It needs a 9Router URL, and a key if auth is enabled, plus a connected xAI account using either Grok Build OAuth or a direct xAI API key, which are billed separately. A bundled CLI one-shot command submits the job, polls it with progress output, and atomically renames the downloaded file on success.

When your agent uses it

  • Generating a short video from a text prompt
  • Turning a still image into a video clip
  • Editing or extending an existing generated video

Example prompts

  • “Generate a 9:16 video of a neon city at night using Grok Imagine.”
  • “Turn this product photo into a 5-second video.”
  • “Extend my generated video by another few seconds.”

Requirements

  • 9Router URL and key
  • A connected xAI account (OAuth or API key)

What it can do on your machine

Read from SKILL.md and the folder at commit ce4460e. 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

    Shell commands in SKILL.md call:

    • curl

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

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.x.ai

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

  • Credentials

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

    • NINEROUTER_KEY

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

Context cost

9Router Video Generation loads about 992 tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 319 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from decolua/9router at commit ce4460e, republished under its MIT licence (© decolua). 319 words, ~992 tokens.

Download SKILL.mdSave it as .claude/skills/9router-video/SKILL.md (or your agent's skills folder).
name
9router-video
description
Generate videos via 9Router /v1/videos/generations using xAI Grok Imagine (grok-imagine-video). Async job flow - submit, poll request_id until done, download MP4. Use when the user wants to create, generate, or render a video, text-to-video (txt2vid), or image-to-video.

9Router — Video Generation (xAI Grok Imagine)

Requires NINEROUTER_URL (and NINEROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router/SKILL.md for setup.

Requires a connected xAI account in the 9Router dashboard — either Grok Build OAuth (SuperGrok / X Premium+ subscription sign-in) or a direct xAI API key from console.x.ai. The two are separate auth types with separate billing; the dashboard shows which one each connection uses.

Endpoints (async job flow)

Video generation is asynchronous: the POST returns a request_id immediately, then you poll until the job is done or failed.

EndpointPurpose
POST /v1/videos/generationstext-to-video / image-to-video
POST /v1/videos/editsedit an existing video
POST /v1/videos/extensionsextend an existing video
GET /v1/videos/{request_id}poll job status

Request fields (passed through to xAI unchanged — see https://docs.x.ai/developers/rest-api-reference/inference/videos):

FieldRequiredNotes
modelnoxai/grok-imagine-video (prefix is stripped before upstream)
promptyes for T2Vvideo description
durationnoseconds
aspect_rationo16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3
resolutionno480p, 720p, 1080p
imageno{ "url": "https://… or data:image/…;base64,…" } for image-to-video
videoedits/extensions{ "url": "…mp4" } or { "file_id": "…" }

Examples

Submit a job:

bash
curl -X POST "$NINEROUTER_URL/v1/videos/generations" \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"xai/grok-imagine-video","prompt":"A cinematic tracking shot through a neon city at night","duration":8,"aspect_ratio":"16:9","resolution":"720p"}'
# → {"request_id":"abc123"}   (response header x-9router-connection-id: <id>)

Poll until done (echo the connection header back so the same account polls the job):

bash
curl "$NINEROUTER_URL/v1/videos/abc123" \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "x-connection-id: <id from create response>"
# → {"status":"pending","progress":42}
# → {"status":"done","video":{"url":"https://…mp4","duration":8},"model":"grok-imagine-video"}
# → {"status":"failed","error":{"code":"…","message":"…"}}

Download: fetch video.url from the done response.

CLI one-shot

bash
9router xai video \
  --prompt "A cinematic tracking shot through a neon city at night" \
  --output video.mp4
# options: --model --duration --aspect-ratio --resolution --image --timeout --port --api-key

Submits, polls with progress, downloads to video.mp4.part, atomically renames on success. Ctrl+C cancels cleanly; non-zero exit on failure.

Notes & limits

  • Jobs are account-bound upstream: poll with the same connection that created the job (x-connection-id header, value from the create response's x-9router-connection-id).
  • Creation POSTs are never auto-retried (a retry could create and bill two videos). Only a 401→token-refresh→single-retry is performed, which upstream rejects before job creation.
  • Video models are tagged kind: "video" and are excluded from chat model lists and chat fallback combos.
  • Grok Build subscription OAuth tokens are sent to the same api.x.ai/v1/videos endpoints as API keys; whether a given subscription tier includes video-generation quota is controlled by xAI and is not verified by 9Router — a 403/permission_denied from upstream means the connected account has no video access.

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

Files

Just SKILL.md in skills/9router-video of decolua/9router.

Open the folder on GitHubat commit ce4460e

Compare with similar skills

9Router Video Generation 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.

9Router Video Generation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
9Router Video Generation this skilldecolua/9router31k—~992Automated safety check: PassMIT
Videosmixs/visual-skills494—~2.5kAutomated safety check: PassCC-BY-4.0
Video-to-Sprite Animation Generator0x0funky/agent-sprite-forge4.4k—~3.8kAutomated safety check: PassMIT
AI Video Generation0xsline/OpenChatCut2.2k—~4.3kAutomated safety check: PassAGPL-3.0
Grok Mediacalesthio/OpenMontage66k—~950Automated safety check: PassAGPL-3.0
HyperFrames Video Entry Pointheygen-com/hyperframes60k3 repos~5.2kAutomated safety check: PassApache-2.0

Similar skills

  • Video

    smixs/visual-skills

    A skill your agent uses whenever the user asks to create, improve, audit, or split prompts for AI video generators (Seedance, Kling, Veo, Runway, Luma, Pika, Sora, any image-to-video system).

    494 GitHub stars~2.5k tokensUpdated 24 days ago
    Media & CreativeAuto-check passed
  • Video-to-Sprite Animation Generator

    0x0funky/agent-sprite-forge

    Turns one approved master still into a full set of animated action clips for a character, one image-to-video take per action, then packages them for a game engine.

    4.4k GitHub stars~3.8k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • AI Video Generation

    0xsline/OpenChatCut

    Submits AI video generation jobs to Fal.ai, Seedance, Kling, MiniMax Hailuo, xAI Grok Imagine or OFox for text-to-video, image-to-video, transitions and clip extension.

    2.2k GitHub stars~4.3k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Grok Media

    calesthio/OpenMontage

    xAI Grok image and video generation guide covering authentication, endpoints, prompt structure, image editing, reference-image video, and async polling.

    66k GitHub stars~950 tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    60k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Avatar Video

    calesthio/OpenMontage

    Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API.

    66k GitHub stars~1.6k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed

More from decolua/9router

All 9 skills in this repo
  • Sets up access to the 9Router AI gateway, an OpenAI-compatible REST endpoint for chat, images, speech, embeddings, web search and web fetch, and indexes its capability skills.

    31k GitHub stars~744 tokensUpdated 2 days ago
    Auto-check passed
  • Sends chat and code-generation requests through a 9Router gateway using OpenAI or Anthropic message formats, with streaming and auto-fallback combos.

    31k GitHub stars~635 tokensUpdated 2 days ago
    Auto-check passed
  • 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
    Auto-check passed
  • Generates images through a 9Router gateway's image endpoint, with model discovery, the request fields and per-provider quirks for OpenAI, Gemini, MiniMax and others.

    31k GitHub stars~830 tokensUpdated 2 days ago
    Auto-check passed
  • 9Router Speech-to-Text

    decolua/9router

    Transcribes audio files into text or subtitles through 9Router's Whisper-compatible endpoint, using models from OpenAI, Groq, Gemini, Deepgram and others.

    31k GitHub stars~914 tokensUpdated 2 days ago
    Auto-check passed
  • 9Router Text to Speech

    decolua/9router

    Turns text into spoken audio through a 9Router server, choosing among voices from OpenAI, ElevenLabs, Deepgram, Edge TTS and other providers.

    31k GitHub stars~765 tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about 9Router Video Generation

What does 9Router Video Generation do?

Submits text-to-video or image-to-video jobs to xAI Grok Imagine through 9Router, then polls the job and downloads the finished MP4. This skill covers an asynchronous job flow across four endpoints: submitting a generation, editing an existing video, extending one, and polling a request ID's status. Request fields such as model, prompt, duration, aspect_ratio, resolution, and an image or video reference pass through to xAI unchanged.

When should I use 9Router Video Generation?

9Router Video Generation fits situations like: generating a short video from a text prompt; turning a still image into a video clip; editing or extending an existing generated video.

How do I install 9Router Video Generation in Claude Code?

Run `npx skills add decolua/9router --skill 9router-video -a claude-code`. Or copy the skill folder (skills/9router-video in decolua/9router) into .claude/skills/9router-video in your project. Claude Code loads it when a task matches its description.

How do I install 9Router Video Generation in Codex?

Run `npx skills add decolua/9router --skill 9router-video -a codex`. Or copy the skill folder (skills/9router-video in decolua/9router) into .agents/skills/9router-video in your project. Codex loads it when a task matches its description.

Can I use 9Router Video Generation 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 decolua/9router --skill 9router-video -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/9router-video, .gemini/skills/9router-video, .github/skills/9router-video and .opencode/skills/9router-video in your project.

What does 9Router Video Generation need to run?

Going by SKILL.md and its folder, 9Router Video Generation needs the command-line tools its instructions call (curl) and credentials named NINEROUTER_KEY. Our summary lists: 9Router URL and key; A connected xAI account (OAuth or API key).

Does 9Router Video Generation access the network?

SKILL.md names 1 domain. As links in the text: docs.x.ai. This is read from the text; nothing was executed.

Is 9Router Video Generation 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. Review the folder before installing.

What licence does 9Router Video Generation use?

9Router Video Generation 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 9Router Video Generation use?

About 992 tokens (SKILL.md is roughly 4k 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 9Router Video Generation?

Skills that share tags, products or a category with 9Router Video Generation: Video (smixs/visual-skills, 494 stars), Video-to-Sprite Animation Generator (0x0funky/agent-sprite-forge, 4.4k stars), AI Video Generation (0xsline/OpenChatCut, 2.2k stars) and Grok Media (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains 9Router Video Generation?

decolua (a GitHub user) maintains it in decolua/9router, which has 30,536 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 8, 2026.

Source: decolua/9router on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.