agent-avatar-manager

agent-avatar-manager is a skill for Claude Code, Codex from Songhonglei/better-agent-skills. It costs 126 tokens per session (1,652 once invoked), scanned A, original, MIT.

A tool for changing an OpenClaw agent's avatar, the image that represents it. It can use an image or URL supplied by the user, or search Freepik for vector avatar options.

In plain words
What is it for?
Use it to find, preview, and save an avatar in the workspace, then update the agent's identity files.
Why use it?
It gathers the image selection and identity-update steps in one workflow, while explaining that automatic search needs a Freepik API key.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: mentions Claude Code; mentions Codex; built for openclaw.

Good fit Use it to find, preview, and save an avatar in the workspace, then update the agent's identity files.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/songhonglei/better-agent-skills/agent-avatar-manager
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Songhonglei/better-agent-skills --skill agent-avatar-manager
Clone the repo
git clone --depth 1 https://github.com/Songhonglei/better-agent-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for agent-avatar-manager

README.md
[![agentmods](https://agentmods.dev/badge/skills/songhonglei/better-agent-skills/agent-avatar-manager/github.svg)](https://agentmods.dev/skills/songhonglei/better-agent-skills/agent-avatar-manager)
Your own site
<a href="https://agentmods.dev/skills/songhonglei/better-agent-skills/agent-avatar-manager"><img src="https://agentmods.dev/badge/skills/songhonglei/better-agent-skills/agent-avatar-manager/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for agent-avatar-manager

Your own site · 80×15
<a href="https://agentmods.dev/skills/songhonglei/better-agent-skills/agent-avatar-manager"><img src="https://agentmods.dev/badge/skills/songhonglei/better-agent-skills/agent-avatar-manager.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 126 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,652 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00126 $0.01652
Opus 5 $0.00063 $0.00826
Sonnet 5 $0.00025 $0.00330
Haiku 4.5 $0.00013 $0.00165

Measured 11d ago against content hash 7900781a2bc0, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

agent-avatar-manager scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s "https://api.freepik.com/v1/resources?locale=en&page=1&limit=10&order=relevance&term={QUERY}&filters%5Bcontent_type%5D%5Bvector%5D=1&filters%5Blicense%5D%5Bfree%5D=1" \
skills/agent-avatar-manager/SKILL.md · 173 lines

How it starts

The opening of the file, as written. The whole thing — 173 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Avatar Manager

Search vector avatars from Freepik, preview candidates, then replace your OpenClaw Agent's avatar in one flow. Also supports direct image/URL upload when you already have one.

Three ways to provide an image

A. User sends an image or URL (no API Key needed) The user sends an image file or image URL → jump straight to step 5.

B. Freepik API auto search (needs a free API Key) Read the API key from TOOLS.md, field name Freepik API Key. If found, run the search flow starting at step 2.

C. No API Key → guide the user When TOOLS.md has no key and the user did not provide an image, prompt:

Two ways to change the avatar:

  1. Send an image directly: drop an image file or paste an image URL, I'll handle the rest
  2. Auto search: needs a free Freepik API Key

Which do you prefer?

Flow

Step 1 — Read agent info

Read the current agent's IDENTITY.md and extract:

  • Agent name (used for filenames, e.g. Ashley)
  • Agent id (used by openclaw agents set-identity, e.g. main, zhima)
  • Gender / style description (to build the search query)

Agent id inference:

  • Running in main agent → main
  • Running in zhima agent → zhima
  • Ask the user if unsure

Step 2 — Build an English search term

Combine IDENTITY.md info + the user's description, translated to English.

High-quality query templates (use these first):

  • avatar professional woman cartoon
  • businesswoman portrait vector flat
  • female character office flat design
  • avatar young man cartoon portrait
  • male character professional flat

Read the full file on GitHub · 173 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 173 lines · 126 tokens per session scan A 7900781a2bc0

Subscribe to this mod's changes

agent-avatar-manager is a skill published in the GitHub repository Songhonglei/better-agent-skills (3 stars, last pushed 4d ago), licensed MIT. It adds 126 tokens to every session and 1,652 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.