generate-avatar — скилл для Claude Code: аватары и установка
Скилл generate-avatar для Claude Code создаёт JSON-описание геометрического аватара по текстовой идее. Он формирует контур силуэта и координаты глаз для Open Bot Avatar.
MIT ★ 754 обновлён 2026-11-10
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a claude-codeЧто делает generate-avatar
Скилл превращает описание роли, хобби или предмета в компактный JSON для Open Bot Avatar: один SVG-путь силуэта и положение глаз. Результат рассчитан на геометрический аватар, а не на растровую картинку, иконку другого формата или стилизацию с анимацией.
Инструкция берётся из references/system-prompt.md. Скилл сохраняет вариант во временный файл и запускает строгую проверку через skills/generate-avatar/scripts/validate.sh --strict /tmp/avatar.json; для файла предпросмотра можно добавить --svg /tmp/avatar.svg. Ошибки исправляются с повторной проверкой, но после трёх неудачных циклов скилл останавливается и сообщает последние ошибки.
Для проверки нужен checkout репозитория: без него валидатор недоступен, и определение проверяется вручную с пометкой, что оно не валидировано. В ответе остаётся только компактный JSON в одну строку.
Какие задачи решает
- создать геометрический аватар по описанию роли
- задать силуэт SVG и положение глаз в JSON
- проверить определение аватара на ошибки геометрии
Примеры запросов агенту
- Создай аватар тренера для моих тренировок в зале.
- Сделай геометрический аватар для помощника по садоводству.
- Подготовь JSON аватара по идее «помощник по разработке игр».
Как установить generate-avatar
1Через Skills CLI (Vercel)
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a claude-code2Вручную: положить файлы
~/.claude/skills/generate-avatar/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/generate-avatar/
1Через Skills CLI (Vercel)
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a codex2Вручную: положить файлы
.agents/skills/generate-avatar/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a cursor2Вручную: положить файлы
.cursor/skills/generate-avatar/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install DominikScholz/open-bot-avatar skills/generate-avatar2Вручную: положить файлы
.github/skills/generate-avatar/SKILL.md1Через Skills CLI (Vercel)
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a gemini-cli2Командой платформы
gemini skills install https://github.com/DominikScholz/open-bot-avatar --path skills/generate-avatarВручную: положить файлы
.devin/skills/generate-avatar/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о generate-avatar
Как установить generate-avatar в Claude Code?
Выполни npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -a claude-code. Файл скилла находится по пути ~/.claude/skills/generate-avatar/SKILL.md.
Что делает generate-avatar?
Он преобразует текстовое описание роли, хобби или предмета в компактный JSON с путём силуэта SVG и положением глаз для Open Bot Avatar.
Что нужно для проверки аватара через generate-avatar?
Для запуска валидатора нужен checkout репозитория. Без него определение проверяется вручную и помечается как невалидированное.
Исходный текст
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