generate-avatar
GitHub根据自由文本描述生成几何矢量头像的JSON定义。通过读取系统提示词并调用严格验证脚本，确保输出符合Open Bot Avatar引擎的规范，最终返回有效的JSON数据。
Trigger Scenarios
Install
npx skills add DominikScholz/open-bot-avatar --skill generate-avatar -g -y
SKILL.md
Frontmatter
{
"name": "generate-avatar",
"metadata": {
"short-description": "Silhouette + eyes JSON for the avatar engine"
},
"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."
}
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. 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
- Follow references/system-prompt.md with the user's description.
- 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.svgfor a preview file if you can inspect images.--strictalso 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. - 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.
- 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:
ln -s "$PWD/skills/generate-avatar" ~/.claude/skills/generate-avatar
ln -s "$PWD/skills/generate-avatar" ~/.codex/skills/generate-avatar
Version History
- b59a73a Current 2026-11-07 08:52
