Skip to main content
skill CX Codex

muapi-action-figure-generator — Claude Code skill: how to install

Converts a portrait photo into a stylized 3D collectible toy inside branded blister packaging. Useful when generating custom avatars or mock merchandising concepts.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-action-figure-generator -a claude-code
npx skills add SamurAIGPT/Generative-Media-Skills --skill action-figure-generator -a claude-code
Open on GitHub

What muapi-action-figure-generator does

The skill accepts a portrait photo via user_image and an optional toy_theme value. If left blank, the prompt defaults to superhero. You can also pick explorer, doctor, or sci-fi options.

Under the hood, the executing agent invokes muapi image edit targeting the nano-banana-2-edit model. The generated prompt instructs the model to preserve facial likeness, hair, and skin tone while rendering the character as a plastic toy with joints inside cardboard packaging. Output renders come in 1:1 or 4:5 aspect ratios. If an alias is missing, the agent posts directly to https://api.muapi.ai/api/v1/<endpoint> via curl and polls using muapi predict wait.

Missing a MUAPI_API_KEY environment variable halts the workflow immediately. You must authenticate first using muapi auth configure.

What it helps with

  • convert a portrait into a 3D toy action figure
  • create collectible blister packaging with custom typography
  • adapt character styling to sci-fi, doctor, or superhero themes
  • render plastic toy joints with realistic lighting

Example prompts for the agent

  • Make a collectible superhero action figure based on the photo in input.jpg
  • Generate a toy figure in blister packaging using portrait.png with a sci-fi explorer theme

How to install muapi-action-figure-generator

1Skills CLI (Vercel)

npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-action-figure-generator -a claude-code
npx skills add SamurAIGPT/Generative-Media-Skills --skill action-figure-generator -a claude-code

2Manually: put the files in place

~/.claude/skills/action-figure-generator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/action-figure-generator/

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

Questions about muapi-action-figure-generator

How to install muapi-action-figure-generator in Claude Code?

Run npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-action-figure-generator -a claude-code. You can also place the specification directly into ~/.claude/skills/action-figure-generator/SKILL.md.

What does muapi-action-figure-generator do?

It sends a source photo to the nano-banana-2-edit model through the muapi CLI while retaining facial likeness and hairstyle. The output is a stylized plastic figure inside blister packaging with a 1:1 or 4:5 aspect ratio.

What prerequisites are needed to run this skill?

You need the muapi CLI tool and an active MUAPI_API_KEY. If the environment variable is unset, configure credentials first with muapi auth configure.

Source text

SKILL.md · MIT
---
slug: muapi-action-figure-generator
name: muapi-action-figure-generator
version: "1.0.0"
description: Convert a photo of a person into a custom 3D action figure, complete with collectible toy packaging.
acceptLicenseTerms: true
---


# Action Figure Generator

**Convert a photo of a person into a custom 3D action figure, complete with collectible toy packaging.**

## Inputs

| Name | Type | Required | Default | Description |
|:---|:---|:---|:---|:---|
| `user_image` | image_url | yes | — | A clear photo of the person to be turned into an action figure. |
| `toy_theme` | text | no | superhero | The theme of the action figure (e.g. superhero, doctor, explorer, sci-fi). |


## Steps

### Phase A — Action Figure Creation

If `{{user_image}}` is not provided, ask the user to upload their photo.

Once the photo is available, submit the plan with ONE step to generate the action figure:

1. **Action Figure Generation** — `muapi image edit` (model=`nano-banana-2-edit`):
   - Reference Image: `{{user_image}}`
   - Prompt: `A high-quality 3D stylized action figure based on the person in the input image. The action figure should maintain the person's likeness (face, hairstyle, skin tone) but be rendered as a plastic toy with visible joints and a semi-glossy finish. The character is dressed in a {{toy_theme}} outfit. The figure is displayed inside its original collectible cardboard and plastic blister packaging. The packaging has the person's name printed on it and features clean, modern graphic design. Soft studio lighting, realistic plastic textures, 8k resolution, cinematic look.`
   - Aspect ratio: 1:1 or 4:5

Present the generated action figure to the user. You can also suggest creating different themes (e.g., changing the character from a doctor to a space explorer).

## Trigger Keywords

`action figure`, `custom toy`, `toy packaging`, `character toy`, `collectible figure`


---

## Notes for the Executing Agent

- This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call `muapi` CLI commands. Use `muapi auth configure` first if `MUAPI_API_KEY` is unset.
- For model IDs without a CLI alias yet, fall back to the raw endpoint via `curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}'` and poll with `muapi predict wait <request_id>`.
- Substitute `{{input_name}}` placeholders with the user's actual inputs before issuing each call.

© SamurAIGPT · MIT · SamurAIGPT/Generative-Media-Skills

Similar skills

All skills for AI and ML →

From the same set59

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor