# Avatar Portrait

> This skill should be used when the user asks to "create an avatar from a photo", "generate a portrait avatar", "make a profile image", "convert headshot to styled portrait", "team member avatar", "character-style avatar", or needs likeness-preserving avatars in any style (including pixel art).

- Skill: `b-open-io/avatar-portrait` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add b-open-io/avatar-portrait`
- Raw SKILL.md: https://api.skillmd.com/api/skills/b-open-io/avatar-portrait/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: b-open-io (https://skillmd.com/u/b-open-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/b-open-io/avatar-portrait

---


# 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:
1. **Recognizable likeness** - Must look like the source person
2. **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.png
```

## Context 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

1. **First attempt**: Generate with detailed prompt
2. **Review**: Check both likeness AND style
3. **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