Skip to main content
skill CX Codex

generate-avatar — Claude Code skill: avatar generation and setup

generate-avatar — a skill for Claude Code turns a free-form idea into geometric avatar JSON. It creates a silhouette path and eye placement for the Open Bot Avatar engine.

MIT ★ 754 updated 2026-11-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a claude-code
Open on GitHub

What generate-avatar does

The skill converts a description of a role, hobby, or object into compact JSON for Open Bot Avatar. The definition contains one SVG silhouette path and eye placement. It is for geometric avatars, not raster images, other icon formats, or styling and animation work.

Its instructions come from references/system-prompt.md. The skill writes a candidate to a temporary file and runs skills/generate-avatar/scripts/validate.sh --strict /tmp/avatar.json; add --svg /tmp/avatar.svg to create a preview file. It fixes reported errors and validates again, stopping after three unsuccessful repair rounds and returning the last errors.

The validator requires a repository checkout. Without one, the definition is checked manually and reported as unvalidated. The final response contains only compact JSON on one line.

What it helps with

  • turn a role description into a geometric avatar
  • encode an SVG silhouette and eye placement as JSON
  • validate avatar geometry and catch reported errors

Example prompts for the agent

  • Create an avatar for a coach who helps with gym sessions.
  • Make a geometric avatar for a gardening assistant.
  • Generate avatar JSON from the idea of a game development buddy.

How to install generate-avatar

1Skills CLI (Vercel)

npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a claude-code

2Manually: put the files in place

~/.claude/skills/generate-avatar/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/generate-avatar/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about generate-avatar

How do I install generate-avatar in Claude Code?

Run npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a claude-code. The skill file is at ~/.claude/skills/generate-avatar/SKILL.md.

What does generate-avatar do?

It turns a free-form description of a role, hobby, or object into compact JSON with an SVG silhouette path and eye placement for the Open Bot Avatar engine.

What is required to validate an avatar with generate-avatar?

The validator needs a repository checkout. Without one, the definition is checked by hand and reported as unvalidated.

Source text

SKILL.md · MIT
---
name: generate-avatar
description: Design a geometry-only vector avatar (one SVG silhouette path plus eye placement, as compact JSON) for the Open Bot Avatar engine from a free-form description naming a hobby, role or object. Not for raster images, icons in other formats, or styling/animation work.
metadata:
  short-description: Silhouette + eyes JSON for the avatar engine
---

# Generate avatar

Turn one free-form description ("a coach for my gym sessions", "gamedev buddy", "something for gardening") into one avatar definition JSON. Any capable model can do this.

The instructions live in one canonical, self-contained prompt shared with the editor's *Generate* copy flow: [references/system-prompt.md](references/system-prompt.md). Read it and follow it exactly; it holds the task, output schema, geometry rules, face-first proportions and reference examples. This file only adds the local validation loop.

## Workflow

1. Follow [references/system-prompt.md](references/system-prompt.md) with the user's description.
2. Write the candidate to a temp file and validate it strictly:
   `skills/generate-avatar/scripts/validate.sh --strict /tmp/avatar.json` (from the repo root; the script also works through a symlinked install). Add `--svg /tmp/avatar.svg` for a preview file if you can inspect images. `--strict` also fails when the face has too little room as the renderer draws it, or when parts meet in a small accidental ledge or notch instead of a clear step or a smooth join.
3. Fix every reported error and re-validate. Fix face-room errors by enlarging the face-bearing part, never by shrinking the eyes. Stop after three failed repair rounds and report the last errors instead of looping.
4. Reply with only the validated compact JSON on one line. The validator's stdout is the normalized form; returning either the candidate or the normalized line is fine.

Without a repo checkout the validator is unavailable; then check the definition by hand against the prompt's rules and say it is unvalidated.

## Install for other sessions

Link rather than copy so the skill stays in sync with the repo:

```bash
ln -s "$PWD/skills/generate-avatar" ~/.claude/skills/generate-avatar
ln -s "$PWD/skills/generate-avatar" ~/.codex/skills/generate-avatar
```

© DominikScholz · MIT · DominikScholz/open-bot-avatar

Similar skills

All skills for Design →

Project sponsors

Companies that keep this analytics open