Skip to content
SkillScript-led2,272 tokens in use

generate2dmedia

The art-route layer of the Forge skills: one command that generates an image or image-to-video clip through a configured API or a local Codex or Grok CLI, with a spend ledger.

5,887 stars on the repository MIT License0x0funky/agent-sprite-forge · skills/generate2dmedia
claude plugin marketplace add 0x0funky/agent-sprite-forge --sparse .claude-plugin skills && claude plugin install agent-sprite-forge@agent-sprite-forge
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing generate2dmedia costs

213tokens idle
2,272tokens in use
49,545tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/cli_media.py, scripts/forge_doctor.py, scripts/forge_index.py, scripts/generate_media.py, scripts/media_config.py, scripts/media_ledger.py, scripts/media_mp4.py, scripts/media_providers.py, scripts/route_media.py.

Touches

shelldetectednetworkdetectedwrites filesdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter12/15
  • Structure19/25
  • Examples0/15
  • Output15/15
  • Size13/15
  • Resources10/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Good
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    scripts/cli_media.py, line 341
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/cli_media.py, line 394
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    scripts/cli_media.py, line 533

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity96
  • Maintenance84
  • Community44
  • Maturity28
  • Momentum40

Generate2DMedia is the layer the other Forge sprite and map skills call when they need raw media. Its route_media.py command picks the first working route: a provider API whose key you configured (OpenAI, Google Gemini, xAI, BytePlus ModelArk, fal.ai), then your own image tool, then a signed-in Codex or Grok command line tool. It prints one JSON line with the route, the file, a checksum and a cost estimate.

It also runs the capability check, helps configure API keys, keeps a spend ledger, resumes interrupted jobs and adopts images made in a Codex session.

What You Get

  • A single command for still images, reference edits and image-to-video clips
  • A capability report showing which keys are configured (yes or no) and which local tools are ready
  • A ledger file listing every call with its cost estimate, plus optional budget and call limits
  • Dry-run mode that shows the plan and estimate without sending anything

Common Use Cases

  • Generate a master still for a game character from a prompt file and reference images
  • Animate an approved still with an image-to-video model
  • Check which generation routes work on this machine before starting a project
  • Review spend after a long generation session

What Makes It Unique

Routing is explicit and ordered: configured APIs first, local CLIs next, code art last. It supports several image and video providers behind one interface, records cost in a ledger, snaps video lengths to what each model renders and reports the route that ran. Keys are read only from the environment or a user config file, never from a project.

Under The Hood

The agent runs Python scripts from the skill folder through the shell. They send your prompt file and reference images over the network to the provider you configured, or call your local Codex or Grok command line tool, and save the returned image or video into a new output folder. Keys come from environment variables or a config file in your home config folder, and the skill says never to print or commit them. Paid calls are written to a ledger file in the project. Read the scripts before running them on a sensitive machine; the automated scan findings are shown on the page.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers