Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
build(skills): republish the 3d-studio skills bundle so it matches .agents/skills, including the new anatomy skill
nirholas56f29d1da593
diff --git a/public/skills/3d-studio/README.md b/public/skills/3d-studio/README.mdindex 2d011d10d..36d1538ae 100644--- a/public/skills/3d-studio/README.md+++ b/public/skills/3d-studio/README.md@@ -7,6 +7,7 @@ https://three.ws/api/mcp-studio.| Skill | What it does || --- | --- |+| [`anatomy`](anatomy/SKILL.md) | Explain how a machine works as an interactive isometric 3D cutaway. || [`create-3d-avatar`](create-3d-avatar/SKILL.md) | Turn a text prompt (or reference image) into a rigged, animation-ready 3D avatar (GLB). || [`embed-three-ws-avatar`](embed-three-ws-avatar/SKILL.md) | Embed a live, animated three.ws 3D avatar in any website with the <agent-3d> web component. || [`find-3d-assets`](find-3d-assets/SKILL.md) | Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. |@@ -24,7 +25,7 @@ curl -O https://three.ws/skills/3d-studio/three-ws-3d-skills.zipOr read one directly, no clone required:```bash-curl https://three.ws/skills/3d-studio/create-3d-avatar/SKILL.md+curl https://three.ws/skills/3d-studio/anatomy/SKILL.md```Drop a folder into `.claude/skills/` for Claude Code or the Claude apps, uploaddiff --git a/public/skills/3d-studio/anatomy/SKILL.md b/public/skills/3d-studio/anatomy/SKILL.mdnew file mode 100644index 000000000..1ec363690--- /dev/null+++ b/public/skills/3d-studio/anatomy/SKILL.md@@ -0,0 +1,96 @@+---+name: anatomy+description: Explain how a machine works as an interactive isometric 3D cutaway. Use when the user asks how an engine, turbine, reactor, pump, clock, motor or any mechanism works and wants to see it, or types "/anatomy <machine>", for example "/anatomy explain how a big airliner turbofan engine like the A380's makes thrust, interactive". Produces a shareable three.ws link with real moving parts, shader effects (fire, exhaust, plasma, water, steam, sparks, arcs), flows, a section cut, an exploded view and a guided tour.+when_to_use: The user wants a machine or mechanism explained visually and interactively. For a static 3D object to download, use generate-3d-model. For a character, use create-3d-avatar.+license: MIT+metadata:+ category: 3d/creative+ cross-platform-safe: true+ pack: three-ws-skills+---++# Anatomy: machines as interactive cutaways++Describe a machine in one line and get back an interactive isometric wireframe+cutaway on three.ws. Visitors can rotate it, step through a guided tour, explode+it, cut it open, switch to x-ray and click any part to read what it does. Moving+parts really move, and the physics is drawn with WebGL shaders.++The result is a permalink such as `https://three.ws/anatomy/<id>`. Share it as+the answer. It works on desktop and phones, with no account needed to view it.++## Two ways to build one++### 1. You write the spec (best quality, recommended)++You know the machine. Write the spec yourself and publish it.++1. Read [reference.md](reference.md). It is the full spec format: parts and+ shapes, motion, effects, flows, the tour and the quality bar. The server+ validates against exactly these rules.+2. Write one JSON object for the machine the user asked about. If they named a+ real machine (for example the Rolls-Royce Trent 900 on the A380), model that+ machine and its real proportions, stage counts and numbers. If they were+ vague, choose the most iconic real example and say which in `subtitle`.+3. Publish it:++```bash+curl -s -X POST https://three.ws/api/anatomy \+ -H 'content-type: application/json' \+ --data-binary @- <<'JSON'+{ "action": "publish", "prompt": "<the user's request>", "spec": { ...your spec... } }+JSON+```++The response is `{ "design": { "id", "url", "title", "stats" }, "warnings": [] }`.+Give the user `design.url`. `stats` counts parts, moving instances, effects,+flows and tour steps.++`warnings` lists anything the normalizer repaired, such as an unknown parent, an+unknown focus id or a clamped value. The machine still renders. If a warning+points at something that matters (a missing part, a broken hierarchy), fix the+spec and publish again. Each publish gets a new permalink.++### 2. Ask three.ws to write it++When you cannot write the spec yourself, let the server's writer do it. This+takes one to several minutes.++```bash+curl -s -X POST https://three.ws/api/anatomy \+ -H 'content-type: application/json' \+ -d '{ "action": "generate", "prompt": "how a big airliner turbofan like the A380s makes thrust" }'+```++The response has the same `{ design, warnings }` shape. Pass `"stream": true` to+receive Server-Sent Events instead: `stage`, `delta` (the spec text as it is+written), `reset`, then one `done` (or `error`). Visitors can also type a prompt+straight into https://three.ws/anatomy and watch the machine assemble.++## Errors++| status | `error` | what to do |+| --- | --- | --- |+| 400 | `invalid_spec` | The spec is not a JSON object or has no renderable parts. `detail` lists the warnings. Fix and resend. |+| 400 | `prompt_required` | Send a prompt of at least 3 characters. |+| 413 | `spec_too_large` | Keep the spec under 400 KB. Use `repeat` instead of copying parts. |+| 429 | `rate_limited` | Wait for the `retry-after` header, then retry. |+| 503 | `writer_unavailable` / `storage_unavailable` | Retry in a minute. With path 1, the spec you wrote is still valid. |++## Reading an existing machine++- `GET https://three.ws/api/anatomy?id=<uuid>` returns `{ design }` with the full spec.+ Start from it to make a variation.+- `GET https://three.ws/api/anatomy?list=recent&q=<text>` lists recent machines+ without their specs.++## What makes a great one++- **Accurate:** real part names, proportions and figures, such as pressure ratios,+ temperatures and rpm. Describe a relationship rather than inventing a number.+- **Complete:** typically 25 to 90 parts plus repeats.+- **Built as hierarchies:** blades and discs sit under the shaft that turns them.+- **Readable at a glance:** `glass` casings and a `view.section` cutaway show the+ inside.+- **A tour that teaches:** it follows the physics in order (intake to exhaust,+ fuel to power) and focuses each step on the few parts that matter.diff --git a/public/skills/3d-studio/anatomy/reference.md b/public/skills/3d-studio/anatomy/reference.mdnew file mode 100644index 000000000..862b9b879--- /dev/null+++ b/public/skills/3d-studio/anatomy/reference.md@@ -0,0 +1,151 @@+<!-- Generated by scripts/build-anatomy-skill.mjs from api/_lib/anatomy/guide.js. Edit the guide, then rerun the script. -->++# Anatomy spec reference++An Anatomy spec is one JSON object that describes a machine as named parts, moving pieces, physical effects and a guided tour. The three.ws runtime renders it as an interactive isometric wireframe: people rotate it, explode it, cut it open, click parts to read about them and step through how it works.++## Top level++```json+{+ "title": "A380-class turbofan",+ "subtitle": "How a high-bypass engine turns kerosene into thrust",+ "summary": "Two or three plain sentences: what the machine does and the one idea that makes it work.",+ "parts": [],+ "effects": [],+ "flows": [],+ "steps": [],+ "view": { "speed": 1, "explode": 0, "section": "z" }+}+```++- `title` (max 80 chars), `subtitle` (max 140), `summary` (max 600; blank lines split paragraphs).+- `view.speed` multiplies every motion (0 to 4, default 1). `view.explode` (0 to 1) opens with the parts pulled apart. `view.section` (`"x"`, `"y"` or `"z"`) opens with a cutaway: a cutting plane perpendicular to that axis through the middle of the machine, removing the half nearest the viewer. To open a machine lengthwise, cut across a short axis: a turbofan lying along x is opened with `"z"`, which shows every stage from fan to nozzle. Use a cutaway for anything whose interesting parts are inside a casing (engines, pumps, reactors, turbines).++## Coordinates and units++- Right handed, +Y up. One unit is whatever makes the machine about 4 to 12 units across. Keep every coordinate within ±500.+- The camera looks from the +X, +Y, +Z corner, so put the most interesting face toward +X and +Z.+- Rotations are Euler degrees `[x, y, z]`.+- Every shape is built around its own centre. Shapes with an `axis` run along that axis (`"x"`, `"y"` or `"z"`, default `"y"`). A long horizontal machine (jet engine, locomotive, pump train) should run along `"x"`.++## Parts++```json+{+ "id": "fan",+ "name": "Fan",+ "group": "Fan section",+ "description": "What it is, what it does, and one concrete number when you know one.",+ "parent": "low-shaft",+ "shape": { "type": "rotor", "axis": "x", "blades": 24, "radius": 1.5, "hubRadius": 0.4, "chord": 0.45, "twist": 30, "pitch": 35 },+ "position": [3, 0, 0],+ "rotation": [0, 0, 0],+ "scale": [1, 1, 1],+ "color": "#4f8dff",+ "style": "solid",+ "glow": 0,+ "repeat": { "count": 8, "axis": "x", "angle": 360 },+ "motion": [{ "type": "spin", "axis": "x", "speed": 0.8 }],+ "explode": [1.5, 0, 0],+ "label": true+}+```++- `id`: short kebab-case, unique across parts, effects and flows. Steps and parents refer to it.+- `name` (max 60), `group` (max 40; parts with the same group are listed together and share a colour when `color` is omitted), `description` (max 420; this is what people read when they click the part, so make it teach).+- `parent`: id of another part. The child's position and rotation are relative to the parent, and the child inherits the parent's motion: put blades, discs and rods under the shaft that drives them so they turn together. A missing or circular parent is attached to the root.+- `position`, `rotation`, `scale`: relative to the parent (or the world).+- `color`: hex. Use a consistent palette: cool blues and greys for cold structure, warm oranges and reds for hot sections, greens for fluids or electrics. Omit to colour by group.+- `style`: `"solid"` (default, shaded with hidden lines), `"glass"` (see-through shell; use for casings, nacelles, vessels), `"ghost"` (barely there; use for context like a fuselage stub), `"wire"` (lines only).+- `glow`: 0 to 1, makes hot parts emit their own colour (combustors, turbine blades, filaments, reactor cores).+- `repeat`: makes copies of the part and everything under it. Radial: `{ "count": 8, "axis": "x", "angle": 360 }` rotates each copy about the parent's axis through the parent's origin, so place the first copy off-axis (for example `"position": [0, 1.2, 0]`) and the copies ring around. A partial `angle` fans the copies across that arc. Linear: `{ "count": 6, "offset": [0.5, 0, 0] }` steps each copy by the offset. Max 96 copies.+- `explode`: the direction and distance (in units, relative to the parent) this part moves when the viewer explodes the machine. Omit it and top-level parts fly outward from the centre automatically; children ride with their parent unless they set their own.+- `label`: `true` pins a floating name label on the part. When no part sets it, the top-level parts are labelled. Label the 6 to 14 parts a newcomer must know; `false` hides a label.++## Shapes++Every `shape` has a `type`. Sizes are in units.++| type | fields | use for |+|---|---|---|+| `box` | `size [w,h,d]`, `radius` (corner rounding) | frames, blocks, housings, plates |+| `cylinder` | `axis`, `radiusTop`, `radiusBottom` (or `radius`), `length`, `open` | shafts, pistons, drums, tapered ducts (different radii) |+| `tube` | `axis`, `outerRadius`, `innerRadius`, `length` | casings, liners, sleeves, bearings, cylinders with bores |+| `cone` | `axis`, `radius`, `length` (tip toward +axis) | nose cones, spinners, nozzles, tips |+| `sphere` | `radius`, `hemisphere`, `axis` | domes, balls, pressure vessels, cores |+| `capsule` | `axis`, `radius`, `length` (overall) | tanks, rounded rods, fuel rods |+| `torus` | `axis`, `radius`, `tube`, `arc` (degrees) | rings, seals, coils, tokamak vessels, manifolds |+| `gear` | `axis`, `teeth`, `radius`, `toothDepth`, `thickness`, `bore` | spur gears, sprockets, escape wheels |+| `rotor` | `axis`, `blades`, `radius`, `hubRadius`, `chord`, `thickness`, `twist`, `pitch`, `hubLength` | fans, compressor and turbine stages, propellers, impellers, wind turbine rotors |+| `lathe` | `axis`, `profile [[r, along], ...]` | any turned part: nacelles, bells, nozzles, pistons with crowns, bottles. `r` is the radius at position `along` the axis |+| `extrude` | `axis` (default `"z"`), `points [[u, v], ...]`, `depth` | flat plates of any outline: con-rod webs, brackets, cams, levers, anchors |+| `spring` | `axis`, `radius`, `wire`, `turns`, `length` | coil springs, heating coils, windings |+| `pipe` | `path [[x,y,z], ...]`, `radius`, `closed` | plumbing, fuel lines, cables, exhaust headers. Path points are in the part's own space |++Shape tips:+- A turbofan's nacelle, a rocket's bell and a reactor vessel are `lathe` profiles. Six to twelve profile points give a smooth, accurate silhouette. For a hollow shell, trace the outer surface out and back along the inner surface, the way a machinist would draw a half section.+- A compressor or turbine is a stack of `rotor` stages, each a thin slice (small `hubLength`) at its own position, under the shaft that drives them. Real engines have many stages; draw enough (6 to 12) to read as a stack.+- Stator vanes are a `rotor` with no motion and negative `pitch`, interleaved between rotor stages.+- Gears that mesh must have the same tooth size: `radius / teeth` equal on both, and centres `r1 + r2` apart. Spin them in opposite directions at speeds inversely proportional to their tooth counts.++## Motion++`motion` is a list (max 3) applied in order. Children inherit it.++- `{ "type": "spin", "axis": "x", "speed": 0.5, "phase": 0 }`: continuous rotation, `speed` in revolutions per second (negative reverses). Keep it readable: 0.2 to 2. Show relative speeds truthfully (an HP spool turns faster than an LP spool) but scale them down.+- `{ "type": "oscillate", "kind": "translate", "axis": "y", "amplitude": 0.3, "frequency": 1, "phase": 0 }`: back and forth, amplitude in units. `"kind": "rotate"` rocks instead, amplitude in degrees (pendulums, pallets, valve rockers).+- `{ "type": "crank", "axis": "y", "radius": 0.4, "rod": 1.4, "speed": 1, "phase": 0 }`: true slider-crank travel for pistons, between +radius and -radius about the part's position. Match `speed` to the crankshaft's spin, and give each cylinder its firing-order `phase` (degrees).+- `{ "type": "pulse", "amplitude": 0.06, "frequency": 1 }`: breathing scale for hearts of the machine (a reactor core, a solenoid).++## Effects++Effects are the physics you can see. Each has an `id` and a `type`, and sits at `position` (relative to its `parent` part when given, so a flame inside a spinning part spins with it, and a repeated parent repeats its effects). Volumes grow from `position` along `axis` in `direction` (1 or -1).++| type | fields | use for |+|---|---|---|+| `flame` | `radius` (base), `radiusEnd`, `length`, `axis`, `direction` | combustors, burners, candles, fireboxes |+| `exhaust` | `radius`, `radiusEnd`, `length`, `axis`, `direction` | jet and rocket plumes, with shock diamonds |+| `plasma` | `radius`, `form` (`"sphere"`, `"torus"` with `radiusEnd` as the tube, `"column"` with `length`) | fusion plasma, arcs in a lamp, stellar cores, ion drives |+| `water` | `radius`, `radiusEnd`, `length` (a stream), or `"form": "pool"` with `size [w,h,d]` | jets, falling water, coolant pools, tanks |+| `smoke` | `radius`, `length` (rise height), `count` | chimneys, exhaust stacks, burning fuel |+| `steam` | `radius`, `length`, `count` | boilers, kettles, cooling towers, safety valves |+| `sparks` | `radius`, `length`, `count` | spark plugs, grinders, welding, ignition |+| `electric` | `from [x,y,z]`, `to [x,y,z]` | arcs, lightning, spark gaps, Tesla coils |+| `glow` | `radius` | hot spots, lamps, LEDs, heat sources |++All effects also take `name`, `description`, `color` and `color2` (hex; sensible defaults per type), `intensity` (0 to 3) and `speed` (0 to 10).++## Flows++Flows show something travelling through the machine: air, fuel, coolant, current, steam, exhaust. Particles stream along a smooth path over a dashed guide with direction arrows.++```json+{ "id": "core-air", "name": "Core airflow", "description": "...", "path": [[4,0.3,0],[2,0.3,0],[0,0.2,0],[-2,0.3,0],[-4,0.2,0]], "color": "#3fa9ff", "speed": 0.3, "count": 40, "size": 1, "closed": false }+```++- `path` is in world space (2 to 64 points). Route it through the real passages: between casing and core, around a loop, down a pipe.+- `speed` is path lengths per second (0.1 to 0.6 reads well). `closed: true` for loops (refrigerant, coolant, a current in a circuit).+- Use distinct colours per flow (cold air blue, hot gas orange, fuel amber, coolant cyan).++## Steps (the tour)++```json+{ "title": "Air comes in", "body": "Two to four sentences explaining this stage, with a real number when you know one.", "focus": ["fan", "inlet", "bypass-air"] }+```++- 4 to 10 steps that follow the physics in order (intake to exhaust, fuel to power, input to output). The final step ties it together.+- `focus` lists the part, effect and flow ids this step is about. The viewer fades everything else and frames these, so be selective. Parts under a focused part are included automatically.+- `body` max 520 characters; blank lines split paragraphs.++## Quality bar++- Be accurate. Real proportions, real part names, real stage counts, real numbers in descriptions and steps (pressure ratios, temperatures, rpm, efficiencies). If you are unsure of a figure, describe the relationship instead of inventing a number.+- Be complete. Every part a textbook cutaway would label should be there, typically 25 to 90 parts plus repeats. Moving parts move; hot parts glow; working fluids flow.+- Build hierarchies. Rotating assemblies are one shaft part with blades, discs and hubs as children.+- Make the motion tell the story: what spins, what reciprocates, what stays still, and the flows show where the energy goes.+- Lay it out so it reads at a glance from the isometric corner; use `glass` casings and a `view.section` cutaway instead of hiding the interior.++## Output rules++Return only the JSON object. No prose before or after it, no markdown fences, no comments, no trailing commas. Write the keys in this order so the viewer can draw the machine while you are still writing: title, subtitle, summary, view, parts, effects, flows, steps. Put parents before their children in the parts list.diff --git a/public/skills/3d-studio/create-3d-avatar/SKILL.md b/public/skills/3d-studio/create-3d-avatar/SKILL.mdindex e1c421747..716643fee 100644--- a/public/skills/3d-studio/create-3d-avatar/SKILL.md+++ b/public/skills/3d-studio/create-3d-avatar/SKILL.md@@ -1,6 +1,6 @@---name: create-3d-avatar-description: Turn a text prompt (or reference image) into a rigged, animation-ready 3D avatar (GLB). Use when you or the user want to create, generate, or make a 3D avatar, character, or humanoid figure that can be posed and animated, "make a 3D avatar of a knight", "generate a character I can animate", "create a rigged astronaut". Generates the mesh and adds a humanoid skeleton in one step. Returns a GLB URL plus a pose-studio link.+description: Turn a text prompt (or reference image) into a rigged, animation-ready 3D avatar (GLB). Use when you or the user want to create, generate, or make a 3D avatar, character, or humanoid figure that can be posed and animated, for example "make a 3D avatar of a knight", "generate a character I can animate", "create a rigged astronaut". Generates the mesh and adds a humanoid skeleton in one step. Returns a GLB URL plus a pose-studio link.when_to_use: User wants a posable/animatable humanoid character. For a static object or prop, use generate-3d-model. To rig a GLB you already have, use rig-a-model.license: MITmetadata:@@ -12,8 +12,8 @@ metadata:# Create a rigged 3D avatarTurn a text prompt or a reference image into a **rigged, animation-ready** humanoid-avatar (GLB). One call generates the textured mesh, then auto-rigs it, adding a-humanoid skeleton and skin weights, so the model can be posed and play animation+avatar (GLB). One call generates the textured mesh, then auto-rigs it (adding a+humanoid skeleton and skin weights) so the model can be posed and play animationclips immediately.The result is a **`glbUrl`** for the rigged model plus a **pose-studio link** that@@ -30,24 +30,24 @@ opens the avatar ready to pose in the browser.Auto-rigging assumes a **humanoid figure**. A clearly non-humanoid subject(furniture, vehicle, quadruped) is steered to `generate-3d-model` instead.-## Fastest path, the MCP tool+## Fastest path: the MCP toolIf the three.ws MCP server is connected, call the one-step avatar tool:- **Tool:** `forge_avatar`- **Input:** `{ "prompt": "<character description>" }` or`{ "image_url": "<https URL to a reference image>" }`- - `prompt`, describe a **single full-body humanoid** in a neutral standing pose:- `"a friendly cartoon astronaut in a glossy white suit"`.- - `image_url`, reconstruct and rig a character from a photo/render.- - `allow_non_humanoid`, set `true` only to rig a non-humanoid subject anyway.+ - `prompt`: describe a **single full-body humanoid** in a neutral standing pose,+ for example `"a friendly cartoon astronaut in a glossy white suit"`.+ - `image_url`: reconstruct and rig a character from a photo/render.+ - `allow_non_humanoid`: set `true` only to rig a non-humanoid subject anyway.- **Returns:** the rigged `glbUrl` (or `riggedGlbUrl`), the intermediate mesh URL,a pose-studio link, and per-stage timing.-For a fast unrigged figure (no skeleton), use `text_to_avatar` instead, same+For a fast unrigged figure (no skeleton), use `text_to_avatar` instead: sameinputs, mesh only.-## Portable path, the hosted HTTP endpoint+## Portable path: the hosted HTTP endpointNo MCP client needed. The free hosted lane is a public JSON-RPC endpoint at`https://three.ws/api/mcp-studio`:@@ -82,11 +82,12 @@ curl -s -X POST https://three.ws/api/mcp-studio \## Manual two-step (REST)`forge_avatar` is generate-then-rig bundled. You can run the steps yourself over-`POST /api/forge`, generate a mesh, then rig it:+`POST /api/forge`: generate a mesh, then rig it:```bash# 1. Generate the figure (see generate-3d-model/reference.md for the submit/poll shape)-# "tier": "high" matches what forge_avatar/text_to_avatar request automatically, # it is the tier the router maps to the self-host Hunyuan3D lane for IRL realism.+# "tier": "high" matches what forge_avatar/text_to_avatar request automatically.+# It is the tier the router maps to the self-host Hunyuan3D lane for IRL realism.curl -s -X POST https://three.ws/api/forge -H 'content-type: application/json' \-d '{ "prompt": "a friendly cartoon astronaut in a glossy white suit", "tier": "high" }'@@ -97,7 +98,7 @@ curl -s -X POST "https://three.ws/api/forge?action=rig" -H 'content-type: applic## What to do with the result-1. Give the user the **pose-studio / viewer link**, they can pose and preview the+1. Give the user the **pose-studio / viewer link**: they can pose and preview therigged avatar in the browser.2. Give the **`glbUrl`** for download / import into a 3D engine; it already carriesa humanoid skeleton and skin weights, so animation clips play on it.@@ -105,13 +106,13 @@ curl -s -X POST "https://three.ws/api/forge?action=rig" -H 'content-type: applic## Prompting tips- One **full-body humanoid**, neutral standing pose, arms slightly away from the- body, best for a clean rig.+ body (best for a clean rig).- Name the silhouette and materials: `"a tall slender elf ranger in green leatherarmor"`. Avoid scenes, props held in hand, or multiple characters.- Hands are the hardest part of the mesh to get right. `forge_avatar` /`text_to_avatar` already direct the generator toward relaxed, open hands withfingers separated and visible (never a fist, never a hand hidden behind the- body or in a pocket), do not fight that by asking for "hands on hips" or+ body or in a pocket); do not fight that by asking for "hands on hips" or"arms crossed" unless you accept a higher chance of fused-finger geometry.Asking is not the same as getting: measured across six personas on 2026-09-08,a prompt that explicitly said "hands open, fingers separated" still came back@@ -121,7 +122,7 @@ curl -s -X POST "https://three.ws/api/forge?action=rig" -H 'content-type: applicpose, so say where the hands are ("arms hanging at his sides, palms forward"),not just what they are doing.- Both avatar tools always request the platform's `high` quality tier under the- hood, the self-host Hunyuan3D lane (people/organic-subject strength, portrait+ hood: the self-host Hunyuan3D lane (people/organic-subject strength, portraitrealism cues on the reference image) instead of the faster draft/standarddefault. This is automatic; no input needed.@@ -134,9 +135,9 @@ internals (skeleton convention, what makes a model riggable) live in the## Errors-- `rate_limited` / `busy`, honor `retryAfter` and retry.-- `not_configured`, lane momentarily cold; retry shortly.-- Generation succeeded but rigging failed, you still get the unrigged mesh URL;+- `rate_limited` / `busy`: honor `retryAfter` and retry.+- `not_configured`: lane momentarily cold; retry shortly.+- Generation succeeded but rigging failed: you still get the unrigged mesh URL;hand it back and offer to retry rigging via `rig-a-model`.Never report a dead or empty link as success.diff --git a/public/skills/3d-studio/generate-3d-model/SKILL.md b/public/skills/3d-studio/generate-3d-model/SKILL.mdindex 4930d45f3..00c492089 100644--- a/public/skills/3d-studio/generate-3d-model/SKILL.md+++ b/public/skills/3d-studio/generate-3d-model/SKILL.md@@ -1,6 +1,6 @@---name: generate-3d-model-description: 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.+description: 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, for example "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.when_to_use: User wants a 3D object/asset/prop from text. For a posable character with a skeleton, use create-3d-avatar. To rig an existing GLB, use rig-a-model.license: MITmetadata:@@ -13,7 +13,7 @@ metadata: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.+account: the platform's server-side keys cover provider cost.The result is always two things: a durable **`glbUrl`** (download / import into any3D tool) and a **viewer link** that renders the model in the browser.@@ -26,16 +26,16 @@ The result is always two things: a durable **`glbUrl`** (download / import into| 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+## Fastest path: the MCP toolIf the three.ws MCP server is connected, call the free tool directly:- **Tool:** `forge_free`- **Input:** `{ "prompt": "<description>", "tier": "draft" }`- - `prompt`, 3 to 1000 chars. Lead with the subject, then its key materials and+ - `prompt`: 3 to 1000 chars. Lead with the subject, then its key materials andcolors. 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+ - `tier`: `draft` (fast, default), `standard`, or `high`. All free; higher tiersonly take longer.- **Returns:** `glbUrl`, `viewerUrl`, `tier`, `backend`, `durationMs`.@@ -43,7 +43,7 @@ This is text-only (the free TRELLIS preview does not accept uploaded photos). Foimage / multi-view → 3D, use the art-directed lanes described in[reference.md](reference.md).-## Portable path, the hosted HTTP endpoint+## Portable path: the hosted HTTP endpointNo MCP client required. The same free lane is a public JSON-RPC endpoint at`https://three.ws/api/mcp-studio` (no auth, no account):@@ -78,7 +78,7 @@ Discover the full free tool set first with `{"jsonrpc":"2.0","id":1,"method":"to## What to do with the result-1. Give the user the **viewer link**, they can rotate and inspect the model in the+1. Give the user the **viewer link**: they can rotate and inspect the model in thebrowser immediately.2. Give the **`glbUrl`** for download / import into Blender, Unity, three.js, etc.3. If they want it animated, feed `glbUrl` into the `rig-a-model` skill.@@ -88,7 +88,7 @@ Discover the full free tool set first with `{"jsonrpc":"2.0","id":1,"method":"toThe 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, theraw `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+[reference.md](reference.md): load it only when you need more than the freetext→3D path above.## Errors@@ -96,9 +96,9 @@ text→3D path above.The free lane is shared and protected by per-IP rate limits and a global capacitybreaker. 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.+- `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+Never report a dead or empty link as success; only return a `glbUrl` the callactually produced.diff --git a/public/skills/3d-studio/rig-a-model/SKILL.md b/public/skills/3d-studio/rig-a-model/SKILL.mdindex ab48a5a74..2bb2d5762 100644--- a/public/skills/3d-studio/rig-a-model/SKILL.md+++ b/public/skills/3d-studio/rig-a-model/SKILL.md@@ -1,6 +1,6 @@---name: rig-a-model-description: Auto-rig a static 3D GLB model into an animation-ready one. Use when you or the user have an existing GLB and want to rig it, add a skeleton, add bones, make it posable, or make it animatable, "rig this model", "add a skeleton to my GLB", "make this character animation-ready". Takes a GLB URL, adds a humanoid skeleton plus skin weights, and returns the rigged GLB URL and a pose-studio link.+description: Auto-rig a static 3D GLB model into an animation-ready one. Use when you or the user have an existing GLB and want to rig it, add a skeleton, add bones, make it posable, or make it animatable, for example "rig this model", "add a skeleton to my GLB", "make this character animation-ready". Takes a GLB URL, adds a humanoid skeleton plus skin weights, and returns the rigged GLB URL and a pose-studio link.when_to_use: User already has a GLB (a URL) and wants it rigged. To generate a new model from text, use generate-3d-model; to generate an already-rigged character in one step, use create-3d-avatar.license: MITmetadata:@@ -29,18 +29,18 @@ rigged model in the browser, ready to pose.Rigging assumes a roughly **humanoid figure** (head, torso, two arms, two legs,standing). Props, furniture, and vehicles won't rig meaningfully.-## Fastest path, the MCP tool+## Fastest path: the MCP toolIf the three.ws MCP server is connected, call the rig tool directly:- **Tool:** `rig_mesh`- **Input:** `{ "glb_url": "<https URL to the static GLB>" }`- - Any reachable GLB URL works, a `glbUrl` from `generate-3d-model`, a CDN+ - Any reachable GLB URL works: a `glbUrl` from `generate-3d-model`, a CDNlink, or a model you host yourself.- **Returns:** `riggedGlbUrl`, `sourceGlbUrl`, `poseStudioUrl`, `jobId`,`creationId`, `durationMs`.-## Portable path, the hosted HTTP endpoint+## Portable path: the hosted HTTP endpointNo MCP client needed. `rig_mesh` is exposed free on the hosted studio JSON-RPCendpoint at `https://three.ws/api/mcp-studio` (no key, no account):@@ -93,19 +93,19 @@ Build the pose-studio link yourself from any rigged GLB URL:## What to do with the result-1. Give the user the **pose-studio link**, pose and preview in the browser.+1. Give the user the **pose-studio link**: pose and preview in the browser.2. Give the **`riggedGlbUrl`** for download / import; it carries a humanoidskeleton and skin weights, so animation clips retarget onto it.-3. The original mesh is never modified, `sourceGlbUrl` stays valid.+3. The original mesh is never modified; `sourceGlbUrl` stays valid.## Errors-- `rate_limited` / `429`, the rigger is busy; honor `retryAfter` and retry.-- `not_configured` / `503`, auto-rigging momentarily unavailable; retry shortly.-- `rig_failed`, the model couldn't be rigged (usually not humanoid enough).+- `rate_limited` / `429`: the rigger is busy; honor `retryAfter` and retry.+- `not_configured` / `503`: auto-rigging momentarily unavailable; retry shortly.+- `rig_failed`: the model couldn't be rigged (usually not humanoid enough).Tell the user why and suggest `create-3d-avatar` to generate a riggable figure.-- `timeout`, the job outlived the poll budget; the response includes a- `resumeUrl`, keep polling it rather than restarting the job.+- `timeout`: the job outlived the poll budget; the response includes a+ `resumeUrl`; keep polling it rather than restarting the job.-Never report a dead or empty link as success, only return a `riggedGlbUrl` the+Never report a dead or empty link as success; only return a `riggedGlbUrl` thejob actually produced.diff --git a/public/skills/3d-studio/three-ws-3d-skills.zip b/public/skills/3d-studio/three-ws-3d-skills.zipindex 4ff3d221e..e9d3a0fe4 100644Binary files a/public/skills/3d-studio/three-ws-3d-skills.zip and b/public/skills/3d-studio/three-ws-3d-skills.zip differ