Description

Use the Meshy.ai REST API to generate assets: (1) text-to-2d (Meshy Text to Image) and (2) image-to-3d, then download outputs locally. Use when the user wants Meshy generations, needs polling async tasks, and especially when they want the resulting OBJ saved to disk. Requires MESHY_API_KEY in the environment.

README (SKILL.md)

Meshy.ai

Name: Meshy AI
Author: sabatesduran

Generate Meshy assets via API and save outputs locally.

Setup

Add env var: MESHY_API_KEY=msy-...
Optional: MESHY_BASE_URL (defaults to https://api.meshy.ai)

Text → 2D (Text to Image)

Use scripts/text_to_image.py.

python3 skills/public/meshy-ai/scripts/text_to_image.py \
  --prompt "a cute robot mascot, flat vector style" \
  --out-dir ./meshy-out

Downloads one or more images (if multi-view) into ./meshy-out/text-to-image_\x3CtaskId>_\x3Cslug>/.

Image → 3D (always save OBJ)

Use scripts/image_to_3d_obj.py.

Local image

python3 skills/public/meshy-ai/scripts/image_to_3d_obj.py \
  --image ./input.png \
  --out-dir ./meshy-out

Public URL

python3 skills/public/meshy-ai/scripts/image_to_3d_obj.py \
  --image-url "https://.../input.png" \
  --out-dir ./meshy-out

Always downloads model.obj (and model.mtl if provided by Meshy) into ./meshy-out/image-to-3d_\x3CtaskId>_\x3Cslug>/.

Notes

Meshy tasks are async: create → poll until status=SUCCEEDED → download URLs.
API reference for this skill: references/api-notes.md.

Usage Guidance

This skill appears to do exactly what it claims: it needs your Meshy API key, creates async jobs, polls for completion, and downloads images/OBJ files. Before installing or running: (1) ensure the registry metadata is corrected to list MESHY_API_KEY so you know what credentials are required; (2) only provide an API key you trust Meshy with (use limited-scope keys if available); (3) be aware downloads come from URLs returned by the service — avoid running untrusted binaries and inspect downloaded content before executing anything; (4) if you’ll run the scripts locally, run them in an isolated environment (container or VM) if you have concerns about third-party content. If you need higher assurance, request that the publisher add the required env var to the registry metadata and confirm the package's provenance/homepage.

Capability Analysis

Type: OpenClaw Skill Name: clawdbot-meshyai-skill Version: 0.1.0 The OpenClaw AgentSkills skill bundle for Meshy.ai is classified as benign. The skill's purpose is to interact with the Meshy.ai API to generate and download assets, which it achieves by making API calls and saving outputs to a local directory. It properly handles the `MESHY_API_KEY` via environment variables and uses standard Python libraries (`urllib.request`, `os`) for network communication and file operations. There is no evidence of data exfiltration beyond the necessary API key for authentication, no malicious execution patterns, no persistence mechanisms, and no prompt injection attempts in `SKILL.md` or `README.md`.

Capability Assessment

ℹ Purpose & Capability

The code and SKILL.md implement a Meshy.ai client (text-to-image and image-to-3d) and require MESHY_API_KEY and optional MESHY_BASE_URL — this matches the description. However the registry metadata lists no required env vars/primary credential, which is inconsistent with the code and docs.

✓ Instruction Scope

Runtime instructions are narrow and explicit: set MESHY_API_KEY (optional MESHY_BASE_URL), run the provided Python scripts, create tasks, poll until completion, and download returned URLs. The scripts only read local files you explicitly pass (for data-URI upload) and do network calls to the Meshy API and the returned model/image URLs.

✓ Install Mechanism

No install spec (instruction-only + bundled Python scripts). Nothing is downloaded or executed at install time; risk is limited to running included Python scripts.

ℹ Credentials

The code requires a single API key (MESHY_API_KEY) and optionally MESHY_BASE_URL, which is appropriate for a REST API client. The registry metadata failing to declare this required env var is a discrepancy that should be corrected before trusting the metadata alone.

✓ Persistence & Privilege

The skill does not request permanent presence (always=false) and does not modify other skills or system-wide settings. It can be invoked autonomously by the agent (platform default), which is expected for a callable skill.

Version History

v0.1.0

Initial release of the meshy-ai skill. - Integrates Meshy.ai REST API for generating assets: text-to-2D images and image-to-3D models. - Supports downloading results locally, always saving OBJ files for 3D outputs. - CLI scripts provided for both generation modes with async polling and output management. - Requires setting MESHY_API_KEY in the environment for authentication.

Metadata

Slug clawdbot-meshyai-skill

Version 0.1.0

License —

All-time Installs 2

Active Installs 2

Total Versions 1

Frequently Asked Questions

What is Meshy AI?

Use the Meshy.ai REST API to generate assets: (1) text-to-2d (Meshy Text to Image) and (2) image-to-3d, then download outputs locally. Use when the user wants Meshy generations, needs polling async tasks, and especially when they want the resulting OBJ saved to disk. Requires MESHY_API_KEY in the environment. It is an AI Agent Skill for Claude Code / OpenClaw, with 1975 downloads so far.

How do I install Meshy AI?

Run "/install clawdbot-meshyai-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Meshy AI free?

Yes, Meshy AI is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Meshy AI support?

Meshy AI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Meshy AI?

It is built and maintained by Dídac Sabatés (@sabatesduran); the current version is v0.1.0.

More Skills

Meshy AI