agentsclimarketplace

Avatar logo variant

Skill samzong/samzong/.agents/skills/avatar-logo-variant

Generate identity-preserving 3D cartoon profile-avatar variants with a platform chest badge (GitHub, X, Slack, Telegram, WeChat, OpenAI, company marks, or any new logo). Use when the user asks for a new logo avatar, platform avatar, badge variant, 「做一个 XX logo 头像」, 「新平台头像」, or runs /avatar-logo-variant. Owns image_edit generation + local chroma cutout into logos/avatar-*.png.From its SKILL.md

Install
npx -y skills add samzong/samzong --skill avatar-logo-variant

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 17 stars17 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

5.4 KB, as published. Nobody here has run it

Avatar logo variant

Produce one (or more) 1024×1024 RGBA avatar(s) that keep the same person as the base avatar, with a single platform chest pin, transparent background, and badge size matched to the Telegram reference.

Paths (repo-relative)

ItemPath
Skill root.agents/skills/avatar-logo-variant/
Base identity (do not overwrite).agents/skills/avatar-logo-variant/assets/base-avatar.png
Badge size standard.agents/skills/avatar-logo-variant/assets/size-reference-telegram.png
Prompt templates.agents/skills/avatar-logo-variant/references/prompt-templates.md
Cutout script.agents/skills/avatar-logo-variant/scripts/cutout.py
QA preview script.agents/skills/avatar-logo-variant/scripts/qa_preview.py
Default outputlogos/avatar-<slug>.png
Scratch (chroma / previews).local/imagegen/avatar-logo/

<slug> = lowercase platform id: github, x, slack, telegram, weixin, openai, if, discord, …

When the user says

Examples that must trigger this skill:

  • /avatar-logo-variant discord
  • 「给我做一个 Discord logo 的头像」
  • 「新加一个 LinkedIn 胸章版」
  • 「缩小 OpenAI 徽章到和 Telegram 一样」

If only a name is given, assume: green shirt + earphone cord + official mark chest pin, size = Telegram.

Workflow (do every time)

0. Setup

mkdir -p .local/imagegen/avatar-logo logos

Python for cutout (prefer uv ephemeral deps):

uv run --with numpy --with pillow \
  python .agents/skills/avatar-logo-variant/scripts/cutout.py --help

If uv is unavailable, use the repo-local venv if present: .local/venv-img/bin/python.

1. Generate chroma source (image_edit)

  1. Read prompt templates from references/prompt-templates.md.
  2. Call built-in image_edit (not pure text-to-image without the base):
    • Image 1: assets/base-avatar.png (identity)
    • Image 2: assets/size-reference-telegram.png (badge size only)
    • Optional Image 3: official logo file if the user provided one
  3. Prompt must require:
    • identity lock (face/hair/glasses/pose/materials)
    • one chest pin for the requested brand
    • badge diameter matched to Image 2 (~6–8% width)
    • badge lower-right chest, inside max inscribed circle
    • flat solid #ff00ff background (no shadows on BG)
  4. Save/copy the tool output to: .local/imagegen/avatar-logo/<slug>-chroma.jpg (or .png)

Reject and re-edit if:

  • face drifts from base
  • badge is medallion-sized vs Telegram
  • badge sits on shoulder/neck or would clip under circular crop
  • second badge appears
  • background is not flat key color

2. Size / style fix loops (image_edit only)

  • Too big / too small → “badge size only” template vs Telegram reference
  • Color drift (e.g. OpenAI turned blue) → “fix badge color only” template
  • Missing earphone cord on green-shirt variants → re-add cord from base; do not enlarge badge

3. Cutout to transparent PNG

uv run --with numpy --with pillow \
  python .agents/skills/avatar-logo-variant/scripts/cutout.py \
    --input .local/imagegen/avatar-logo/<slug>-chroma.jpg \
    --out logos/avatar-<slug>.png

Do not hand-roll a new chroma script. All fringe/lens logic lives in cutout.py.

Expect script stdout with pink=0, edge_pink low, corners_a_sum=0. If exit code 1, re-check chroma quality or re-run once with --edge-contract 3.

4. Visual QA (required before claiming done)

uv run --with pillow \
  python .agents/skills/avatar-logo-variant/scripts/qa_preview.py \
    --input logos/avatar-<slug>.png \
    --out-dir .local/imagegen/avatar-logo

Then view with the image tool:

  1. Full avatar on light bg — no pink/red rim on hair/shoulders
  2. Lens crop — no magenta fill, no green blob over nose, eyes/lenses look natural
  3. Mentally circle-crop — badge still fully visible

5. Deliver

  • Report path: logos/avatar-<slug>.png
  • Do not overwrite assets/base-avatar.png
  • Do not delete other logos/avatar-*.png unless user asks
  • Keep intermediate chroma under .local/ (gitignored scratch)

Defaults and product rules

DecisionDefault
Canvas1024×1024
Identityassets/base-avatar.png only
Badge size referenceTelegram asset above
Shirtolive green + brown earphone cord
Company / “if” stylemay use navy shirt and drop cord only if user asks or matches existing avatar-if
Output namelogos/avatar-<slug>.png
Background in generation#ff00ff flat chroma
Transparencyalways via cutout.py

Batch

For multiple platforms: one image_edit per slug (parallel OK), then one cutout.py per chroma file. Do not share one prompt for different logos.

Out of scope

  • Replacing the base identity with a new character (needs explicit new base asset)
  • Vector logo design systems
  • Committing / pushing (needs separate user authorization)

Keep looking

Skills are one crate of 611,178. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.