#601

Global Rank · of 601 Skills

avatar-portrait AI Agent Skill

View Source: b-open-io/gemskills

Safe

Installation

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:

  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

Installs

Installs 24
Global Rank #601 of 601

Security Audit

ath Safe
socket Safe
Alerts: 0 Score: 90
snyk Low
EU EU-Hosted Inference API

Power your AI Agents with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

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

1

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.

2

No configuration needed. Your AI agent (Claude Code, Cursor, Windsurf, etc.) automatically detects installed skills and uses them as context when generating code.

3

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.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.

EU Made in Europe

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.

Get the App:

Customer Support