# Send Sideload Avatar Generator to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "sideload-avatar-generator",
    "name": "Sideload Avatar Generator",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/DirectiveCreator/sideload-avatar-generator",
    "canonicalUrl": "https://clawhub.ai/DirectiveCreator/sideload-avatar-generator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/sideload-avatar-generator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sideload-avatar-generator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SIDELOAD-API.md",
      "SKILL.md",
      "package.json",
      "scripts/generate.js",
      "scripts/status.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "sideload-avatar-generator",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-08T19:21:47.321Z",
      "expiresAt": "2026-05-15T19:21:47.321Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sideload-avatar-generator",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sideload-avatar-generator",
        "contentDisposition": "attachment; filename=\"sideload-avatar-generator-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "sideload-avatar-generator"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/sideload-avatar-generator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/sideload-avatar-generator",
    "downloadUrl": "https://openagent3.xyz/downloads/sideload-avatar-generator",
    "agentUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent.md"
  }
}
```
## Documentation

### Sideload Avatar Generator

Generate 3D avatars from text prompts or reference images using Sideload.gg. Pay-per-use via the x402 protocol — $2 USDC per generation on Base.

Works with any x402 wallet. Bring your own wallet and private key — no proprietary wallet required.

### What You Get

Each generation produces four formats:

FormatFileUse CaseGLB.glbUniversal 3D — Three.js, Unity, Unreal, web viewersVRM.vrmAvatar standard — VRChat, VTubing, social appsMMLURLMetaverse Markup Language — for MML-compatible worldsPNG.pngProcessed reference image used for generation

### 🎭 Rendering Avatars with @pixiv/three-vrm

The VRM output is designed to work with @pixiv/three-vrm — the standard Three.js library for loading, displaying, and animating VRM avatars. If you're already building with Three.js, generated avatars plug right in with full skeleton support:

import * as THREE from 'three';
import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader';
import { VRMLoaderPlugin } from '@pixiv/three-vrm';

const loader = new GLTFLoader();
loader.register((parser) => new VRMLoaderPlugin(parser));

loader.load('https://aiml.sideload.gg/models/avt-xxx.vrm', (gltf) => {
  const vrm = gltf.userData.vrm;
  scene.add(vrm.scene);

  // Animate bone transforms, look-at, etc.
});

This makes it easy to generate an avatar with Sideload and immediately use it in any Three.js scene — games, social apps, virtual worlds, VTubing, and more.

For more on building interactive 3D experiences in the metaverse, see awesome-mml — a curated list of MML (Metaverse Markup Language) resources.

### Prerequisites

Node.js 18+


An x402 payment token — sign a payment with your own wallet/signer and pass it via --x402-token. This skill never handles private keys.
# Check the cost first
node scripts/generate.js --probe

# Generate with your x402 token
node scripts/generate.js --prompt "..." --x402-token <base64-encoded-payment>

Use any x402-compatible client to obtain a payment token: Coinbase x402 SDK, Thirdweb x402, or your own signing flow.

### Setup

npm install

### Generate from Text Prompt

node scripts/generate.js --prompt "A cyberpunk samurai with glowing red armor" --x402-token <token>

### Generate from Image URL

node scripts/generate.js --image https://example.com/character.png --x402-token <token>

### Generate from Local Image

node scripts/generate.js --image /path/to/photo.jpg --x402-token <token>

### Check Cost (No Payment)

node scripts/generate.js --probe

### Check Job Status

node scripts/status.js avt-a1b2c3d4

### Options

FlagDescription--prompt "text"Text description of the avatar--image <url-or-path>Reference image (URL or local file path)--x402-token <token>x402 payment token (required for generation)--probeCheck cost without generating--output <name>Custom filename for downloaded files--no-downloadSkip downloading result files

### API Reference

See SIDELOAD-API.md for the full API documentation, or visit sideload.gg/agents/raw.

### Quick Reference

Generate:

POST https://sideload.gg/api/agent/generate
Headers: Content-Type: application/json, x-payment: <x402_token>

Text: { "type": "text", "prompt": "description" }
Image: { "type": "image", "imageUrl": "https://..." }

Poll: GET https://sideload.gg/api/agent/generate/{jobId}/status (no auth needed)

### Prompt Tips

Be specific about:

Appearance: clothing, colors, accessories
Style: realistic, anime, cartoon, cyberpunk
Features: armor, weapons, hairstyle, wings

Good prompts:

"A steampunk engineer with leather tool belt, copper mechanical arm, weathered pilot hat"
"An anime-style sorceress with long silver hair, glowing purple eyes, ornate golden staff"
"A futuristic soldier in white and blue power armor with glowing energy shield"

### Image Tips

PNG, JPG, or WebP
Front-facing portraits or full-body shots work best
Clear outlines and distinct clothing/features
Higher resolution → better results

### Rate Limits & Cost

$2 USDC per generation (x402 on Base, chain ID 8453)
10 generations per 30 minutes per wallet
Check Retry-After header on 429 responses

### Links

Sideload.gg
API Documentation
@pixiv/three-vrm — Three.js VRM avatar loader
awesome-mml — MML resources for the metaverse
x402 Protocol
Coinbase x402 SDK
VRM Specification
MML (Metaverse Markup Language)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: DirectiveCreator
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-08T19:21:47.321Z
- Expires at: 2026-05-15T19:21:47.321Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/sideload-avatar-generator)
- [Send to Agent page](https://openagent3.xyz/skills/sideload-avatar-generator/agent)
- [JSON manifest](https://openagent3.xyz/skills/sideload-avatar-generator/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/sideload-avatar-generator/agent.md)
- [Download page](https://openagent3.xyz/downloads/sideload-avatar-generator)