Agent skill

Grok Media

by calesthio in calesthio/OpenMontage

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

AGPL-3.0Auto-check passedMedia & Creative

Install Grok Media

skills CLI
$ npx skills add calesthio/OpenMontage --skill grok-media -a claude-code

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

GitHub CLI
$ gh skill install calesthio/OpenMontage grok-media --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/calesthio/OpenMontage.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/grok-media .claude/skills/grok-media && 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
grok-media
GitHub stars
66k
Token cost
~950 tokens
SKILL.md length
414 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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

  • Tasks that involve AI video generation
  • SKILL.md covers Models, Authentication, Image API and Video API, plus 5 more sections
  • Reaches api.x.ai; needs XAI_API_KEY
  • Tasks that involve Image editing

What it does

Grok Media is an agent skill from calesthio/OpenMontage. xAI Grok image and video generation guide covering authentication, endpoints, prompt structure, image editing, reference-image video, and async polling.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering AI video generation and Image editing. It works with xAI Grok. The repository describes itself as: World's first open-source, agentic video production system. 12 production pipelines, 100+ tools, 700+ agent skill and production-knowledge files. Turn your AI coding assistant… The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve AI video generation
  • Tasks that involve Image editing

Example prompts

  • “/grok-media”

Requirements

  • A credential in XAI_API_KEY

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.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:

    • XAI_API_KEY

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

Context cost

Grok Media loads about 950 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 414 words of instructions outside code blocks.

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

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 calesthio/OpenMontage at commit 9327439, republished under its AGPL-3.0 licence (© calesthio). 414 words, ~950 tokens.

