New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

OneWorks 3D Avatar Designer

by oneworks-ai in oneworks-ai/avatar

Creates, refines and exports editable OneWorks 3D geometric avatars for mascots, bots or agents, keeping one shared scene state across preview, share link and export.

MITAuto-check passedMedia & Creative

Install OneWorks 3D Avatar Designer

skills CLI
$ npx skills add oneworks-ai/avatar --skill oneworks-avatar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oneworks-ai/avatar oneworks-avatar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oneworks-ai/avatar.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/oneworks-avatar .claude/skills/oneworks-avatar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
oneworks-avatar
GitHub stars
250
Token cost
~1.7k tokens
SKILL.md length
787 words
Files
8 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Creates, refines and exports editable OneWorks 3D geometric avatars for mascots, bots or agents, keeping one shared scene state across preview, share link and export.

  • Works in 7 steps: Parse the request for subject,… → If the user supplies a OneWorks Avatar… → Inspect concise product context when it… → …
  • Designing an original 3D avatar from a reference image or sketch
  • SKILL.md covers Route the task, Core contract, Universal workflow and Current product boundaries, plus 1 more section
  • Reaches oneworks.cloud

What it does

Treats the editor's URL as the actual editable scene state and its rendered SVG as a projection of that state, so a screenshot, hand-drawn approximation, or separate image-generation step is never a substitute for either. Requests are routed by kind: composing already-supported avatar types, expressions and placements reads the editor workflow and preset composition references, while designing an original character from a reference image or sketch additionally reads a reference-modeling guide that translates distinguishing features into actually supported geometry and materials rather than approximating them freely.

Any requested exported file additionally pulls in an export-verification reference, and developer integration work, such as npm, React, Vue, Web Components or iframe embedding, reads a dedicated integration guide first so package and product boundaries stay accurate rather than assumed. Editor implementation bugs read a 3D-debugging reference, pulling in the workflow or export guide too when the bug touches those surfaces.

Three problem spaces are kept distinct: part-local geometry, whole-entity 3D pose, and 2D camera composition, with a fix applied in whichever space the problem actually originates. The entity type, an optional constrained character profile, and a saved complete look are also kept separate, with profiles defining which identity features stay fixed and which may vary while the resolved concrete scene remains the actual source of truth for rendering.

When your agent uses it

  • Designing an original 3D avatar from a reference image or sketch
  • Composing an existing avatar type into a new expression or pose
  • Exporting an avatar as a transparent SVG, PNG or animated GIF
  • Integrating the OneWorks avatar system into a React or JavaScript app

Example prompts

  • “Design a new cat-breed avatar from this reference photo.”
  • “Export this avatar preset as a transparent PNG and an animated GIF.”
  • “Show me how to embed this avatar in a React app using the npm package.”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Parse the request for subject, personality, palette, 3D shape language, target pose, expression, background, frame, motion, identity…
  2. If the user supplies a OneWorks Avatar URL, open and reload it before editing. Preserve every unspecified choice.
  3. Inspect concise product context when it materially helps. Ask one compact round of questions only when a missing choice would change the…
  4. Determine the available browser path before promising operated or exported output. Prefer an already-running local editor when the user is…
  5. Establish the delivery target before detailed composition: editable URL, static or animated asset, opaque or transparent background…
  6. Perform the route-specific workflow and verification.
  7. Reload the final URL and compare the restored scene with the pre-reload view before delivery.

What it can do on your machine

Read from SKILL.md and the folder at commit a06ba84. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • oneworks.cloud

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OneWorks 3D Avatar Designer loads about 1.7k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 159 tokens; SKILL.md has 787 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~159
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oneworks-ai/avatar at commit a06ba84, republished under its MIT licence (© oneworks-ai). 787 words, ~1,666 tokens.

Download SKILL.mdSave it as .claude/skills/oneworks-avatar/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
oneworks-avatar
description
Create, refine, debug, export, and integrate editable OneWorks 3D geometric avatars. Use for avatars, mascots, bot or agent portraits, multipart 3D characters, reference-image model design, cat breeds, character presets, expressive eyes, coat patterns, controlled Seed variation, avatar composition, OneWorks Avatar share URLs, transparent SVG or PNG, animated GIF, developer handoff, React or JavaScript integration, embed questions, @oneworks/avatar integration, or investigation of pose, projection, depth, camera, export, and animation issues. Do not use for photorealistic portraits or arbitrary raster illustration.

OneWorks Avatar

Work with the official OneWorks 3D geometric avatar system. Treat the editor URL as editable scene state and its rendered SVG as the projection of that state; do not replace either with image generation, a screenshot, or a hand-drawn 2D approximation.

