agent-avatar-manager SKILL.md skillA

agent-avatar-manager from songhonglei/better-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add songhonglei/better-agent-skills/agent-avatar-manager@git:20260620.089a390

Pins git:20260620.089a390 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
songhonglei/better-agent-skills
Path
skills/agent-avatar-manager/SKILL.md
Versions recorded
1
Latest version
git:20260620.089a390, committed Jun 20, 2026
Size
5,951 bytes
Repository stars
3
License
MIT

Manage your OpenClaw Agent's avatar. Send an image/URL directly, or describe a style and let Freepik vector search pick candidates for you. Auto-saves to the workspace avatars/ directory and updates IDENTITY.md. 当用户说「换头像」「找一张头像」「更新头像」「给我换个头像」「change avatar」时使用。 Requires a free Freepik API Key for auto-search mode (direct image/URL mode works without it). OpenClaw-only — relies on `openclaw agents set-identity`, `IDENTITY.md`, and `TOOLS.md` conventions.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Agent Avatar Manager

- **Author**: Evan Song · [github.com/Songhonglei](https://github.com/Songhonglei)
- **Repository**: https://github.com/Songhonglei/better-agent-skills
- **License**: MIT
- **Compatibility**: OpenClaw only (uses `openclaw agents set-identity` + `IDENTITY.md`/`TOOLS.md`)

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
>    - Get one at https://www.freepik.com/developers/dashboard/api-key
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add songhonglei/better-agent-skills/agent-avatar-manager@sha256:7900781a2bc0b8cb

The line at the top of this page pins the label git:20260620.089a390, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_akclfq4mz2aeezaq.svg)](https://markdownregistry.com/a/art_akclfq4mz2aeezaq)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jun 20, 2026.

versioncommittedcommitsizeaudit
git:20260620.089a390 latest2026-06-20 089a390 5,951 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5951 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

songhonglei/better-agent-skills · 3 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_akclfq4mz2aeezaq
GET https://markdownregistry.com/api/v1/resolve?ref=songhonglei/better-agent-skills/agent-avatar-manager
GET https://markdownregistry.com/api/v1/blob/7900781a2bc0b8cb7539435dde558de13b3b241f9c9c2360220ae5bbae4cf746

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from songhonglei/better-agent-skills

agent-team-mesh SKILL.md skill
songhonglei/better-agent-skills · skills/agent-team-mesh/SKILL.md · Team-wide P2P mesh for OpenClaw agents running on different containers/pods. Each agent's gateway listens on its own…
git:20260620.8ade89c · audit A · 3 stars
claw-memory-manager SKILL.md skill
songhonglei/better-agent-skills · skills/claw-memory-manager/SKILL.md · Manage OpenClaw Agent's built-in memory features — enable/disable/configure Dreaming (Light→REM→Deep auto memory…
git:20260717.e9363e3 · audit A · 3 stars
codex-thread-repair SKILL.md skill
songhonglei/better-agent-skills · skills/codex-thread-repair/SKILL.md · Diagnose and safely repair one local Codex Desktop task selected by its UI title or thread ID when recent turns are…
git:20260907.152df01 · audit A · 3 stars
collective-memory SKILL.md skill
songhonglei/better-agent-skills · skills/collective-memory/SKILL.md · Broadcast a single memory note to multiple AI-agent workspaces in one shot, upserting into MEMORY.md / AGENTS.md /…
git:20260620.15b2a30 · audit A · 3 stars
copy-my-profile SKILL.md skill
songhonglei/better-agent-skills · skills/copy-my-profile/SKILL.md · Extract a standardized cross-tool user profile from any AI agent's long-term memory (USER.md, MEMORY.md, AGENTS.md…
git:20260620.dd6cf2d · audit A · 3 stars
hello-env SKILL.md skill
songhonglei/better-agent-skills · skills/hello-env/SKILL.md · Zero-dependency Bash environment health check for Linux, macOS, containers, and K8s pods. Reports OS, current user…
git:20261017.7e50876 · audit A · 3 stars
init-hooks SKILL.md skill
songhonglei/better-agent-skills · skills/init-hooks/SKILL.md · 管理 OpenClaw 容器启动时自动执行的脚本钩子。gateway 重启、pod 重启、pod 重建均不丢失(数据持久化在 workspace/.init-hooks/)。 支持 inline…
git:20261017.7e50876 · audit A · 3 stars
multica-squad-load-balancer SKILL.md skill
songhonglei/better-agent-skills · skills/multica-squad-load-balancer/SKILL.md · Multica 小队公共负载均衡。小队 Issue 由队长按实时活跃任务数、运行环境、并发容量和所需技能委派一名成员;成员校验委派链后执行原业务。用于小队派单、成员接单、重复唤醒对账和负载预览,适用于任意项目。
git:20261019.750dc9a · audit A · 3 stars
multica-squad-onboard SKILL.md skill
songhonglei/better-agent-skills · skills/multica-squad-onboard/SKILL.md · 根据 Multica 项目 ID 或 URL 检查现有小队前提,安装公共负载均衡 Skill,配置项目、小队及不同角色的项目作用域 Instruction,并只读验收。当用户要求小队首次接入、配置复查或补装时使用;实际业务派单使用…
git:20261019.750dc9a · audit A · 3 stars
openviking-projects SKILL.md skill
songhonglei/better-agent-skills · skills/openviking-projects/SKILL.md · 在新电脑安装或接入 OpenViking,用白名单管理本地项目知识;支持 GitHub 不通时的镜像安装、模型权限检查、只读 MCP、多项目路由与增量同步。用于 OpenViking 项目知识接入和运维;聊天记忆插件另行选择。
git:20261107.e9b5934 · audit A · 3 stars
recover-codex-project-chats SKILL.md skill
songhonglei/better-agent-skills · skills/recover-codex-project-chats/SKILL.md · Diagnose and safely repair Codex Desktop projects that exist but show “No chats/没有聊天”, while conversations may still…
git:20260806.6eddb52 · audit A · 3 stars
rename-session SKILL.md skill
songhonglei/better-agent-skills · skills/rename-session/SKILL.md · Rename or auto-generate a friendly label for an OpenClaw-style session by editing sessions.json directly. Supports…
git:20260620.e97d509 · audit A · 3 stars

Every file in songhonglei/better-agent-skills

Browse by kind, by grade A, or by owner.