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
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/generate-avatar/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/generate-avatar/
1Skills CLI (Vercel)
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a codex2Manually: put the files in place
.agents/skills/generate-avatar/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a cursor2Manually: put the files in place
.cursor/skills/generate-avatar/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install DominikScholz/open-bot-avatar skills/generate-avatar2Manually: put the files in place
.github/skills/generate-avatar/SKILL.md1Skills CLI (Vercel)
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a gemini-cli2Platform CLI
gemini skills install https://github.com/DominikScholz/open-bot-avatar --path skills/generate-avatarManually: put the files in place
.devin/skills/generate-avatar/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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