Route the task

  • To compose existing avatar types, character profiles, expressions, placement, or animation, read references/editor-workflow.md and references/preset-composition.md. Use this route when available models already support the requested identity, including reference images used only to communicate mood or composition.
  • To design an original editable 3D character from a reference image, sketch, mascot, or new silhouette, read references/editor-workflow.md and references/reference-modeling.md. Translate distinguishing features into actual supported geometry, materials, and model-bound details.
  • For any requested exported file, also read references/export-verification.md.
  • For developer integration, read references/developer-integration.md. Read it before recommending npm, React, Vue, JavaScript, Web Components, iframe, embed, JSON, or runtime APIs so package and product boundaries stay accurate.
  • For editor implementation or debugging, read references/3d-debugging.md. Also read the workflow or export reference when the bug touches those surfaces.
  • For a request spanning routes, read each applicable reference once and keep one shared source of truth for the scene.

Core contract

  • Think in three spaces: part-local geometry, whole-entity 3D pose, and 2D camera composition. Fix a problem in the space where it originates.
  • Keep the same scene state across editor preview, share URL, saved preset, animation, SVG, PNG, and GIF. A result that looks similar but comes from a different state is not equivalent.
  • Separate the entity type, an optional constrained character profile, and saved complete looks. Profiles express which identity features stay fixed and which values may vary; the resolved concrete scene remains the rendering source of truth.
  • Treat Seed as deterministic, field-specific authoring. Preserve the character's species, natural palette, camera frame, and manually fixed choices unless a supported applicable field explicitly follows Seed.
  • Preserve true local X/Y/Z transforms, entity yaw/pitch/roll, projection, rotated-depth ordering, surface-projected face geometry, camera crop, lighting, and effects.
  • Use the real editor and export pipeline. Do not rebuild the avatar from DOM fragments, rendered SVG paths, URL tuple internals, or a prompt-generated image.
  • Treat a complete editor-generated URL as an opaque editable source. Do not promote its private query parameters to a public API or hand-author serialized entityParts or animationData.
  • Correct state in the editor and export again when verification fails. Do not silently repair the downloaded asset with unrelated graphics tooling.
Show full SKILL.md (390 more words)Show less

Universal workflow

  1. Parse the request for subject, personality, palette, 3D shape language, target pose, expression, background, frame, motion, identity features that must remain fixed, allowed variation, integration target, formats, and sizes.
  2. If the user supplies a OneWorks Avatar URL, open and reload it before editing. Preserve every unspecified choice.
  3. Inspect concise product context when it materially helps. Ask one compact round of questions only when a missing choice would change the result; otherwise choose sensible defaults and proceed.
  4. Determine the available browser path before promising operated or exported output. Prefer an already-running local editor when the user is reviewing it; otherwise use https://oneworks.cloud/avatar/. If no interactive browser is available, explain the limitation instead of fabricating results.
  5. Establish the delivery target before detailed composition: editable URL, static or animated asset, opaque or transparent background, frame, size, and developer integration method.
  6. Perform the route-specific workflow and verification.
  7. Reload the final URL and compare the restored scene with the pre-reload view before delivery.

Do not require a fixed three-direction or six-candidate process. Offer alternatives only when the brief is genuinely ambiguous. When the user authorizes direct execution, proceed without repeating already-settled choices.

Current product boundaries

  • @oneworks/avatar is the framework-neutral 3D definition, validation, serialization, animation, and deterministic-seed package. Do not look for or recommend the removed 2D pixel renderer.
  • @oneworks/avatar-react, @oneworks/avatar-vue, and @oneworks/avatar-web render the same 3D scene. Each includes a renderer and the full editor; the web package also offers opt-in custom elements.
  • Applications may carry custom animation libraries in a definition or pass libraries to a renderer/editor. Preserve the versioned definition instead of reverse-engineering editor URL tuples.
  • There is no iframe/embed URL or postMessage controller contract. Use the framework editor component or web mount when an application needs embedded editing.
  • The editor URL is not an image URL or a public definition schema. Store it separately from the versioned definition and exported asset URL.

Delivery

For a creative or export task, report the final share URL and each exported file with format, dimensions, background mode, frame, and animation behavior. For a developer task, state which integration surface is current and which capabilities are unavailable or only proposed. For debugging, report the reproduced state, root cause, changed layer, and focused verification.

Keep the editor or in-app browser open when the user asks to inspect the result.

© oneworks-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in skills/oneworks-avatar of oneworks-ai/avatar.

  • SKILL.md
  • agents/openai.yaml
  • references/3d-debugging.md
  • references/developer-integration.md
  • references/editor-workflow.md
  • references/export-verification.md
  • references/preset-composition.md
  • references/reference-modeling.md

Open the folder on GitHubat commit a06ba84

Compare with similar skills

