Skip to main content
skill CX Codex

minecraft-imagegen — Claude Code skill: what it does, install

minecraft-imagegen is a Claude Code skill for creating and editing Minecraft raster images. It handles pack icons, banners, texture concepts, and UI mockups when the requested asset is bitmap artwork.

MIT 213 installs ★ 211 updated 2026-10-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-imagegen -a claude-code
Open on GitHub

What minecraft-imagegen does

This skill handles raster artwork for Minecraft projects, including pack.png, release graphics, store thumbnails, server banners, texture concepts, and HUD or menu mockups. It is meant for image generation or editing when the requested result is a bitmap rather than JSON, SVG, or code-native assets.

When the host provides built-in image generation or an equivalent editor, the workflow uses image_gen. It identifies the asset type, dimensions, output path, and edit constraints, then checks the result at its intended display size and applies focused corrections. The package includes prompt patterns, asset recipes, and scripts/scaffold-asset-brief.sh for saving a brief when feedback or repeated rounds call for one.

The skill cannot generate an image on a host without an available image-generation or editing tool. Texture outputs are concept references that still need manual cleanup, simplification, or tiling before they become resource-pack assets.

What it helps with

  • create a pack.png icon for a resource pack
  • prepare release or server banner artwork
  • develop a texture concept for manual cleanup
  • mock up a Minecraft HUD or menu
  • edit an existing local image

Example prompts for the agent

  • Create a square resource-pack icon and check its readability at 64x64.
  • Make Minecraft release art with clear space for a title and no tiny lettering.
  • Edit the attached image by changing the background while keeping the main subject and composition.

How to install minecraft-imagegen

1Skills CLI (Vercel)

npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-imagegen -a claude-code

2Manually: put the files in place

~/.claude/skills/minecraft-imagegen/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/minecraft-imagegen/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about minecraft-imagegen

How do I install minecraft-imagegen in Claude Code?

Run npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-imagegen -a claude-code, then check ~/.claude/skills/minecraft-imagegen/SKILL.md.

What does minecraft-imagegen do?

It creates and edits Minecraft bitmap assets, including pack icons, banners, promotional artwork, texture concepts, thumbnails, and interface mockups.

Can its generated textures go straight into a resource pack?

Texture results are intended for manual cleanup, simplification, or tiling. They serve as concepts and paint-over references rather than automatic finished replacements.

Source text

SKILL.md · MIT
---
name: minecraft-imagegen
description: "Generate or edit Minecraft raster assets such as pack icons, promo art, concept textures, thumbnails, banners, and UI mockups. Use when the deliverable is a bitmap image rather than JSON, SVG, or code-native assets."
---

# Minecraft Image Generation Skill

Use this skill when a Minecraft project needs new raster art or a visual concept
that will later be refined into a resource pack, release post, store listing, or
server brand asset.

## Scope

### Routing Boundaries
- `Use when`: the task is generating or editing a bitmap image for a Minecraft project, such as `pack.png`, release art, store thumbnails, concept textures, UI mockups, or server/banner art.
- `Do not use when`: the task is deterministic resource-pack implementation work such as `pack.mcmeta`, block/item model JSON, blockstates, fonts, sounds, or shader files (`minecraft-resource-pack`).
- `Do not use when`: the task is vector/code-native UI, an existing SVG/logo system, or non-image code/assets.
- `Do not use when`: the current host does not expose built-in image generation or an equivalent image-editing tool.

### References

- Read [prompt patterns](references/prompt-patterns.md) for an underspecified request or a generation/edit prompt template.
- Read [asset recipes](references/asset-recipes.md) for a pack icon, release banner, server header, or texture concept sheet.
- Use `scripts/scaffold-asset-brief.sh` only when a saved brief is useful for stakeholder feedback or repeated rounds; a clear image request can proceed directly.
- Invoke the helper by its absolute installed path from the project workspace. Relative `--out` values resolve from that workspace. When running from the installed skill directory, pass an absolute `--out` project path or set `CODEX_WORKSPACE_ROOT`.

---

## Default Execution

- If the current host does not expose built-in image generation or an equivalent image-editing tool, stop and tell the user this skill is unavailable on that host; offer prompt/brief preparation or a host with an available image-generation tool.
- Use the built-in `image_gen` tool by default when the host supports it.
- Match the requested deliverable: complete a requested asset, or produce concepts when the user asks for exploration. Do not require a separate concept approval for a clear generation or edit request.
- The built-in image generation workflow supports fresh generations and edits against existing local/reference images; prefer that over describing a manual paint-over process.
- Save a requested project asset at the intended workspace path when the host exposes the output file; otherwise return the generated image and state that a local save could not be verified.
- Preserve existing assets non-destructively by using versioned filenames unless the user explicitly asked to overwrite.
- If editing a local image, load or attach it first so the image is visible to the agent before requesting an edit.

---

## Good Use Cases

- `pack.png` concepts or replacements for mods, datapacks, or resource packs
- Release-banner art for GitHub, Modrinth, CurseForge, or social posts
- Texture look-dev references that will be cleaned up manually into final pixel art
- Server logos, banners, splash artwork, or rules-screen art
- HUD/menu mockups for plugin or mod UX planning
- Promo sheets that show blocks, mobs, or themed environments in-context

---

## Workflow

1. Use the request to identify the asset type, target dimensions, output path, and whether this is a generation or edit. Inspect the existing image for an edit; gather style references only when needed.
2. Generate the requested asset using the available tool. Describe the subject, composition, Minecraft style, and constraints. For an edit, state the change and what must remain unchanged.
3. Inspect the result at its intended display size. Correct observed defects with focused edits; do not require additional rounds when the result meets the request.
4. Save or return the requested result and verify any saved path. Complete pixel cleanup, tiling, and pack references when integration is in scope. Additional skills are optional.

---

## Asset-Specific Guidance

### Pack Icons

- Design for square cropping and tiny-size readability.
- Keep the silhouette bold and text minimal.
- Check readability at `64x64`; that is a useful preview size, not a required `pack.png` resolution. Use the project's target dimensions and the host's supported image-editing workflow.

### Texture Concepts

- Ask for flat, front-on presentation with even lighting and minimal perspective.
- State whether the texture should feel vanilla-faithful, noisy/gritty, hand-painted, or stylized.
- Assume manual cleanup before shipping. Generated textures are best used as concept or paint-over references, not automatic drop-ins.

### UI Mockups

- Reserve negative space for labels, slots, and status text.
- Keep text large and high-contrast.
- Call out whether the mockup should feel vanilla, modded-tech, fantasy, or admin-panel inspired.

### Promo Art and Thumbnails

- Leave copy-safe negative space for release titles or taglines.
- Avoid tiny text and clutter that will collapse on mobile or store cards.
- Specify whether the output should show gameplay-like framing, hero artwork, or a clean showcase layout.

---

## Review Checklist

- The image reads clearly at the actual target size.
- Any text is spelled correctly and positioned as requested.
- No extra logos, watermarks, or unrelated objects were introduced.
- The style matches the requested Minecraft context.
- For texture concepts, the result looks easy to paint over, simplify, or tile manually.

---

© Jahrome907 · MIT · Jahrome907/minecraft-agent-skills

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set13

The whole set →
minecraft-server-admin minecraft-server-admin runs the infrastructure side of Minecraft Java servers: Paper, Purpur, Folia, Velocity, Fabric, NeoForge. Useful when TPS drops or a proxy blocks logins. CX Codex +1 279installs minecraft-world-generation minecraft-world-generation is a Claude Code skill for building and debugging Minecraft world generation in datapacks, NeoForge, or Fabric. It activates for biome, dimension, structure, and worldgen registration tasks. CX Codex +1 269installs minecraft-plugin-dev minecraft-plugin-dev helps build, change, and debug Minecraft server plugins for Paper and Bukkit-derived servers. Useful for JavaPlugin APIs, events, commands, and configuration. CX Codex +1 267installs minecraft-multiloader minecraft-multiloader is a Claude Code skill that builds and maintains Architectury Minecraft mods for 26.x and 1.21.x across NeoForge and Fabric. It runs when both loaders need release artifacts. CX Codex +1 247installs minecraft-commands-scripting minecraft-commands-scripting writes and debugs Minecraft Java 26.x and 1.21.x commands, execute chains, scoreboards, and RCON scripts. Targets command logic directly without generating full datapack folder structures. CX Codex +1 241installs minecraft-ci-release minecraft-ci-release sets up CI and release plumbing for Minecraft mods and Paper plugins: workflow files, artifacts, versions, tags, GitHub Releases. CX Codex +1 238installs minecraft-worldedit-ops minecraft-worldedit-ops is a Claude Code skill for safe WorldEdit command sequences in Minecraft 26.x and 1.21.x. It covers selections, masks, schematics, brushes, terrain shaping and rollback. CX Codex +1 201installs minecraft-essentials-ops minecraft-essentials-ops guides administration of EssentialsX on Paper and Spigot Minecraft servers across version families 26.x and 1.21.x. CX Codex +1 185installs

Project sponsors

Companies that keep this analytics open