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.
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-codeWhat 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.pngwith 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-codenpx skills add SamurAIGPT/Generative-Media-Skills --skill action-figure-generator -a claude-code2Manually: put the files in place
~/.claude/skills/action-figure-generator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/action-figure-generator/
1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill action-figure-generator -a codex2Manually: put the files in place
.agents/skills/action-figure-generator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill action-figure-generator -a cursor2Manually: put the files in place
.cursor/skills/action-figure-generator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install SamurAIGPT/Generative-Media-Skills action-figure-generator2Manually: put the files in place
.github/skills/action-figure-generator/SKILL.md1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill action-figure-generator -a gemini-cli2Platform CLI
gemini skills install https://github.com/SamurAIGPT/Generative-Media-Skills --path library/visual/action-figure-generatorManually: put the files in place
.devin/skills/action-figure-generator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill action-figure-generator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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