OneWorks 3D Avatar Designer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OneWorks 3D Avatar Designer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OneWorks 3D Avatar Designer this skilloneworks-ai/avatar250—~1.7kAutomated safety check: PassMIT
Multi Surface Renderyonatangross/orchestkit289—~4kAutomated safety check: PassMIT
Dotlottie WebLottieFiles/dotlottie-web892—~3.5kAutomated safety check: PassMIT
Painted Animationtuzhechen2005/opus-video-skills1271 repos~1.9kAutomated safety check: PassCustom licence
Pixi Vn TestingDRincs-Productions/pixi-vn149—~3.8kAutomated safety check: PassLGPL-2.1
DiscordCraftOS-dev/CraftBot3922 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Multi Surface Render

    yonatangross/orchestkit

    Multi-surface rendering with json-render — one JSON spec produces React web, Next.js, React Native, Ink terminal UIs, PDFs, emails, Remotion videos, OG images, and 3D scenes.

    289 GitHub stars~4k tokensUpdated today
    Media & CreativeAuto-check passed

  • Dotlottie Web

    LottieFiles/dotlottie-web

    Implement Lottie animations using dotLottie runtimes (@lottiefiles/dotlottie-web and @lottiefiles/dotlottie-react).

    892 GitHub stars~3.5k tokensUpdated yesterday
    Media & CreativeAuto-check passed

  • Painted Animation

    tuzhechen2005/opus-video-skills

    Make hand-painted watercolour-and-ink cartoon videos (MP4) with code — p5.js + p5.brush rendered frame by frame in headless Chrome, encoded with ffmpeg — starring Clawd or any character.

    127 GitHub starsUsed in 1 repo~1.9k tokens
    Media & CreativeAuto-check passed

  • Pixi Vn Testing

    DRincs-Productions/pixi-vn

    A skill your agent uses when an AI agent (or any external script) needs to play-test a running Pixi'VN game end-to-end in a real browser — starting the game, advancing/branching the story, answering…

    149 GitHub stars~3.8k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed

  • Discord

    CraftOS-dev/CraftBot

    A skill your agent uses when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search…

    392 GitHub starsUsed in 2 repos~1.8k tokens
    Media & CreativeAuto-check passed

  • Polycss

    layoutit/polycss

    Build PolyCSS scenes that render 3D meshes, primitive shapes, or custom polygons as DOM/CSS polygon elements.

    759 GitHub stars~2.4k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed

Works with

Categories

Questions about OneWorks 3D Avatar Designer

What does OneWorks 3D Avatar Designer do?

Creates, refines and exports editable OneWorks 3D geometric avatars for mascots, bots or agents, keeping one shared scene state across preview, share link and export. Treats the editor's URL as the actual editable scene state and its rendered SVG as a projection of that state, so a screenshot, hand-drawn approximation, or separate image-generation step is never a substitute for either. Requests are routed by kind: composing already-supported avatar types, expressions and placements reads the editor workflow and preset composition references, while designing an original character from a reference image or sketch additionally reads a reference-modeling guide that translates distinguishing features into actually supported geometry and materials rather than approximating them freely.

When should I use OneWorks 3D Avatar Designer?

OneWorks 3D Avatar Designer fits situations like: designing an original 3D avatar from a reference image or sketch; composing an existing avatar type into a new expression or pose; exporting an avatar as a transparent SVG, PNG or animated GIF; integrating the OneWorks avatar system into a React or JavaScript app.

How do I install OneWorks 3D Avatar Designer in Claude Code?

Run `npx skills add oneworks-ai/avatar --skill oneworks-avatar -a claude-code`. Or copy the skill folder (skills/oneworks-avatar in oneworks-ai/avatar) into .claude/skills/oneworks-avatar in your project. Claude Code loads it when a task matches its description.

How do I install OneWorks 3D Avatar Designer in Codex?

Run `npx skills add oneworks-ai/avatar --skill oneworks-avatar -a codex`. Or copy the skill folder (skills/oneworks-avatar in oneworks-ai/avatar) into .agents/skills/oneworks-avatar in your project. Codex loads it when a task matches its description.

Can I use OneWorks 3D Avatar Designer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oneworks-ai/avatar --skill oneworks-avatar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oneworks-avatar, .gemini/skills/oneworks-avatar, .github/skills/oneworks-avatar and .opencode/skills/oneworks-avatar in your project.

What does OneWorks 3D Avatar Designer need to run?

SKILL.md names no scripts, command-line tools or credentials: OneWorks 3D Avatar Designer is instructions for the agent only.

Does OneWorks 3D Avatar Designer access the network?

SKILL.md names 1 domain. In commands or code: oneworks.cloud; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is OneWorks 3D Avatar Designer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OneWorks 3D Avatar Designer use?

OneWorks 3D Avatar Designer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OneWorks 3D Avatar Designer use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to OneWorks 3D Avatar Designer?

Skills that share tags, products or a category with OneWorks 3D Avatar Designer: Multi Surface Render (yonatangross/orchestkit, 289 stars), Dotlottie Web (LottieFiles/dotlottie-web, 892 stars), Painted Animation (tuzhechen2005/opus-video-skills, 127 stars) and Pixi Vn Testing (DRincs-Productions/pixi-vn, 149 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OneWorks 3D Avatar Designer?

oneworks-ai (a GitHub organization) maintains it in oneworks-ai/avatar, which has 250 GitHub stars. The repository was last updated on September 8, 2026.

Source: oneworks-ai/avatar on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.