Download SKILL.mdSave it as .claude/skills/grok-media/SKILL.md (or your agent's skills folder).
name
grok-media
description
xAI Grok image and video generation guide covering authentication, endpoints, prompt structure, image editing, reference-image video, and async polling.
metadata.author
OpenMontage
metadata.version
1.0.0
metadata.tags
xai, grok, image-generation, video-generation, media

Grok Media

Use this skill when working with xAI media models in OpenMontage.

Models

  • grok-imagine-image for image generation and image editing
  • grok-imagine-video for text-to-video, image-to-video, and reference-image video

Authentication

  • Env var: XAI_API_KEY
  • Base URL: https://api.x.ai/v1
  • Header: Authorization: Bearer $XAI_API_KEY

Image API

Text-to-image
  • Endpoint: POST /images/generations
  • Core fields:
    • model
    • prompt
    • n
    • aspect_ratio
    • resolution
Image edit
  • Endpoint: POST /images/edits
  • Use image for one source image
  • Use images for multi-image compositing
  • Each source image can be:
    • a public HTTPS URL
    • a base64 data URI
Image prompting
  • Grok responds well to direct natural language
  • For edits, describe only the intended change and preserve everything else implicitly
  • For multi-image merges, explicitly name how each source contributes
  • Prefer one strong scene description over long style-stacking

Video API

Generation
  • Endpoint: POST /videos/generations
  • Polling endpoint: GET /videos/{request_id}
  • Success state: status == "done"
  • Failure states to handle explicitly: failed, expired
Modes
  • Text-to-video:
    • prompt-only generation
  • Image-to-video:
    • use image: {"url": ...}
    • this anchors the starting frame
  • Reference-to-video:
    • use reference_images: [{"url": ...}, ...]
    • this influences who/what appears in the video without locking the first frame
    • prompts can reference inputs with placeholders like <IMAGE_1>, <IMAGE_2>
Video constraints
  • Grok video is best treated as short-form generation
  • Current output resolutions are 480p and 720p
  • Reference-image video supports multiple images and is useful for product placement, wardrobe transfer, and identity consistency
  • Download outputs promptly; provider URLs may be temporary

Pricing

  • grok-imagine-image: $0.02 per generated image
  • grok-imagine-image edits/composites: add $0.002 per input image
  • grok-imagine-video:
    • 480p: $0.05 per second
    • 720p: $0.07 per second
  • grok-imagine-video image-conditioned requests: add $0.002 per input image
Show full SKILL.md (165 more words)Show less

Grok-Specific Prompt Guidance

Images
  • Start with subject, action, setting
  • Add one style anchor, not five
  • For edits:
    • describe the desired modification
    • keep the rest of the image stable by omission, not by writing a giant preservation list
Video
  • Keep prompts scene-local: one shot, one main motion idea, one emotional beat
  • For reference-conditioned video, explicitly map source images to roles:
    • person from <IMAGE_1>
    • jacket from <IMAGE_2>
    • product from <IMAGE_3>
  • Camera and pacing language helps:
    • slow push-in
    • handheld follow
    • locked-off medium shot
    • high-energy whip pan transition

Good Fits

  • Image style transfer
  • Image compositing from multiple sources
  • Reference-conditioned short video
  • Product-led motion clips
  • Character-consistent scenes without hard first-frame lock

Weak Fits

  • Long-form clip generation
  • Heavy reliance on deterministic seeds
  • Overloaded prompts with multiple scene changes

Failure Handling

  • If generation submission succeeds but polling expires, surface it as a provider/runtime issue
  • If a request fails, preserve the endpoint, mode, and prompt summary in the error
  • Do not silently substitute a different provider after xAI was selected without user approval

© calesthio, AGPL-3.0. 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 .agents/skills/grok-media of calesthio/OpenMontage.

Open the folder on GitHubat commit 9327439

Compare with similar skills

Grok Media 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.

Grok Media compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Grok Media this skillcalesthio/OpenMontage66k—~950Automated safety check: PassAGPL-3.0
Agnes AI GenerationYacey/agnes-ai-generation-skill419—~1.7kAutomated safety check: PassMIT
Video-to-Sprite Animation Generator0x0funky/agent-sprite-forge4.4k—~3.8kAutomated safety check: PassMIT
Gc Still Image Motion DirectorLiamGvchi/gc-still-image-motion-director152—~1.4kAutomated safety check: PassMIT
Media Genclacky-ai/openclacky1.2k—~7.5kAutomated safety check: PassMIT
Mdbox Mediahi5jeff/deepclonewebsite94—~993Automated safety check: NotesCustom licence

Similar skills

  • Agnes AI Generation

    Yacey/agnes-ai-generation-skill

    Call Agnes AI / Sapiens AI generation APIs for text, image, and video.

    419 GitHub stars~1.7k tokensUpdated 3 mo 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 4 days ago
    Media & CreativeAuto-check passed
  • Gc Still Image Motion Director

    LiamGvchi/gc-still-image-motion-director

    Analyze still images and design restrained, image-specific motion for image-to-video generation.

    152 GitHub stars~1.4k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Media Gen

    clacky-ai/openclacky

    Generate or edit images, videos, or audio in the current task.

    1.2k GitHub stars~7.5k tokensUpdated today
    Media & CreativeAuto-check passed
  • Mdbox Media

    hi5jeff/deepclonewebsite

    Generate and process media — images, video, audio, music — and read text from images (OCR).

    94 GitHub stars~993 tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Character Design with genmedia

    fal-ai-community/skills

    Builds consistent characters, reference and expression sheets, outfit variations and character-to-video shots with the genmedia CLI while keeping identity stable.

    251 GitHub stars~1.3k tokensUpdated 12 days ago
    Media & CreativeAuto-check passed

More from calesthio/OpenMontage

All 41 skills in this repo
  • Video Understand

    calesthio/OpenMontage

    Understand video content locally using ffmpeg frame extraction and Whisper transcription.

    66k GitHub stars~841 tokensUpdated 7 days ago
    Auto-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 7 days ago
    Auto-check passed
  • D3 Viz

    calesthio/OpenMontage

    Creating interactive data visualisations using d3.js. An agent skill from calesthio/OpenMontage.

    66k GitHub starsUsed in 3 repos~5.4k tokens
    Auto-check passed
  • Create Video

    calesthio/OpenMontage

    Create videos from a text prompt using HeyGen's Video Agent.

    66k GitHub stars~1.3k tokensUpdated 7 days ago
    Auto-check passed
  • Threejs World Generation

    calesthio/OpenMontage

    Build deterministic, editable, free-viewpoint Three.js worlds from text or structured briefs.

    66k GitHub stars~2k tokensUpdated 7 days ago
    Auto-check passed
  • Video Edit

    calesthio/OpenMontage

    Edit videos locally using ffmpeg. An agent skill from calesthio/OpenMontage.

    66k GitHub stars~855 tokensUpdated 7 days ago
    Auto-check: notes

Works with

Questions about Grok Media

What does Grok Media do?

xAI Grok image and video generation guide covering authentication, endpoints, prompt structure, image editing, reference-image video, and async polling. Grok Media is an agent skill from calesthio/OpenMontage. xAI Grok image and video generation guide covering authentication, endpoints, prompt structure, image editing, reference-image video, and async polling.

When should I use Grok Media?

Grok Media fits situations like: tasks that involve AI video generation; tasks that involve Image editing.

How do I install Grok Media in Claude Code?

Run `npx skills add calesthio/OpenMontage --skill grok-media -a claude-code`. Or copy the skill folder (.agents/skills/grok-media in calesthio/OpenMontage) into .claude/skills/grok-media in your project. Claude Code loads it when a task matches its description.

How do I install Grok Media in Codex?

Run `npx skills add calesthio/OpenMontage --skill grok-media -a codex`. Or copy the skill folder (.agents/skills/grok-media in calesthio/OpenMontage) into .agents/skills/grok-media in your project. Codex loads it when a task matches its description.

Can I use Grok Media 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 calesthio/OpenMontage --skill grok-media -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/grok-media, .gemini/skills/grok-media, .github/skills/grok-media and .opencode/skills/grok-media in your project.

What does Grok Media need to run?

Going by SKILL.md and its folder, Grok Media needs credentials named XAI_API_KEY. Our summary lists: A credential in XAI_API_KEY.

Does Grok Media access the network?

SKILL.md names 1 domain. In commands or code: api.x.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Grok Media 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 Grok Media use?

Grok Media is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Grok Media use?

About 950 tokens (SKILL.md is roughly 3.8k 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 Grok Media?

Skills that share tags, products or a category with Grok Media: Agnes AI Generation (Yacey/agnes-ai-generation-skill, 419 stars), Video-to-Sprite Animation Generator (0x0funky/agent-sprite-forge, 4.4k stars), Gc Still Image Motion Director (LiamGvchi/gc-still-image-motion-director, 152 stars) and Media Gen (clacky-ai/openclacky, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Grok Media?

calesthio (a GitHub user) maintains it in calesthio/OpenMontage, which has 65,930 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 3, 2026.

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