Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Budowanie i kod

create-3d-avatar

/create-3d-avatar

Tworzy z opisu tekstowego lub obrazu referencyjnego animowalnego awatara 3D w formacie GLB z szkieletem humanoidalnym i linkiem do studia póz.

Repozytorium
three.ws ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
6
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Tworzy z opisu tekstowego lub obrazu referencyjnego animowalnego awatara 3D w formacie GLB z szkieletem humanoidalnym i linkiem do studia póz.

Wyzwalacze z opisu

make a 3D avatar of a knightgenerate a character I can animatecreate a rigged astronaut
Oryginalny opis (EN)

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.

Jak działa

  1. When to use which tool
  2. Fastest path: the MCP tool
  3. Portable path: the hosted HTTP endpoint
  4. Manual two-step (REST)
  5. What to do with the result
  6. Prompting tips
  7. Higher-fidelity & paid lanes
  8. Errors
Sekcje z nagłówków SKILL.md, w oryginale · 134 linii, 830 słów
Podgląd SKILL.md
---
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, 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: MIT
metadata:
  category: 3d/creative
  cross-platform-safe: "true"
  pack: three-ws-skills
---

# Create a rigged 3D avatar

Turn 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
clips immediately.

The result is a **`glbUrl`** for the rigged model plus a **pose-studio link** that
opens the avatar ready to pose in the browser.

## When to use which tool

| Goal | Use |
| --- | --- |
| A posable humanoid **character** from text/image | this skill |
| A static object / prop / creature | `generate-3d-model` |
| Add a skeleton to a GLB you already generated | `rig-a-model` |

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

If 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,
    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
inputs, mesh only.

## Portable path: the hosted HTTP endpoint

No MCP client needed. The free hosted lane is a public JSON-RPC endpoint at
`https://three.ws/api/mcp-studio`:

```bash
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_avatar",
      "arguments": { "prompt": "a friendly cartoon astronaut in a glossy white suit" }
    }
  }'
```

`structuredContent` returns the rigged model:

```json
{
  "kind": "avatar",
  "glbUrl": "https://three.ws/cdn/creations/def456/rigged.glb",
  "viewerUrl": "https://three.ws/viewer?src=https%3A%2F%2Fthree.ws%2F...",
  "format": "glb",
  "rigged": true,
  "prompt": "a friendly cartoon astronaut in a glossy white suit"
}
```

## 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:

```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.
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" }'

# 2. Rig the resulting GLB (see rig-a-model)
curl -s -X POST "https://three.ws/api/forge?action=rig" -H 'content-type: application/json' \
  -d '{ "glb_url": "<glbUrl from step 1>" }'
```

## What to do with the result

1. Give the user the **pose-studio / viewer link**: they can pose and preview the
   rigged avatar in the browser.
2. Give the **`glbUrl`** for download / import into a 3D engine; it already carries
   a humanoid skeleton and skin weights, so animation clips play on it.

## Prompting tips

- One **full-body humanoid**, neutral standing pose, arms slightly away from the
  body (best for a clean rig).
- Name the silhouette and materials: `"a tall slender elf ranger in green leather
  armor"`. 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 with
  fingers 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
  "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
  with both hands fused into one clasped blob at the chest in one case, and with
  cleanly separated fingers in another. What correlates with separated fingers is
  the hands being **away from the torso and from each other** in the described
  pose, 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
  realism cues on the reference image) instead of the faster draft/standard
  default. This is automatic; no input needed.

## Higher-fidelity & paid lanes

The full three.ws MCP server also exposes higher-fidelity, art-directed and paid
avatar lanes. The free hosted path above is the cross-platform-safe one. The rig
internals (skeleton convention, what makes a model riggable) live in the
`rig-a-model` skill.

## 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;
  hand it back and offer to retry rigging via `rig-a-model`.

Never report a dead or empty link as success.

Wersje

W bazie nie ma innych skilli o nazwie create-3d-avatar.

Identyczna treść występuje jeszcze w 2 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki d218a729d3d4 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90auto-rig
    Przygotowuje model 3D do animacji: dodaje szkielet humanoidalny i wagi skóry do pliku GLB albo tworzy awatara z tekstu lub obrazów.
  • 100rig-a-model
    Dodaje szkielet i wagi skóry do statycznego modelu GLB, zamieniając go w model gotowy do animacji, i zwraca link do pose studio.
  • 95glb-creator
    Tworzy animowane modele GLB z teksturami i szkieletem, sprawdza każdy klip i buduje lokalny podgląd do przeglądu.
  • 100game-dev-character-model
    Tworzy realistyczny model postaci 3D z opisu lub referencji jako teksturowany, zrigowany plik GLB w podglądzie three.js.
  • 87plz-rig-model
    Dodaje do modelu 3D w formacie .blend lub .glb szkielet z wagami, animacjami bazowymi i eksportem do glTF.
  • 100scenario-meshy
    Tworzy i dopracowuje zasoby 3D modelami Meshy w Scenario przez MCP: image-to-3D, text-to-3D, retekstura GLB, remesh, rozwijanie UV, auto-rigging i animacje.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.