SkillHub ClubAnalyze Data & AIFull StackBackendData / AI

aavegotchi-3d-renderer

Render Aavegotchi assets by deriving renderer hashes from Goldsky Base core data and calling POST /api/renderer/batch on www.aavegotchi.com. Use when the user gives a tokenId or inventory URL, or when deterministic hash plus image artifacts are required.

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars

3,108

Hot score

Updated

March 20, 2026

Overall rating

C0.0

Composite score

0.0

Best-practice grade

A88.4

Install command

npx @skill-hub/cli install openclaw-skills-aavegotchi-3d-renderer

Repository

openclaw/skills

Skill path: skills/cinnabarhorse/aavegotchi-3d-renderer

Open repository

Best for

Primary workflow: Analyze Data & AI.

Technical facets: Full Stack, Backend, Data / AI.

Target audience: everyone.

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: openclaw.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

Install aavegotchi-3d-renderer into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
Review https://github.com/openclaw/skills before adding aavegotchi-3d-renderer to shared team environments
Use aavegotchi-3d-renderer for development workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

Original source / Raw SKILL.md

---
name: aavegotchi-3d-renderer
description: Render Aavegotchi assets by deriving renderer hashes from Goldsky Base core data and calling POST /api/renderer/batch on www.aavegotchi.com. Use when the user gives a tokenId or inventory URL, or when deterministic hash plus image artifacts are required.
---

# Aavegotchi 3D Renderer

Render gotchi assets from token data and renderer batch APIs.

## Inputs

- Accept either `tokenId` or inventory URL with `id=<tokenId>`.
- Target Base by default (`chainId=8453`).

## Outputs

- Return derived renderer hash.
- Return `/api/renderer/batch` HTTP status.
- Save raw batch JSON to disk.
- Save `PNG_Full` and `PNG_Headshot` to disk when available.
- Return `GLB_3DModel` availability and URL when present.

## Execute

1. Extract `tokenId` from direct input or inventory URL.
2. Query Goldsky Base core subgraph:
`https://api.goldsky.com/api/public/project_cmh3flagm0001r4p25foufjtt/subgraphs/aavegotchi-core-base/prod/gn`
3. Derive hash in renderer format:
`<Collateral>-<EyeShape>-<EyeColor>-<Body>-<Face>-<Eyes>-<Head>-<RightHand>-<LeftHand>-<Pet>`
4. Kick off render with `POST https://www.aavegotchi.com/api/renderer/batch` using:
- `force: true`
- `verify: false`
- `renderTypes: ["PNG_Full", "PNG_Headshot", "GLB_3DModel"]`
5. Poll `POST /api/renderer/batch` with `verify: true` until `availability.exists=true` for all requested render types or timeout.
6. Download `proxyUrls.PNG_Full` and `proxyUrls.PNG_Headshot` only when corresponding `availability.exists=true`.
7. Return the hash, kickoff + verify responses, poll summary, and saved artifact paths.

## Command

Run the bundled script:

```bash
node scripts/render-gotchi-bypass.mjs --token-id 6741
```

Or pass an inventory URL:

```bash
node scripts/render-gotchi-bypass.mjs \
  --inventory-url "https://www.aavegotchi.com/u/0x.../inventory?itemType=aavegotchis&chainId=8453&id=6741"
```

Use `--out-dir /tmp` to control artifact location (default: `/tmp`).

Optional polling controls:

```bash
--poll-attempts 18 --poll-interval-ms 10000
```

## Return format

Always return:

1. `tokenId`
2. `hash`
3. Kickoff status, verify status, and raw JSON paths
4. Poll summary (`pollAttempts`, `pollIntervalMs`, `renderReady`)
5. `PNG_Full` and `PNG_Headshot` output paths (or missing reason)
6. `GLB_3DModel` availability and URL when present

## Troubleshooting

- If Goldsky returns no gotchi, verify `tokenId` and Base context.
- If batch returns hash-format `400`, verify eye mappings and right/left wearable order (`index4` then `index5`).
- If `availability.exists` is `false`, ensure kickoff used `force:true`, then keep polling `verify:true` until timeout.
- If endpoint returns `404`, verify production deployment state.


---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### README.md

```markdown
# aavegotchi-3d-render-skill

Render Aavegotchi assets from token data and renderer batch APIs.

This skill derives the renderer hash directly from Goldsky Base core subgraph data, then calls `POST /api/renderer/batch` on `www.aavegotchi.com` with `force:true`, polls `verify:true` until assets are available, and downloads image artifacts.

Skill name: `aavegotchi-3d-renderer`.

## Files

- `SKILL.md`: publishable skill definition.
- `scripts/render-gotchi-bypass.mjs`: executable helper script used by the skill.

## Quick Start

```bash
node scripts/render-gotchi-bypass.mjs --token-id 6741
```

Or from an inventory URL:

```bash
node scripts/render-gotchi-bypass.mjs \
  --inventory-url "https://www.aavegotchi.com/u/0x.../inventory?itemType=aavegotchis&chainId=8453&id=6741"
```

Artifacts are written to `/tmp` by default:

- `/tmp/gotchi-<id>-render-batch-kickoff.json`
- `/tmp/gotchi-<id>-render-batch.json`
- `/tmp/gotchi-<id>-full.png`
- `/tmp/gotchi-<id>-headshot.png`

Use `--out-dir <path>` to override output location.
Use `--poll-attempts <n>` and `--poll-interval-ms <ms>` to tune polling behavior.

## Notes

- Default target chain is Base (`chainId=8453`).
- Goldsky endpoint and renderer API URLs are embedded in the script.
- For full behavior and troubleshooting, see `SKILL.md`.

```

### _meta.json

```json
{
  "owner": "cinnabarhorse",
  "slug": "aavegotchi-3d-renderer",
  "displayName": "Aavegotchi 3D Renderer",
  "latest": {
    "version": "0.1.2",
    "publishedAt": 1772091881998,
    "commit": "https://github.com/openclaw/skills/commit/3311cb82cd6aa4e60446a984cd99a4245c303c16"
  },
  "history": [
    {
      "version": "0.1.1",
      "publishedAt": 1772000697522,
      "commit": "https://github.com/openclaw/skills/commit/ce7658bbc67396b71767282785b2a184f46fc0c3"
    }
  ]
}

```