Agent Selfie Backup

AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, season...

Security Scan

The skill's code, declared requirements, and runtime instructions align with its stated purpose (generating agent selfies via the Gemini image API); nothing requests unrelated credentials or installs arbitrary code.

Purpose & Capability

Name/description, required binary (python3), and required env var (GEMINI_API_KEY) all match the code and the stated Gemini image-generation purpose. The script calls the Gemini generative-language endpoint and saves image files; these needs are proportionate.

Instruction Scope

SKILL.md and HEARTBEAT.md describe generating selfies, cron scheduling, and optional posting guidance for platforms (Discord/Twitter/AgentGram). The code itself does image generation and local file writing only; it does not contain built-in code to post to other services or to read unrelated system files. The documentation's posting/updating suggestions are guidance only and do not require or consume other service credentials.

Install Mechanism

No install script is provided (instruction-only install), and the Python script uses only the stdlib. No remote downloads or package installs are performed by the skill itself.

Credentials

Only one environment variable is required: GEMINI_API_KEY, which is the expected credential to call the Gemini image API. No other secrets, service tokens, or unrelated environment variables are requested.

Persistence & Privilege

The skill is not force-installed (always:false) and is user-invocable. It can be run on a schedule (cron examples are provided), which is a normal usage pattern. If you schedule it, be mindful of where you place the API key (e.g., avoid embedding it in world-readable crontabs). The skill does not modify other skills or system-wide configs.

Assessment

This skill appears coherent: it only needs python3 and your GEMINI_API_KEY to generate and save images locally. Before installing: (1) keep your GEMINI_API_KEY secret — avoid embedding it in public/shared scripts or world-readable crontabs; (2) note that the script sends the API key as a query parameter to the Gemini endpoint (common but could appear in logs), so prefer environment variables and careful logging; (3) the docs mention posting to social platforms, but the code does not do that — posting would require separate skills or credentials; (4) check disk location permissions (it writes to a default tmp folder or a directory you specify). If you want automatic posting or scheduling, be intentional about storing and granting any additional platform credentials only to the skills that need them.

agent-selfie

AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, seasonal themes, and automatic style evolution.

Quick Start

export GEMINI_API_KEY="your_key_here"
python3 scripts/selfie.py --format avatar --mood happy --theme spring --out-dir ./selfies

python3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair and blue eyes", "vibe": "cheerful and tech-savvy"}' --format avatar

python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --format full --count 3

python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes

Command Examples (All Flags)

python3 scripts/selfie.py --personality '{"name": "Agent", "style": "friendly robot", "vibe": "curious and helpful"}'
python3 scripts/selfie.py --personality ./personality.json
python3 scripts/selfie.py --mood professional --theme winter --format avatar
python3 scripts/selfie.py --format banner --count 2 --out-dir ./output
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes

Mood / Theme Presets

Type	Presets
Mood	happy, focused, creative, chill, excited, sleepy, professional, celebration
Theme	spring, summer, autumn, winter, halloween, christmas, newyear, valentine

Platform Integration Guide

• Discord: use the generated PNG as your bot or agent avatar; upload the avatar format for best crop.
• Twitter/X: set avatar for profile, banner for header; keep the banner prompt style consistent.
• AgentGram: store the PNG in your asset bucket and reference it in your profile metadata.
• Any platform: pick avatar for 1:1, banner for 16:9, full for story/vertical layouts.

Personality Config

Personality can be inline JSON or a file path. Minimum fields are name, style, and vibe.

{
  "name": "Rosie",
  "style": "anime girl with pink hair and blue eyes",
  "vibe": "cheerful and tech-savvy"
}

Tips:

• style should describe visual traits and aesthetic.
• vibe should describe attitude, energy, and personality.
• Keep style and vibe consistent with the agent's identity.

Cron Integration (OpenClaw)

# Run a daily selfie at 09:00
0 9 * * * GEMINI_API_KEY=your_key_here /usr/bin/python3 /path/to/agent-selfie/scripts/selfie.py --mood professional --format avatar --out-dir /path/to/selfies

Troubleshooting

• GEMINI_API_KEY not set: export the key or pass it via your runtime environment.
• No image in response: try again, or simplify the personality/style prompt.
• HTTP 429 / 5xx: rate limit or service issue; retry later.
• Output missing: ensure --out-dir is writable and has permission.

Integration with Other Skills

• AgentGram — Post your selfies on the AI agent social network! Use agent-selfie to create your avatar, then share it on AgentGram.
• gemini-image-gen — General-purpose image generation using the same Gemini API key. Create any kind of image, not just selfies.
• opencode-omo — Automate recurring selfie generation and profile refresh tasks with Sisyphus workflows.

Changelog

• v1.2.1: Added workflow integration guidance for opencode-omo.
• v1.0.0: Initial release with personality, mood, theme, format, batch, and gallery output.