Skip to content
Conduit

skill

ai-headshot-generator-skill

AI headshot generator agent skill for Claude Code, Codex & OpenClaw: turn a casual selfie into a professional headshot with a new background, business attire, and studio lighting for resumes, company

beatra-ai/ai-headshot-generator-skillcommunitylistedunreviewed
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/beatra-ai/ai-headshot-generator-skill itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 17, 2026

AI Headshot Generator Skill

English | 简体中文

Turn a casual selfie into a professional headshot with a new background, business attire, and studio lighting for resumes, company websites, career profiles, and social media, from inside Claude Code, Cursor, Codex, Windsurf, Cline, or OpenClaw.

[!IMPORTANT] Rendering needs a Beatra account and uses credits. The skill itself is free to install.

QuestionAnswer
What it doesTurn a casual selfie into a studio-quality professional headshot with new backgrounds, professional attire, and studio lighting for LinkedIn, resume, company website, and social media.
ModelsQwen Image 2.0 Fast, Qwen Image 3.0, Qwen Image 3.0 Pro, Wan Image 2.7 Fast, Qwen Image 2.0 Pro, Wan Image 2.7 Pro, GPT Image 2.5 Flare, GPT Image 2.5 Sunburst, GPT Image 2, MiniMax Image 01 Live
RequirementsPython 3.10+ and an agent that loads SKILL.md
CostFree to install. Each render uses credits on your Beatra account, and paid steps run only when you ask for that exact render or approve its card.
Works withClaude Code, Cursor, Codex, Windsurf, Cline, OpenClaw

A casual cafe selfie of a fictional woman (itself AI-generated for this demo) beside a corporate headshot and a startup headshot made from it, with her face and hair kept the same. AI-generated with Beatra.

SkillEntry pointVersion
ai-headshot-studioSKILL.md0.2.2

This repository is published automatically from beatra-ai/beatra-skills. Report issues there.

Install

With the skills CLI:

npx skills add beatra-ai/ai-headshot-generator-skill

With the GitHub CLI:

gh skill install beatra-ai/ai-headshot-generator-skill ai-headshot-studio

Or clone this repository and copy skills/ai-headshot-studio into ~/.claude/skills/ for Claude Code, ~/.cursor/skills/ for Cursor, ~/.agents/skills/ for Codex, ~/.codeium/windsurf/skills/ for Windsurf, ~/.cline/skills/ for Cline, or ~/.openclaw/skills/ for OpenClaw.

Or paste this into your agent:

Install the ai-headshot-studio skill from https://github.com/beatra-ai/ai-headshot-generator-skill (folder skills/ai-headshot-studio), then follow its SKILL.md to connect my Beatra account.

Technical Specifications & Output Limits

As of 2026-10-18. Live list: https://docs.beatra.ai/en/docs/models

  • Uploads — up to 100 MB per file; the per-model input limits below also apply
  • Image to image — 10 models (Qwen Image 2.0 Fast, Qwen Image 3.0, Qwen Image 3.0 Pro, Wan Image 2.7 Fast, Qwen Image 2.0 Pro, Wan Image 2.7 Pro, GPT Image 2.5 Flare, GPT Image 2.5 Sunburst, GPT Image 2, MiniMax Image 01 Live); PNG; up to 4 images per request; canvas up to 16.8 MP
    • 16.8 MP (4K tier): GPT Image 2.5 Flare, GPT Image 2.5 Sunburst, GPT Image 2 (1 image per request)
    • Input images: up to 4 per request, 10–20 MB each; BMP, GIF, JPEG, PNG, TIFF, WEBP
  • Image editing — 6 models (Qwen Image 2.0 Fast, Qwen Image 3.0, Qwen Image 3.0 Pro, Wan Image 2.7 Fast, Qwen Image 2.0 Pro, Wan Image 2.7 Pro); PNG; up to 4 images per request; canvas up to 4.2 MP
    • 4.2 MP (2K tier): Qwen Image 2.0 Fast, Qwen Image 3.0, Qwen Image 3.0 Pro, Wan Image 2.7 Fast, Qwen Image 2.0 Pro, Wan Image 2.7 Pro (up to 4 images per request)
    • Input images: up to 4 per request, 10–20 MB each; BMP, GIF, JPEG, PNG, TIFF, WEBP

Why use Beatra instead of calling model APIs directly

  • One account for every model this skill uses — Image to image 10; Image editing 6 (Qwen Image 2.0 Fast, Qwen Image 3.0, Qwen Image 3.0 Pro, Wan Image 2.7 Fast, Qwen Image 2.0 Pro, Wan Image 2.7 Pro, GPT Image 2.5 Flare, GPT Image 2.5 Sunburst, GPT Image 2, MiniMax Image 01 Live) (as of 2026-10-18), behind one Beatra sign-in; no keys from individual model providers to manage.
  • You decide what gets paid for — Paid renders run only when you ask for that exact render or approve its card, which shows the live credit estimate.
  • Direction before rendering — the skill plans, directs, and reviews the work, then renders it on Beatra.
  • Files you can verify — every file under skills/ matches the release archive on cdn.beatra.ai byte for byte, checked by SHA-256 before each push.
  • Updates you control — no self-updater; update with the tool you installed it with.
  • Runs in your agent — Claude Code, Cursor, Codex, Windsurf, Cline, OpenClaw.

What you get

  • Industry-aware styling — Corporate gets a suit and navy background, tech gets smart casual and modern office, medical gets a white coat and clinical backdrop. The headshot matches the visual language of your profession.
  • Identity-preserving transformation — The person's face shape, skin tone, eye color, and hair remain recognizable while the background, attire, and lighting are upgraded to studio quality.
  • Platform-ready formats — Square 1:1 output with the face centered for LinkedIn circular crops, or portrait format for resume and print—ready to use on every professional surface.

Use cases

  • Corporate and finance headshots — Tailored suit, solid navy or white background, classic studio lighting with a confident neutral expression—perfect for executive profiles and investor decks.
  • Tech and startup portraits — Smart casual attire, modern office or soft gray background, bright natural-feeling lighting with an approachable expression for team pages and pitch materials.
  • Academic and medical headshots — Formal or clinical styling with neutral backgrounds and even soft lighting for faculty directories, research profiles, and healthcare listings.
  • Creative industry portraits — Artistic styling with studio backdrops, directional rim lighting, and individual personality for design portfolios and personal branding.

FAQ

Can I turn a casual selfie into a LinkedIn headshot?

Yes. Upload your selfie, choose the corporate or tech style, and the tool transforms it into a polished professional headshot with a clean background, professional attire, and studio lighting—optimized for the LinkedIn circular crop.

Will the headshot still look like me?

Yes. The transformation preserves your face shape, skin tone, eye color, and hair while upgrading the background, attire, and lighting. The result is a studio-quality headshot that remains recognizably you.

Can I use a specific background or office setting?

Yes. Upload your selfie as the first image and a background reference as the second. The tool places you in that professional environment while preserving your identity.

Can I fix lighting or background on an accepted headshot?

Yes. Upload the accepted headshot, describe the adjustment—brighten lighting, smooth the background, or refine exposure—and the edit targets only that aspect without changing your identity or overall composition.

Updates and security

Since the 2026-10 release, this skill contains no self-updater: it runs only the files you installed and never replaces them on its own. Update it with the tool you installed it with — npx skills update ai-headshot-studio or gh skill update ai-headshot-studio. Details: references/updates-and-security.md inside the skill.

License

MIT-0 — free to use, modify, and redistribute, including commercially. No attribution required. Same terms as these skills carry on ClawHub.

Links

↑↓ navigate openesc close