meshy-dev/meshy-3d-agent / skills/meshy-3d-generation
meshy-3d-generation
VerifiedGenerates and edits digital 3D assets with the Meshy CLI: text-to-3D and image-to-3D models, texturing, remeshing and LODs, UV unwrapping, format conversion (GLB, FBX, OBJ, USDZ, STL, 3MF, Blender), rigging, animation, motion clips from text and reference images. Use when the user asks to make, texture, rig, animate or convert a 3D model or game asset. For physical 3D printing use meshy-3d-printing.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.7 KB |
| references/animation.md | markdown | 4.3 KB |
| references/delivery.md | markdown | 9.2 KB |
| references/pipelines.md | markdown | 20.6 KB |
| references/setup.md | markdown | 13.9 KB |
| references/troubleshooting.md | markdown | 9.6 KB |
| references/visual-hosts.md | markdown | 1.7 KB |
references/animation.md
View on GitHub# Rigging and animation
For a character that has to move. Placeholders, the create/wait lifecycle and `-o` delivery are as
in [pipelines](pipelines.md); cost, previews and hand-over are in [delivery](delivery.md).
## Rigging
Rig a **textured humanoid** with clear limbs, preferably in an A/T pose, at most 300,000 faces
(the API refuses more than 320,000).
Use the refined, retextured or textured image task, not an untextured preview. Verify geometry
and texture suitability from the task and its preview; a face check alone cannot establish them.
```bash
meshy download --resource RESOURCE --task-id TEXTURED_ID --model-format glb --output "JOB_DIR/textured-TEXTURED_ID.glb" --workspace "WORKSPACE" --format json --no-update-check
meshy inspect faces --model "JOB_DIR/textured-TEXTURED_ID.glb" --max-faces 300000 --format json --no-update-check
meshy rigging create --input-task-id TEXTURED_ID --height-meters 1.7 --async --format json --no-update-check
```
Apply the same pass/fail/unknown rule as for UV unwrap in [pipelines](pipelines.md). Wait through `rigging` using the newly accepted ID.
For external input the rigging CLI accepts a textured GLB via `--model-url`, with the character
facing +Z (glTF forward); it still needs the same suitability and face evidence.
Choose the motion source in this order; stop at the first that gives the requested action:
1. **Walking or running.** The rig task usually carries both clips (confirm with `download --list`).
Download them; no new task.
2. **Any other action: the preset animation library.** Look the action up, then apply it to the
rig. Several actions for one character (idle, walk and attack for a game's state machine) go
into one task with `--action-ids` (1–10 unique IDs): one file with one clip per action, in
the order given, charged per action.
3. **An action the library does not have: text-to-motion.** Generate the clip with the recipe
below, wait for it, then apply it with `--motion-task-id`. Biped rigs only, and
apply it within 3 days of the motion task.
Select the rig or bundled clips individually, each to its own `OUTPUT_FILE`:
```bash
meshy download --resource rigging --task-id RIG_ID --asset result.rigged_character_glb_url --output "OUTPUT_FILE" --workspace "WORKSPACE" --format json --no-update-check
meshy download --resource rigging --task-id RIG_ID --asset result.basic_animations.walking_glb_url --output "OUTPUT_FILE" --workspace "WORKSPACE" --format json --no-update-check
```
For running, use `result.basic_animations.running_glb_url`; list the assets for FBX and armature
variants. Take library IDs from the library, never from memory: IDs have gaps and retired actions
disappear. The lookup is free but needs the same sign-in as any other command. `--search` matches the name or key;
`--category` narrows to `WalkAndRun`, `BodyMovements`, `DailyActions`, `Fighting` or `Dancing`,
and `--sub-category` narrows further. Each item carries a `preview_url` GIF to show the user
when the choice is not obvious.
```bash
meshy animation-catalog list --search wave --format json --no-update-check
meshy animate create --rig-task-id RIG_ID --action-id ACTION_ID --async --format json --no-update-check
meshy animate create --rig-task-id RIG_ID --action-ids ACTION_IDS --async --format json --no-update-check
meshy animate create --rig-task-id RIG_ID --motion-task-id MOTION_ID --async --format json --no-update-check
```
These are alternatives: one action, several actions in one file, or a generated motion. Wait
through `animate`, then download `--asset result.animation_glb_url` (or
`result.animation_fbx_url`). A generated motion may come back GLB-only, with an empty FBX URL.
Post-processing (FPS, USDZ, armature) is `--post-process-operation`; include it only when
requested. On a generated motion it needs that FBX: when the retarget yields none, the task
fails and its credits are refunded.
## Generated motion
```bash
meshy text-to-motion create --prompt "MOTION_DESCRIPTION" --mode prime --duration 3 --async --format json --no-update-check
```
Text-to-motion makes a standalone skeleton clip from a prompt of up to 400 characters: prime
returns FBX, swift BVH; duration is 2–10 seconds in 0.5-second steps. Delivered as is, it is a
raw clip for the user's own DCC tool; to put it on a rigged character, apply it with
`animate --motion-task-id` (above). Download it with `--kind motion`, using `--output-dir`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |