← Back to Skills Marketplace
149
Downloads
1
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install bmp-avatar-generator
Description
Generate a deterministic pixel-art avatar SVG from a seed string using the @bitmappunks/avatar-generator npm package (version 0.0.5, run via npx), and save i...
README (SKILL.md)
Avatar Generator
Generate a deterministic SVG avatar by running @bitmappunks/[email protected] via npx. Same seed → same avatar.
Version is locked to 0.0.5. Do not upgrade or drop the version pin without explicit user instruction.
Inputs required
- seed — the string that deterministically produces the avatar. Optional: if omitted, default to the current Unix timestamp in seconds so the result changes each time, and report the exact seed used back to the user.
- output path — where the
.svgfile is saved. If the user gave a directory, join it with\x3Cseed>.svg. If no path was given, default to./\x3Cseed>.svgin the current working directory and tell the user what path you used.
Ask only if the output path is ambiguous.
Run
npx -y @bitmappunks/[email protected] --out "\x3Coutput-path>" --seed "\x3Cseed>"
-yauto-accepts the npx install prompt.- The
@0.0.5pin is required — never run it unpinned (@latestor bare). - Resolve
\x3Cseed>to the user-provided seed, otherwise use the current Unix timestamp in seconds.
Preview
Render the generated SVG inline in the terminal using the bundled scripts/svg-tui.js (resolve its path from this skill's base directory, shown in the skill-load message):
node "\x3Cskill-base-dir>/scripts/svg-tui.js" "\x3Coutput-path>"
It parses the avatar's pixel stripes and prints them as ANSI truecolor blocks — works in any terminal transcript that supports 24-bit color, with no external dependency beyond node (already required by npx).
Confirm
Tell the user the absolute output path and the seed. One sentence.
Notes
- Output is SVG only. For PNG or resizing, convert separately (e.g.
rsvg-convert,sharp) — don't silently change format. - One seed per invocation. For multiple seeds, loop the command.
- If
npxerrors (network, registry, install), surface the error — don't retry silently or fall back to a different version.
Usage Guidance
This skill appears to be what it claims: a small, deterministic avatar generator that runs a pinned npm package and a tiny local preview script. Before installing, consider: 1) review the npm package @bitmappunks/[email protected] on the registry (its code and any install scripts) because npx will fetch and run third‑party code; pinning reduces but does not remove supply‑chain risk; 2) decide whether you prefer the SKILL.md behavior (auto‑use timestamp when seed omitted) or the commands file behavior (prompt user) and ensure your agent enforces the desired flow; 3) if you’re concerned about executing remote code, run the skill in a sandboxed environment or audit the package contents first; and 4) be aware npx -y auto‑accepts installation prompts — if you want manual consent, remove -y or run the package after reviewing it.
Capability Analysis
Type: OpenClaw Skill
Name: bmp-avatar-generator
Version: 0.1.2
The skill is a straightforward implementation for generating deterministic SVG avatars using a pinned npm package (@bitmappunks/[email protected]) via npx. The included helper script, scripts/svg-tui.js, is a simple utility that parses SVG paths and renders them as ANSI truecolor blocks in the terminal without any external dependencies or network calls. No evidence of data exfiltration, malicious prompt injection, or unauthorized execution was found; the code and instructions are consistent with the stated purpose.
Capability Assessment
Purpose & Capability
The skill claims to generate deterministic SVG avatars and does exactly that: it runs a pinned npm package via npx and includes a small terminal preview script. Declared runtime requirements (node, npx) match the stated purpose, and there are no unrelated env vars, binaries, or config paths requested.
Instruction Scope
The SKILL.md instructions stay within avatar generation and file output/preview. There is a minor inconsistency: SKILL.md says seed is optional and defaults to the current Unix timestamp, while commands/gen-avatar.md explicitly requires prompting the user if the seed is omitted. Also the preview script reads the generated SVG from a user-supplied path (intended behavior) — be aware the file path comes from the user/agent context.
Install Mechanism
No install spec is bundled; the skill runs @bitmappunks/[email protected] via npx. Version pinning is good for determinism. Running npx will download and execute third‑party package code (including any npm install/postinstall scripts) from the registry; this is expected for an npm-backed skill but is a general supply-chain risk to consider.
Credentials
The skill requests no environment variables, credentials, or config paths. This is proportionate to its stated purpose.
Persistence & Privilege
The skill is not always-enabled and does not request elevated persistence or modify other skills' configs. Autonomous invocation is allowed by default but not combined with any broad privileges here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bmp-avatar-generator - After installation, invoke the skill by name or use
/bmp-avatar-generator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.2
- Added terminal preview functionality: generated SVG avatars can now be rendered inline as ANSI art using the new svg-tui script.
- Introduced scripts/svg-tui.js for terminal-based SVG visualization.
- Added commands/gen-avatar.md for dedicated avatar generation documentation.
- No changes to avatar generation logic; version remains pinned to @bitmappunks/[email protected].
v0.1.1
- The skill name has changed from "avatar-generator" to "bmp-avatar-generator".
- If no seed is provided, the current Unix timestamp in seconds is now used as the default seed (instead of generating a random, unreproducible seed).
- The behavior and user messaging around ambiguous inputs and seed reporting have been clarified.
- Examples and descriptions have been updated for clearer guidance and broader coverage of avatar generation requests.
v0.1.0
Initial release (version 1.0.0):
- Added avatar-generator skill for deterministic pixel-art SVG avatar creation from a seed string using @bitmappunks/[email protected] (via npx).
- Requires explicit seed and output path; defaults to ./<seed>.svg if not specified.
- Always pins package version to 0.0.5 as required.
- Directs user to convert SVG separately if they need other formats.
- Surfaces npx/network/install errors; does not silently retry or downgrade.
- Accepts requests to generate or create avatars using a seed, name, or ID in multiple languages.
Metadata
Frequently Asked Questions
What is avatar-generator?
Generate a deterministic pixel-art avatar SVG from a seed string using the @bitmappunks/avatar-generator npm package (version 0.0.5, run via npx), and save i... It is an AI Agent Skill for Claude Code / OpenClaw, with 149 downloads so far.
How do I install avatar-generator?
Run "/install bmp-avatar-generator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is avatar-generator free?
Yes, avatar-generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does avatar-generator support?
avatar-generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created avatar-generator?
It is built and maintained by tt-u (@tt-u); the current version is v0.1.2.
More Skills