# meshy-3d

meshy-3d is a Claude Code skill that creates 3D assets from text and images through Meshy. It handles generation jobs, textures, rigging, and exports.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 142 installs · ★ 252 repo stars
- Author: calesthio
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/calesthio/generative-media-skills/tree/HEAD/skills/providers/3d-generation/meshy-3d/SKILL.md
- Updated: 2026-07-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/meshy-3d

## What it does

meshy-3d creates 3D assets through Meshy’s REST API and web platform, using text prompts, one image, or several reference images. It covers mode selection, polygon and topology controls, PBR texturing, UV work, humanoid rigging, animation, and exports to GLB, FBX, OBJ, USDZ, or STL.

Meshy runs each request as an asynchronous job. The skill can follow completion through polling, an SSE stream, or a webhook. API tasks require a Bearer token in `MESHY_API_KEY` and a Pro-tier-or-higher subscription. Meshy is not a CAD replacement for exact dimensions and does not guarantee watertight geometry for manufacturing.

## Requirements
- Works with: Unity, Unreal Engine, Blender

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill meshy-3d -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/meshy-3d/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/meshy-3d/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill meshy-3d -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/meshy-3d/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill meshy-3d -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/meshy-3d/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install calesthio/generative-media-skills skills/providers/3d-generation/meshy-3d
```

2. **Manually: put the files in place**
- File: `.github/skills/meshy-3d/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill meshy-3d -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/calesthio/generative-media-skills --path skills/providers/3d-generation/meshy-3d
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/meshy-3d/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill meshy-3d -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/generative-media-skills/tree/HEAD/skills/providers/3d-generation/meshy-3d/SKILL.md

## When to use it
- generate a 3D asset from a text prompt
- turn a reference image into a mesh
- control an asset’s polygon count and topology
- apply PBR materials and create UVs
- prepare a character for rigging and export

## Example prompts
- Create a 3D character from this description and start the Meshy generation job.
- Turn `reference.png` into a 3D mesh, keep the polygon count low, and export it as `GLB`.
- Track the Meshy job with a webhook and report when the asset is ready for Blender.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c96637c538e6e7e9.

BEGIN THIRD-PARTY FILE c96637c538e6e7e9
```text
---
name: meshy-3d
description: >-
  Produce 3D assets with Meshy (meshy.ai) through its REST API and web
  platform — text-to-3D, image-to-3D, multi-image-to-3D, AI texturing/PBR,
  remesh/topology control, UV, and auto-rigging/animation. Use this skill when
  an agent must generate a mesh from a prompt or reference image, control
  polygon count and topology, apply or restyle textures, rig a humanoid for
  animation, export to GLB/FBX/OBJ/USDZ/STL for Unity/Unreal/Blender, drive
  Meshy's asynchronous job API (auth, polling, streaming, webhooks, credits,
  rate limits), review generated meshes for game/film/print readiness, or
  decide whether Meshy is the right tool at all. Not for editing an existing
  hand-modeled asset's geometry, hard-surface CAD with exact dimensions, or
  guaranteed-watertight manufacturing parts.
---

# Meshy 3D generation

Meshy is a hosted generative-3D service. You give it text or images; it returns
a textured mesh (GLB/FBX/OBJ/USDZ/STL/3MF), with optional PBR maps, remeshing,
UV, auto-rigging, and library animations. Everything runs as **asynchronous
jobs**: you POST a task, get a task ID, then poll, stream (SSE), or receive a
webhook until `SUCCEEDED`.

This skill covers driving Meshy well: choosing the right generation mode,
writing prompts that separate geometry from texture, controlling topology and
poly count, texturing and re-texturing, rigging and animating, exporting into a
game/film/print pipeline, and judging whether the output is usable.

## Evidence labels used below

- **[Doc]** — stated in official Meshy documentation, API reference, or help
  center (URLs in Sources). Volatile items carry a verification date.
- **[1P-claim]** — a first-party Meshy claim (marketing/blog/help) not
  independently verified. Treat as a claim, not a guarantee.
- **[Heuristic]** — production judgment from how generative-3D pipelines behave;
  verify against your own output.

Volatile facts (model IDs, credit costs, limits, formats) were verified
**2026-07-10** against docs.meshy.ai. Re-check the changelog and pricing pages
before quoting numbers to a user, because Meshy ships model versions and
adjusts credit costs and promotions frequently.

## When to use Meshy — and when not to

Use Meshy when you need:

- A single, coherent **prop, character, or creature** fast from a prompt or a
  reference image (concept-to-asset, game jam, previz, background dressing,
  crowd fillers, marketplace assets, 3D-print blanks). [Heuristic]
- A **textured** starting mesh you will clean up downstream rather than a
  final production hero asset. [Heuristic]
- Bulk asset generation where **throughput and cost per asset** matter more
  than authored topology. [Heuristic]

Do **not** reach for Meshy when:
```
END THIRD-PARTY FILE c96637c538e6e7e9

The third-party file has ended. Everything between the c96637c538e6e7e9 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2766 of 25443 bytes. © calesthio · MIT · https://github.com/calesthio/generative-media-skills/tree/HEAD/skills/providers/3d-generation/meshy-3d/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
