Agent skill
Generating Item Images
Generate AI-powered item images for Mystica game using Gemini with R2-hosted reference images. Use when creating item assets, generating game art, or when user mentions "item image", "generate image", "Mystica items", or "game assets".
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/generating-item-images
SKILL.md
Generating Item Images
Generate consistent AI-powered item images for Mystica using Gemini with style reference images.
Quick Start
npx tsx scripts/generate-image.ts \
--type "ITEM_TYPE" \
--materials "material1,material2" \
--provider gemini \
-r "https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_0821.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_2791.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_4317.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_5508.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_9455.png"
Required Parameters
| Parameter | Source | Example |
|---|---|---|
--type |
docs/seed-data-items.json |
"Gatling Gun", "Umbrella" |
--materials |
docs/seed-data-materials.json |
"cocaine,lava,plasma" (1-3 materials) |
--provider |
Always gemini |
gemini |
-r |
Always all 5 URLs below | See Quick Start |
Optional Parameters
| Parameter | Default | Purpose |
|---|---|---|
--aspect-ratio |
Auto | "2:3" for portrait items |
--format |
png |
jpg for smaller files |
-o |
scripts/output/gemini-{timestamp}.png |
Custom output path |
Examples
Epic-tier weapon:
npx tsx scripts/generate-image.ts \
--type "Gatling Gun" \
--materials "cocaine,lava,plasma" \
--provider gemini \
-r "https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_0821.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_2791.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_4317.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_5508.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_9455.png"
Output: scripts/output/gemini-{timestamp}.png → "Molten Vaporizer"
Uncommon utility item:
npx tsx scripts/generate-image.ts \
--type "Umbrella" \
--materials "bubble,slime" \
--provider gemini \
-r "https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_0821.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_2791.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_4317.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_5508.png,https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_9455.png"
Output: scripts/output/gemini-{timestamp}.png → "Slimebub Umbrella"
Material Reference
Common: coffee, gum, feather, button, candle, pizza Uncommon: matcha_powder, bubble, slime, propeller, magnet Rare: rainbow, lava, ghost, shadow, goo, cocaine, lube, void Epic: diamond, lightning, laser_beam, stardust, plasma
Complete list with stat modifiers: docs/seed-data-materials.json
Prerequisites
# Required in .env
REPLICATE_API_TOKEN=your_token
OPENAI_API_KEY=your_key
R2 bucket mystica-assets already configured at https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/
R2 Management
Quick Upload:
cd docs/image-refs
# Upload all images to R2 (remote)
for file in IMG_*.png; do
wrangler r2 object put "mystica-assets/image-refs/$file" --file="$file" --remote
done
# Verify uploads
curl -I "https://pub-1f07f440a8204e199f8ad01009c67cf5.r2.dev/image-refs/IMG_0821.png"
Complete R2 Guide: See the Wrangler R2 Guide skill - Comprehensive Wrangler CLI reference with all bucket operations, CORS config, troubleshooting, and cost info.
Advanced Reference
- R2 CLI Guide: Wrangler R2 Guide skill (complete Wrangler reference)
- R2 Setup Details:
docs/external/r2-image-hosting.md(integration guide) - Workflow Details:
docs/ai-image-generation-workflow.md - Script Source:
scripts/generate-image.ts - Description Generator:
scripts/generate-item-description.ts
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?