nirholas/three.ws · Archived

generate-3d-model

Turn a text prompt into a downloadable, textured 3D model (GLB).

First seen Aug 14, 2026

Installation

$ npx skills add nirholas/three.ws --skill generate-3d-model

Summary

  • Turn a text prompt into a downloadable, textured 3D model (GLB).
  • Use when you or the user want to generate, create, make, or forge a 3D model, asset, object, mesh, or prop from a text description — "make a 3D model of a robot", "generate a GLB of a sword", "I need a 3D chair".
  • Runs on the FREE text→3D lane (no key, no account, free).
  • Returns a GLB URL plus a browser viewer link.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from nirholas/three.ws · top by installs.

npx skills add nirholas/three.ws

Browse all from nirholas/three.ws

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 95
License LICENSE
Default branch main
Open issues 7
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

LicenseMIT
More metadata
category
3d/creative
cross-platform-safe
1
pack
three-ws-skills

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,223 B
  • docs SUMMARY.md 410 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 2 installs

SKILL.md

Generate a 3D model from text

Turn a natural-language prompt into a textured, downloadable GLB model on the free three.ws text→3D lane (NVIDIA NIM / Microsoft TRELLIS). No API key and no account — the platform's server-side keys cover provider cost.

The result is always two things: a durable glbUrl (download / import into any 3D tool) and a viewer link that renders the model in the browser.

When to use which tool

Goal Use
A single object / prop / creature from text this skill (free lane)
A posable humanoid character with a skeleton create-3d-avatar
Add a skeleton to a GLB you already have rig-a-model

Fastest path — the MCP tool

If the three.ws MCP server is connected, call the free tool directly:

  • Tool: forge_free
  • Input: { "prompt": "<description>", "tier": "draft" }

- prompt — 3–1000 chars. Lead with the subject, then its key materials and colors. The free lane conditions on ~77 characters, so front-load what matters: "a friendly round robot mascot, glossy white plastic, big blue eyes". - tier — draft (fast, default), standard, or high. All free; higher tiers only take longer.

  • Returns: glbUrl, viewerUrl, tier, backend, durationMs.

This is text-only (the free TRELLIS preview does not accept uploaded photos). For image / multi-view → 3D, use the art-directed lanes described in [reference.md](reference.md).

Portable path — the hosted HTTP endpoint

No MCP client required. The same free lane is a public JSON-RPC endpoint at https://three.ws/api/mcp-studio (no auth, no account):

curl -s -X POST https://three.ws/api/mcp-studio \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "forge_free",
      "arguments": { "prompt": "a small glossy green ceramic frog figurine", "tier": "draft" }
    }
  }'

Response (structuredContent) carries the model:

{
  "kind": "model",
  "glbUrl": "https://three.ws/cdn/creations/abc123/mesh.glb",
  "viewerUrl": "https://three.ws/viewer?src=https%3A%2F%2Fthree.ws%2Fcdn%2F...",
  "format": "glb",
  "prompt": "a small glossy green ceramic frog figurine"
}

Discover the full free tool set first with {"jsonrpc":"2.0","id":1,"method":"tools/list"}.

What to do with the result

  1. Give the user the viewer link — they can rotate and inspect the model in the

browser immediately.

  1. Give the glbUrl for download / import into Blender, Unity, three.js, etc.
  2. If they want it animated, feed glbUrl into the rig-a-model skill.

Higher-fidelity & art-directed lanes

The full three.ws MCP server also exposes art-directed and image→3D lanes (mesh_forge) and paid lanes with denser geometry. Those, the tier trade-offs, the raw POST /api/forge REST shape, and full error handling are in [reference.md](reference.md) — load it only when you need more than the free text→3D path above.

Errors

The free lane is shared and protected by per-IP rate limits and a global capacity breaker. Handle these and retry rather than failing:

  • rate_limited / busy — honor retryAfter (seconds) and try again.
  • not_configured — the durable lane is momentarily cold; retry shortly.
  • lane_degraded — a result was produced but its URL was unreachable; retry.

Never report a dead or empty link as success — only return a glbUrl the call actually produced.