Global Rank · of 601 Skills
avatar-portrait AI Agent Skill
View Source: b-open-io/gemskills
SafeInstallation
npx skills add b-open-io/gemskills --skill avatar-portrait 24
Installs
Avatar Portrait
Generate stylized avatar portraits from reference photos using Gemini image generation, preserving recognizable likeness while applying a requested visual style.
When to Use
Use this skill when the user asks to:
- Create avatars from photos
- Generate team member profile images in a specific style
- Convert headshots to stylized portraits (pixel, retro, illustrated, modern)
- Create consistent character portraits that resemble real people
Core Principles
Balance Likeness and Style
The critical challenge is achieving BOTH:
- Recognizable likeness - Must look like the source person
- Chosen style fidelity - Clear style, not photorealistic unless requested
Common failures:
- Too photorealistic = ignores requested style
- Too stylized = loses resemblance to source person
Single Source Input
Use ONLY the subject's photo as input. Never use another person's image as a style reference - this causes face blending and loss of likeness.
Prompt Template
Generate a styled avatar portrait from the reference photo.
## INPUT IMAGE
[path to subject's photo] - USE ONLY THIS IMAGE
## CRITICAL: LIKENESS PRESERVATION
Capture the subject's EXACT features from the photo:
- Face shape and jawline
- Eye shape, spacing, and expression
- Nose shape and size
- Mouth/smile characteristics
- Hair texture, color, and style
- Facial hair pattern and coverage (if applicable)
The result must be RECOGNIZABLE as this specific person.
## STYLE REQUIREMENTS
- Style: [style requested by user, e.g. pixel art, painterly, anime, low-poly]
- Keep style cues consistent across linework, shading, and color treatment
- Stylized but maintains individual features
- NOT photorealistic unless explicitly requested
## APPEARANCE
- [Describe clothing from photo or as specified]
- [Describe expression]
- [Describe any accessories]
## BACKGROUND
- [Describe background style and colors]
- Background style should match the character style
## TECHNICAL
- NO TEXT on the image
- 512x512 output
- Portrait orientation, head and shoulders
- Square format
## OUTPUT
Save to: [output path]Example: Individual Avatar
For a team member named Dan with a reference photo showing short dark hair, beard, black v-neck:
Generate a styled avatar portrait from the reference photo.
## INPUT IMAGE
/path/to/dan-photo.png - USE ONLY THIS IMAGE
## CRITICAL: LIKENESS PRESERVATION
Capture Dan's EXACT features from the photo:
- His specific face shape and jawline
- His eye shape and expression
- His nose shape
- His smile characteristics
- Short dark hair - exact texture and style from photo
- Full dark beard - exact pattern and coverage
The result must be RECOGNIZABLE as Dan.
## STYLE REQUIREMENTS
- Style: retro 16-bit pixel art
- Visible pixels but NOT a pixelated photo filter
- Clean lines, rich colors, consistent shading
- Stylized but maintains individual features
## APPEARANCE
- Black v-neck shirt
- Warm smile showing teeth
- Friendly, approachable expression
## BACKGROUND
- California sunset cityscape
- Warm oranges, pinks, teals
- Pixel art style matching the character
## TECHNICAL
- NO TEXT on the image
- 512x512 output
- Portrait orientation, head and shoulders
## OUTPUT
Save to: /path/to/output/dan-pixel.pngContext Discipline
Do not read generated avatar images back into context. The script outputs only the file path. Ask the user to visually inspect the result and provide feedback for iteration. To inspect programmatically, optimize the image first (via the optimize-images skill).
Iteration Workflow
- First attempt: Generate with detailed prompt
- Review: Check both likeness AND style
- Adjust if needed:
- If too photorealistic: Emphasize "stylized pixel art character"
- If likeness lost: Strengthen feature descriptions from source
- If wrong features: Be more specific about what to capture
Common Issues
Face doesn't match source
- Ensure ONLY the subject's photo is used as input
- Add more specific feature descriptions
- Reference exact details visible in the photo
Too photorealistic
- Emphasize the style family and key style cues
- Request "stylized" and "illustrated feel"
- Add explicit anti-photorealism language unless photorealism was requested
Too cartoonish / loses likeness
- Strengthen the likeness preservation section
- List specific features to capture
- Emphasize "RECOGNIZABLE as this person"
Reference Files
For background style references:
references/background-styles.md- Common background approaches for avatars
Installs
Security Audit
View Source
b-open-io/gemskills
More from this source
Power your AI Agents with
the best open-source models.
Drop-in OpenAI-compatible API. No data leaves Europe.
Explore Inference APIGLM
GLM 5
$1.00 / $3.20
per M tokens
Kimi
Kimi K2.5
$0.60 / $2.80
per M tokens
MiniMax
MiniMax M2.5
$0.30 / $1.20
per M tokens
Qwen
Qwen3.5 122B
$0.40 / $3.00
per M tokens
How to use this skill
Install avatar-portrait by running npx skills add b-open-io/gemskills --skill avatar-portrait in your project directory. Run the install command above in your project directory. The skill file will be downloaded from GitHub and placed in your project.
No configuration needed. Your AI agent (Claude Code, Cursor, Windsurf, etc.) automatically detects installed skills and uses them as context when generating code.
The skill enhances your agent's understanding of avatar-portrait, helping it follow established patterns, avoid common mistakes, and produce production-ready output.
What you get
Skills are plain-text instruction files — not executable code. They encode expert knowledge about frameworks, languages, or tools that your AI agent reads to improve its output. This means zero runtime overhead, no dependency conflicts, and full transparency: you can read and review every instruction before installing.
Compatibility
This skill works with any AI coding agent that supports the skills.sh format, including Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider, and other tools that read project-level context files. Skills are framework-agnostic at the transport level — the content inside determines which language or framework it applies to.
Chat with 100+ AI Models in one App.
Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.