Arlieeee
ed632cb1f9
- Move skills into skills/meshy-3d-generation/ and skills/meshy-3d-printing/ - Each skill has its own SKILL.md + reference.md (self-contained) - Root contains only README.md, LICENSE, .gitignore - Follow directory convention from CloudAI-X/threejs-skills
3.7 KiB
Meshy AI Agent
AI agent skills for the Meshy AI 3D generation platform. Enables AI coding assistants (Cursor, Claude Code) to generate 3D models, textures, images, rig characters, animate them, and prepare models for 3D printing — no MCP server required.
How It Works
These are pure Markdown skills — no server, no dependencies, no build step. Your AI assistant reads the skill files and gains the ability to interact with the Meshy API directly using shell commands and Python scripts.
Skills
meshy-3d-generation (core)
Full 3D generation lifecycle: API key setup, task creation, polling, downloading, and multi-step pipelines.
| Capability | Description | Credits |
|---|---|---|
| Text to 3D | Generate 3D models from text descriptions | 20-30 |
| Image to 3D | Convert single or multiple images to 3D | 20-30 |
| Retexture | Apply new textures to existing models | 10 |
| Remesh | Change topology, polycount, or export format | 5 |
| Auto-Rigging | Add skeleton to humanoid characters (includes walking + running) | 5 |
| Animation | Apply custom animations to rigged characters | 3 |
| Text to Image | Generate 2D images from text | 3-9 |
| Image to Image | Transform existing images | 3-9 |
meshy-3d-printing (optional)
3D printing workflow: printability checks, slicer integration (Bambu Studio), multi-color guidance.
| Capability | Description | Credits |
|---|---|---|
| Print Pipeline | Text/Image to 3D → OBJ download → Slicer | 20 |
| Printability Check | Wall thickness, overhangs, manifold mesh review | 0 |
| Slicer Integration | Open in Bambu Studio via URL scheme | 0 |
| Multi-Color Guidance | Color segmentation for AMS/MMU printers | 0-10 |
The printing skill depends on the generation skill's script template and environment setup.
Installation
Prerequisites
- A Meshy API key (get one here — requires Pro plan or above)
- Python 3 with
requestspackage (pip install requests)
Cursor
# Core (required)
mkdir -p .cursor/skills
cp skills/meshy-3d-generation/SKILL.md .cursor/skills/meshy-3d-generation.md
cp skills/meshy-3d-generation/reference.md .cursor/skills/meshy-reference.md
# 3D Printing (optional)
cp skills/meshy-3d-printing/SKILL.md .cursor/skills/meshy-3d-printing.md
Claude Code
# Core (required)
mkdir -p .claude/skills
cp skills/meshy-3d-generation/SKILL.md .claude/skills/meshy-3d-generation.md
cp skills/meshy-3d-generation/reference.md .claude/skills/meshy-reference.md
# 3D Printing (optional)
cp skills/meshy-3d-printing/SKILL.md .claude/skills/meshy-3d-printing.md
API Key
export MESHY_API_KEY="msy_YOUR_API_KEY"
Test Mode
Use the test API key to try without credits:
export MESHY_API_KEY="msy_dummy_api_key_for_test_mode_12345678"
Skill vs MCP Server
| Feature | Agent Skill (this repo) | MCP Server |
|---|---|---|
| Setup | Copy Markdown files | npx meshy-mcp-server |
| Dependencies | Python 3 + requests | Node.js >= 18 |
| How it works | AI reads instructions, makes API calls directly | Dedicated server process with structured tools |
| IDE support | Cursor, Claude Code | Any MCP-compatible client |
| File management | Via skill instructions | Built-in auto-save with project folders |
| Best for | Quick setup, no Node.js needed | Structured tool integration, Smithery registry |
Both approaches provide the same Meshy API capabilities. Choose based on your preference and setup.